Data Flow

flowchart TD
  User["User clicks desktop folder, command item, shell action, or drawer entry"]
  Registry["appRegistry finds ShellAppManifest"]
  Store["useShellStore.openApp(appId, workspaceBounds)"]
  Instance["WindowInstance created or existing app window focused"]
  Layer["WindowLayer renders AppWindow"]
  Runtime["AppRuntime maps appId to local component"]
  App["Local Module App renders"]
  Data["Static mock data or local component arrays"]
  UI["Window UI updates"]

  User --> Registry
  Registry --> Store
  Store --> Instance
  Instance --> Layer
  Layer --> Runtime
  Runtime --> App
  App --> Data
  Data --> UI

flowchart TD
  BrowserUrl["Browser URL /app, /app-user, /app-dev, /app-iframe, /app-os"]
  Router["TanStack Router"]
  Parse["parseShellRoute"]
  Registry["getAppManifest"]
  Mode["ViewMode: os or website"]
  Open["openAppWithRecent"]
  Render["WindowLayer or WebsiteAppHost"]

  BrowserUrl --> Router
  Router --> Parse
  Parse --> Registry
  Registry --> Mode
  Mode --> Open
  Open --> Render

flowchart LR
  App["Local Module App"]
  Query["TanStack Query"]
  Client["openapi-fetch client"]
  Worker["Hono API Worker"]
  Schema["Zod/OpenAPI contracts"]
  Data["DB / storage / external services"]
  Explorer["Scalar API Explorer OS app"]

  App --> Query
  Query --> Client
  Client --> Worker
  Worker --> Schema
  Worker --> Data
  Schema --> Explorer