How joblinours/fleight-board works
Fleight Board is a self-hosted collaborative whiteboard. Users sign in or join as guests, manage boards and access, then edit diagrams and drawings in a canvas; the API handles board and account operations while collaboration synchronizes edits. The graph includes the documented audit, permissions, presence/locking, and tablet-oriented drawing capabilities. Some UI-to-runtime and realtime wiring is unsampled, so those relationships are omitted or marked unverified rather than inferred as confirmed calls.
Main entry points: App.tsx Web app routing · editor.ts Canvas editor · app.ts API application · database.ts Database connection
Components 30
Web experience
- Web app routing
apps/web/src/App.tsx - Authentication UI
apps/web/src/auth/AuthPages.tsx - Session state
apps/web/src/auth/session.ts - Board workspace
apps/web/src/board/BoardPage.tsx - Board management
apps/web/src/boards/BoardsSection.tsx - Admin and audit
apps/web/src/admin/AdminPage.tsx - Audit viewer
apps/web/src/audit/AuditPage.tsx
Canvas and document
- Canvas editor
packages/canvas/src/board/editor.ts - Pointer input
packages/canvas/src/input/input-router.ts - Canvas renderer
packages/canvas/src/renderer.ts - Selection tools
packages/canvas/src/board/selection.ts - Board document
packages/document/src/document.ts - Undo history
packages/document/src/undo-history.ts
Realtime collaboration
- Shared protocol
packages/protocol/src/session.ts - Collaboration client
packages/collaboration/src/client.ts - Collaboration hub
packages/collaboration/src/hub.ts - Board rooms
packages/collaboration/src/board-room.ts - Object locks
packages/collaboration/src/locks.ts
API and domain
- API application
apps/api/src/app.ts - Auth routes
apps/api/src/auth/routes.ts - Auth service
apps/api/src/auth/auth-service.ts - Board routes
apps/api/src/boards/routes.ts - Board service
apps/api/src/boards/board-service.ts - Permission rules
packages/permissions/src/index.ts
Persistence
- Database connection
apps/api/src/database.ts - Database schema
apps/api/src/db/schema.ts - Audit log store
apps/api/src/db/audit-log.ts - Board store
apps/api/src/db/board-store.ts
Other components
- User / guest
- PostgreSQL
Connections 37
- User / guest → Web app routing: opens
- Web app routing → Authentication UI: routes to
apps/web/src/App.tsx - Web app routing → Board workspace: routes to
apps/web/src/App.tsx - Web app routing → Admin and audit: routes to
apps/web/src/App.tsx - Web app routing → Audit viewer: routes to
apps/web/src/App.tsx - Web app routing → Session state: refreshes
apps/web/src/App.tsx - Authentication UI → Session state: updates
apps/web/src/auth/AuthPages.tsx - Session state → API application: requests session
- Board workspace → Canvas editor: hosts editor
- Board workspace → Collaboration hub: collaborates via
- Board workspace → Board management: manages boards
- Canvas editor → Pointer input: uses input
packages/canvas/src/board/editor.ts - Canvas editor → Canvas renderer: uses renderer
packages/canvas/src/board/editor.ts - Canvas editor → Selection tools: uses selection
packages/canvas/src/board/editor.ts - Canvas editor → Board document: edits
packages/canvas/src/board/editor.ts - Pointer input → Canvas editor: dispatches gestures
packages/canvas/src/board/editor.ts - Undo history → Board document: tracks edits
packages/document/src/undo-history.ts - Collaboration client → Board document: applies operations
packages/collaboration/src/client.ts - Collaboration client → Shared protocol: uses messages
packages/collaboration/src/client.ts - Collaboration hub → Board rooms: routes board traffic
packages/collaboration/src/hub.ts - Collaboration hub → Object locks: manages locks
packages/collaboration/src/hub.ts - API application → Auth routes: registers
apps/api/src/app.ts - API application → Board routes: registers
apps/api/src/app.ts - API application → Collaboration hub: registers websocket
apps/api/src/app.ts - Auth routes → Auth service: calls
apps/api/src/auth/routes.ts - Board routes → Board service: calls
apps/api/src/boards/routes.ts - Board service → Permission rules: checks access
apps/api/src/boards/board-service.ts - Auth service → Database connection: queries
apps/api/src/auth/auth-service.ts - Board service → Database connection: queries
apps/api/src/boards/board-service.ts - Board service → Audit log store: records events
apps/api/src/boards/board-service.ts - Auth service → Audit log store: records events
- Audit viewer → API application: requests audit
- Admin and audit → API application: requests administration
- Database connection → Database schema: uses schema
apps/api/src/database.ts - Database connection → PostgreSQL: connects
apps/api/src/database.ts - Audit log store → Database connection: queries
apps/api/src/db/audit-log.ts - Board store → Database connection: stores board data