You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,22 @@
1
1
# Flitro
2
2
3
-
Flitro is a macOS productivity app that lets you quickly switch between different work contexts (sets of apps, documents, browser tabs, and terminal sessions) with a single click. It features a modern SwiftUI interface, a menu bar icon for quick access, and robust single-window management.
3
+
Flitro is a powerful macOS productivity app designed to help you seamlessly switch between different work contexts with a single click. Effortlessly manage sets of apps, documents, browser tabs, and terminal sessions, so you can focus on what matters most—your work.
4
4
5
-
## Features
5
+

6
6
7
-
-**Context Management:** Create, edit, and delete named contexts, each containing apps, documents, browser tabs, and terminal sessions.
8
-
-**One-Click Switching:** Instantly switch your workspace to a saved context, with support for multiple switching modes (Replace All, Additive, Hybrid).
9
-
-**Menu Bar Integration:** Access all your contexts and switch modes directly from the macOS menu bar.
10
-
-**Single Window:** The main window is always reused and never duplicated. Closing the window hides it; you can reopen it from the menu bar or via keyboard shortcut.
11
-
-**Modern UI:** Built with SwiftUI and AppKit for the best of both worlds. Supports unified toolbar and sidebar.
7
+
## Key Features
8
+
9
+
-**Instant Context Switching:** Instantly switch your workspace to a saved context, opening and closing the right apps, documents, browser tabs, and terminals for your task.
10
+
-**Flexible Switching Modes:** Choose between Replace All, Additive, or Hybrid modes to tailor how your workspace changes.
11
+
-**Easy Context Management:** Create, edit, and delete named contexts to match your workflows.
12
+
-**Menu Bar Access:** Quickly access and switch contexts from the macOS menu bar, without interrupting your flow.
13
+
-**Unified Window Experience:** The main window is always available from the menu bar or via keyboard shortcut, never duplicated, and hides when closed for a clutter-free desktop.
14
+
-**Modern macOS Design:** Enjoy a beautiful, intuitive interface built with SwiftUI and AppKit, supporting unified toolbars and sidebars.
12
15
13
16
## Requirements
14
17
15
18
- macOS 15 or later
16
-
- Xcode 15 or later
19
+
- Xcode 15 or later (for development)
17
20
- Swift 5.9+
18
21
19
22
## Installation
@@ -26,23 +29,20 @@ Flitro is a macOS productivity app that lets you quickly switch between differen
26
29
2. Open `Flitro.xcodeproj` in Xcode.
27
30
3. Build and run the app (⌘R).
28
31
29
-
## Usage
32
+
## Getting Started
30
33
31
-
-**Configure Contexts:** Open the main window ("Configure" from the menu bar or ⌘0) to add, edit, or remove contexts.
32
-
-**Switch Contexts:** Use the menu bar icon to select a context and a switching mode. The app will open/close apps, documents, browser tabs, and terminals as defined.
33
-
-**Hide/Show Main Window:** Closing the main window hides it. Use the menu bar "Configure" item or ⌘0 to bring it back.
34
+
-**Configure Contexts:** Open the main window ("Configure" from the menu bar) to add, edit, or remove your custom contexts.
35
+
-**Switch Contexts:** Use the menu bar icon to select a context and switching mode. Flitro will automatically set up your workspace as defined.
36
+
-**Hide/Show Main Window:** Closing the main window hides it. Use the menu bar "Configure" item to bring it back.
34
37
-**Quit:** Use the menu bar or standard macOS quit command (⌘Q).
35
38
36
-
## Development Notes
39
+
## Support & Feedback
37
40
38
-
- The app uses a hybrid SwiftUI + AppKit approach for robust window management and modern UI.
39
-
- The main window is managed by SwiftUI's `WindowGroup` for toolbar/sidebar support, but close events are intercepted in the AppDelegate to hide instead of close.
40
-
- The menu bar uses `MenuBarExtra` and observes the shared `ContextManager` for live updates.
41
-
- All state is managed via a singleton `ContextManager` injected as an `@EnvironmentObject`.
41
+
Have questions, suggestions, or need help? [Open an issue](https://github.com/l2fprod/Flitro/issues) or start a discussion on GitHub.
42
42
43
43
## Contributing
44
44
45
-
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
45
+
Pull requests are welcome! For major changes, please open an issue first to discuss your ideas.
0 commit comments