How nathanblatter/flightdeck works
Flightdeck is a cross-project context service for people and agents: organize projects and work items, retrieve context, then record activity and context outcomes. The web UI and documented HTTP/MCP interfaces support that workflow; additional capabilities include search, analytics, bug intake, and encrypted project sharing between instances. The README documents product-level behavior, but most backend implementations were not excerpted, so internal backend links are omitted or marked unverified rather than inferred from filenames.
Main entry points: App.tsx Workspace shell · api HTTP API · api.ts Typed API client · ProjectDrawer.tsx Project context
Components 28
Web workspace
- Workspace shell
web/src/App.tsx - Kanban board
web/src/components/Board.tsx - Quick add
web/src/components/QuickAdd.tsx - Project creation
web/src/components/NewProject.tsx - Project context
web/src/components/ProjectDrawer.tsx - Activity feed
web/src/components/ActivityFeed.tsx - Item links
web/src/components/ItemLinks.tsx - Sharing controls
web/src/components/Sharing.tsx - First-run setup
web/src/components/SetupWizard.tsx - Typed API client
web/src/api.ts
Context service
- HTTP API
internal/api - API-key auth
internal/auth/auth.go - Domain services
internal/service - Context retrieval
internal/api/context.go - Cascading search
internal/store/items_search.sql.go - Context impact
internal/service/context_impact.go - Webhook delivery
internal/service/webhooks.go - PostgreSQL
internal/store
Federated sharing
- Share sync engine
internal/sync/engine.go - Mailbox server
cmd/flightdeck-mailbox/main.go - Mailbox client
internal/mailbox/mailbox.go
Agent and intake interfaces
- MCP interface
internal/mcp/server.go - Bug widget
bug-widget.js - Bug intake
internal/api/ingest.go
Other components
- Human user
- Agent client
- Public website
- Peer instance
Connections 35
- Human user → Workspace shell: uses
- Workspace shell → Kanban board: renders
web/src/App.tsx - Workspace shell → Activity feed: renders
web/src/App.tsx - Workspace shell → Project context: renders
web/src/App.tsx - Workspace shell → Quick add: renders
web/src/App.tsx - Workspace shell → Project creation: renders
web/src/App.tsx - Workspace shell → Item links: renders
web/src/App.tsx - Workspace shell → Sharing controls: renders
web/src/App.tsx - Workspace shell → First-run setup: renders
web/src/App.tsx - Kanban board → Typed API client: updates items
web/src/components/Board.tsx - Quick add → Typed API client: creates items
web/src/components/QuickAdd.tsx - Project creation → Typed API client: creates projects
web/src/components/NewProject.tsx - Project context → Typed API client: loads context
web/src/components/ProjectDrawer.tsx - Project context → Sharing controls: renders
web/src/components/ProjectDrawer.tsx - Activity feed → Typed API client: loads activity
web/src/components/ActivityFeed.tsx - Item links → Typed API client: manages links
web/src/components/ItemLinks.tsx - Sharing controls → Typed API client: manages shares
web/src/components/Sharing.tsx - First-run setup → Typed API client: checks setup
web/src/components/SetupWizard.tsx - Typed API client → HTTP API: sends requests
- Agent client → HTTP API: uses REST API
- HTTP API → API-key auth: checks keys
- HTTP API → Domain services: dispatches
- Domain services → PostgreSQL: reads and writes
- HTTP API → Context retrieval: serves context
- HTTP API → Cascading search: serves search
- HTTP API → Context impact: records impacts
- HTTP API → Webhook delivery: manages hooks
- Agent client → MCP interface: uses tools
- MCP interface → Domain services: dispatches tools
- Public website → Bug widget: hosts
- Bug widget → Bug intake: submits reports
- Peer instance → Mailbox server: exchanges messages
- Share sync engine → Mailbox client: uses client
- Mailbox client → Mailbox server: exchanges encrypted data
- HTTP API → Share sync engine: coordinates shares