Launcher App
Getting Started
Getting Started with Launcher
The Launcher App is the central navigation hub for FlowState, providing quick access to all registered applications in the ecosystem.
Prerequisites
Before using the Launcher App, ensure you have:
- FlowState installed and running (either Next.js web or Electron desktop)
- An active organization and workspace configured
- Network connectivity for server features (optional for local-only mode)
Accessing the App
The Launcher is the default home screen for FlowState. You can access it in several ways:
- Automatic: Opens when you launch FlowState
- Keyboard Shortcut: Press
Cmd+Shift+H(macOS) orCtrl+Shift+H(Windows/Linux) from any app - Direct URL: Navigate to
/(root route)
Initial Setup
Step 1: Review Your Organization Context
When you first open the Launcher, check the status bar at the top of the screen:
- Mode: Shows whether you're in local or remote mode
- Servers: Displays the number of connected servers
- Organization: Shows your current organization name
Step 2: Select Organization and Workspace
If you belong to multiple organizations or workspaces:
- Locate the Organization/Workspace Selector below the status bar
- Click to open the dropdown menu
- Select your desired organization
- Choose the appropriate workspace
Your selection persists across sessions.
Step 3: Explore Available Apps
The main area displays a grid of application cards:
- Each card shows the app's icon with a branded color
- The app name is displayed prominently
- A brief description explains the app's purpose
- Click any card to navigate directly to that application
Understanding App Categories
Apps in the Launcher are organized into categories:
| Category | Description | Examples |
|---|---|---|
| Core | Essential system applications | Launcher, Shell |
| Technical | Development and infrastructure tools | Servers, Agents |
| Business | Business process applications | Projects, Product, Process |
Keyboard Navigation
The Launcher supports keyboard shortcuts for efficient navigation:
| Action | Windows/Linux | macOS |
|---|---|---|
| Show All Apps | Ctrl+Shift+A | Cmd+Shift+A |
| Go to Home (Launcher) | Ctrl+Shift+H | Cmd+Shift+H |
| Go Back | Alt+Left | Cmd+[ |
| Go Forward | Alt+Right | Cmd+] |
Next Steps
Once you've completed the initial setup:
- Explore Features to learn about all Launcher capabilities
- Check out Launching an App for the step-by-step workflow
- Review FAQ for answers to common questions
- See Troubleshooting if you encounter any issues