# joblinours/fleight-board architecture

> Architecture diagram of the GitHub repository joblinours/fleight-board, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joblinours/fleight-board
- Repository: https://github.com/joblinours/fleight-board

## Overview

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: [`apps/web/src/App.tsx`](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/App.tsx) (Web app routing), [`packages/canvas/src/board/editor.ts`](https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/board/editor.ts) (Canvas editor), [`apps/api/src/app.ts`](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/app.ts) (API application), [`apps/api/src/database.ts`](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/database.ts) (Database connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Web app routing<br/>[App.tsx]"]
  node_authui["Authentication UI<br/>[AuthPages.tsx]"]
  node_session["Session state<br/>[session.ts]"]
  node_boardui["Board workspace<br/>[BoardPage.tsx]"]
  node_boardlist["Board management<br/>[BoardsSection.tsx]"]
  node_adminui["Admin and audit<br/>[AdminPage.tsx]"]
  node_auditui["Audit viewer<br/>[AuditPage.tsx]"]
end

subgraph group_canvas["Canvas and document"]
  node_canvaseditor["Canvas editor<br/>[editor.ts]"]
  node_input["Pointer input<br/>[input-router.ts]"]
  node_renderer["Canvas renderer<br/>[renderer.ts]"]
  node_selection["Selection tools<br/>[selection.ts]"]
  node_document["Board document<br/>[document.ts]"]
  node_undo["Undo history<br/>[undo-history.ts]"]
end

subgraph group_realtime["Realtime collaboration"]
  node_protocol["Shared protocol<br/>[session.ts]"]
  node_collabclient["Collaboration client<br/>[client.ts]"]
  node_hub["Collaboration hub<br/>[hub.ts]"]
  node_rooms["Board rooms<br/>[board-room.ts]"]
  node_locks["Object locks<br/>[locks.ts]"]
end

subgraph group_api["API and domain"]
  node_api["API application<br/>[app.ts]"]
  node_authroutes["Auth routes<br/>[routes.ts]"]
  node_authservice["Auth service<br/>[auth-service.ts]"]
  node_boardroutes["Board routes<br/>[routes.ts]"]
  node_boardservice["Board service<br/>[board-service.ts]"]
  node_permissions["Permission rules<br/>[index.ts]"]
end

subgraph group_storage["Persistence"]
  node_database["Database connection<br/>[database.ts]"]
  node_schema["Database schema<br/>[schema.ts]"]
  node_auditstore[("Audit log store<br/>[audit-log.ts]")]
  node_boardstore[("Board store<br/>[board-store.ts]")]
end

node_user(("User / guest"))
node_postgres[("PostgreSQL")]

node_user -->|"opens"| node_webapp
node_webapp -->|"routes to"| node_authui
node_webapp -->|"routes to"| node_boardui
node_webapp -->|"routes to"| node_adminui
node_webapp -->|"routes to"| node_auditui
node_webapp -->|"refreshes"| node_session
node_authui -->|"updates"| node_session
node_session -.->|"requests session"| node_api
node_boardui -.->|"hosts editor"| node_canvaseditor
node_boardui -.->|"collaborates via"| node_hub
node_boardui -.->|"manages boards"| node_boardlist
node_canvaseditor -->|"uses input"| node_input
node_canvaseditor -->|"uses renderer"| node_renderer
node_canvaseditor -->|"uses selection"| node_selection
node_canvaseditor -->|"edits"| node_document
node_input -.->|"dispatches gestures"| node_canvaseditor
node_undo -->|"tracks edits"| node_document
node_collabclient -->|"applies operations"| node_document
node_collabclient -->|"uses messages"| node_protocol
node_hub -->|"routes board traffic"| node_rooms
node_hub -->|"manages locks"| node_locks
node_api -->|"registers"| node_authroutes
node_api -->|"registers"| node_boardroutes
node_api -->|"registers websocket"| node_hub
node_authroutes -->|"calls"| node_authservice
node_boardroutes -->|"calls"| node_boardservice
node_boardservice -->|"checks access"| node_permissions
node_authservice -->|"queries"| node_database
node_boardservice -->|"queries"| node_database
node_boardservice -->|"records events"| node_auditstore
node_authservice -.->|"records events"| node_auditstore
node_auditui -.->|"requests audit"| node_api
node_adminui -.->|"requests administration"| node_api
node_database -->|"uses schema"| node_schema
node_database -->|"connects"| node_postgres
node_auditstore -->|"queries"| node_database
node_boardstore -.->|"stores board data"| node_database

click node_webapp "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/App.tsx"
click node_authui "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/auth/AuthPages.tsx"
click node_session "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/auth/session.ts"
click node_boardui "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/board/BoardPage.tsx"
click node_boardlist "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/boards/BoardsSection.tsx"
click node_adminui "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/admin/AdminPage.tsx"
click node_canvaseditor "https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/board/editor.ts"
click node_input "https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/input/input-router.ts"
click node_renderer "https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/renderer.ts"
click node_selection "https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/board/selection.ts"
click node_document "https://github.com/joblinours/fleight-board/blob/main/packages/document/src/document.ts"
click node_undo "https://github.com/joblinours/fleight-board/blob/main/packages/document/src/undo-history.ts"
click node_protocol "https://github.com/joblinours/fleight-board/blob/main/packages/protocol/src/session.ts"
click node_collabclient "https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/client.ts"
click node_hub "https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/hub.ts"
click node_rooms "https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/board-room.ts"
click node_locks "https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/locks.ts"
click node_api "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/app.ts"
click node_authroutes "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/auth/routes.ts"
click node_authservice "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/auth/auth-service.ts"
click node_boardroutes "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/boards/routes.ts"
click node_boardservice "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/boards/board-service.ts"
click node_permissions "https://github.com/joblinours/fleight-board/blob/main/packages/permissions/src/index.ts"
click node_auditui "https://github.com/joblinours/fleight-board/blob/main/apps/web/src/audit/AuditPage.tsx"
click node_database "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/database.ts"
click node_schema "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/db/schema.ts"
click node_auditstore "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/db/audit-log.ts"
click node_boardstore "https://github.com/joblinours/fleight-board/blob/main/apps/api/src/db/board-store.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_authui,node_session,node_boardui,node_boardlist,node_adminui,node_auditui,node_user toneBlue
class node_canvaseditor,node_input,node_renderer,node_selection,node_document,node_undo,node_postgres toneAmber
class node_protocol,node_collabclient,node_hub,node_rooms,node_locks toneMint
class node_api,node_authroutes,node_authservice,node_boardroutes,node_boardservice,node_permissions toneRose
class node_database,node_schema,node_auditstore,node_boardstore toneIndigo
```

## Components

### Web experience

- [Web app routing](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Authentication UI](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/auth/AuthPages.tsx): `apps/web/src/auth/AuthPages.tsx`
- [Session state](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/auth/session.ts): `apps/web/src/auth/session.ts`
- [Board workspace](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/board/BoardPage.tsx): `apps/web/src/board/BoardPage.tsx`
- [Board management](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/boards/BoardsSection.tsx): `apps/web/src/boards/BoardsSection.tsx`
- [Admin and audit](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/admin/AdminPage.tsx): `apps/web/src/admin/AdminPage.tsx`
- [Audit viewer](https://github.com/joblinours/fleight-board/blob/main/apps/web/src/audit/AuditPage.tsx): `apps/web/src/audit/AuditPage.tsx`

### Canvas and document

- [Canvas editor](https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/board/editor.ts): `packages/canvas/src/board/editor.ts`
- [Pointer input](https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/input/input-router.ts): `packages/canvas/src/input/input-router.ts`
- [Canvas renderer](https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/renderer.ts): `packages/canvas/src/renderer.ts`
- [Selection tools](https://github.com/joblinours/fleight-board/blob/main/packages/canvas/src/board/selection.ts): `packages/canvas/src/board/selection.ts`
- [Board document](https://github.com/joblinours/fleight-board/blob/main/packages/document/src/document.ts): `packages/document/src/document.ts`
- [Undo history](https://github.com/joblinours/fleight-board/blob/main/packages/document/src/undo-history.ts): `packages/document/src/undo-history.ts`

### Realtime collaboration

- [Shared protocol](https://github.com/joblinours/fleight-board/blob/main/packages/protocol/src/session.ts): `packages/protocol/src/session.ts`
- [Collaboration client](https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/client.ts): `packages/collaboration/src/client.ts`
- [Collaboration hub](https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/hub.ts): `packages/collaboration/src/hub.ts`
- [Board rooms](https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/board-room.ts): `packages/collaboration/src/board-room.ts`
- [Object locks](https://github.com/joblinours/fleight-board/blob/main/packages/collaboration/src/locks.ts): `packages/collaboration/src/locks.ts`

### API and domain

- [API application](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Auth routes](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/auth/routes.ts): `apps/api/src/auth/routes.ts`
- [Auth service](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/auth/auth-service.ts): `apps/api/src/auth/auth-service.ts`
- [Board routes](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/boards/routes.ts): `apps/api/src/boards/routes.ts`
- [Board service](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/boards/board-service.ts): `apps/api/src/boards/board-service.ts`
- [Permission rules](https://github.com/joblinours/fleight-board/blob/main/packages/permissions/src/index.ts): `packages/permissions/src/index.ts`

### Persistence

- [Database connection](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/database.ts): `apps/api/src/database.ts`
- [Database schema](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/db/schema.ts): `apps/api/src/db/schema.ts`
- [Audit log store](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/db/audit-log.ts): `apps/api/src/db/audit-log.ts`
- [Board store](https://github.com/joblinours/fleight-board/blob/main/apps/api/src/db/board-store.ts): `apps/api/src/db/board-store.ts`

### Other components

- **User / guest**
- **PostgreSQL**

## Connections

- User / guest → Web app routing: opens
- Web app routing → Authentication UI: routes to (evidence: `apps/web/src/App.tsx`)
- Web app routing → Board workspace: routes to (evidence: `apps/web/src/App.tsx`)
- Web app routing → Admin and audit: routes to (evidence: `apps/web/src/App.tsx`)
- Web app routing → Audit viewer: routes to (evidence: `apps/web/src/App.tsx`)
- Web app routing → Session state: refreshes (evidence: `apps/web/src/App.tsx`)
- Authentication UI → Session state: updates (evidence: `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 (evidence: `packages/canvas/src/board/editor.ts`)
- Canvas editor → Canvas renderer: uses renderer (evidence: `packages/canvas/src/board/editor.ts`)
- Canvas editor → Selection tools: uses selection (evidence: `packages/canvas/src/board/editor.ts`)
- Canvas editor → Board document: edits (evidence: `packages/canvas/src/board/editor.ts`)
- Pointer input → Canvas editor: dispatches gestures (evidence: `packages/canvas/src/board/editor.ts`)
- Undo history → Board document: tracks edits (evidence: `packages/document/src/undo-history.ts`)
- Collaboration client → Board document: applies operations (evidence: `packages/collaboration/src/client.ts`)
- Collaboration client → Shared protocol: uses messages (evidence: `packages/collaboration/src/client.ts`)
- Collaboration hub → Board rooms: routes board traffic (evidence: `packages/collaboration/src/hub.ts`)
- Collaboration hub → Object locks: manages locks (evidence: `packages/collaboration/src/hub.ts`)
- API application → Auth routes: registers (evidence: `apps/api/src/app.ts`)
- API application → Board routes: registers (evidence: `apps/api/src/app.ts`)
- API application → Collaboration hub: registers websocket (evidence: `apps/api/src/app.ts`)
- Auth routes → Auth service: calls (evidence: `apps/api/src/auth/routes.ts`)
- Board routes → Board service: calls (evidence: `apps/api/src/boards/routes.ts`)
- Board service → Permission rules: checks access (evidence: `apps/api/src/boards/board-service.ts`)
- Auth service → Database connection: queries (evidence: `apps/api/src/auth/auth-service.ts`)
- Board service → Database connection: queries (evidence: `apps/api/src/boards/board-service.ts`)
- Board service → Audit log store: records events (evidence: `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 (evidence: `apps/api/src/database.ts`)
- Database connection → PostgreSQL: connects (evidence: `apps/api/src/database.ts`)
- Audit log store → Database connection: queries (evidence: `apps/api/src/db/audit-log.ts`)
- Board store → Database connection: stores board data
