Launcher App

The Launcher App is the central navigation hub for FlowState. It provides a dashboard-style interface for discovering and launching all registered applications within the FlowState ecosystem. The launcher automatically detects apps from their manifests and displays them in an organized grid layout.

Key Features

Application Grid: Visual grid of all registered FlowState apps
Dynamic App Discovery: Automatically loads apps from registered manifests
Organization Context: Displays current organization and allows switching
Server Status: Shows connection mode and active server count
Keyboard Navigation: Global shortcuts for quick app access
Cross-Platform: Works in Electron, Web (Next.js), and React Native

Target Users

User Type	Primary Use Cases
All Users	Navigate between FlowState applications
Administrators	Monitor server connections and organization context
New Users	Discover available applications

Quick Links

Features & Capabilities - Detailed feature documentation

Getting Started

The launcher serves as the home screen for FlowState:

Route (/) - Main launcher dashboard
Keyboard: Cmd/Ctrl+Shift+H returns to launcher from any app

Launching Apps

Open the launcher (home route or Cmd/Ctrl+Shift+H)
View the status bar for current mode, servers, and organization
Select organization/workspace if needed
Click any app card to navigate to that application

App Cards

Each app displays:

Colored icon representing the app
App name
Brief description
Click to navigate

App Identity

Property	Value
Package	`@epicdm/flowstate-app-launcher`
Base Path	`/`
Icon	rocket
Color	#A855F7
Category	core

@epicdm/flowstate-app-framework - App container framework with context providers
@epicdm/flowstate-ui - Shared UI components