# danielsteele1/collab-board architecture

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

- Interactive diagram: https://gitdiagram.com/danielsteele1/collab-board
- Repository: https://github.com/danielsteele1/collab-board

## Overview

This React application supports creating and finding whiteboards, opening a board room, and collaborating on a canvas with drawing, shapes, text, notes, zoom, and live presence. The documented workflow also includes sharing and joining by code, guest access, and account-based workspaces; the README lists Supabase and Google OAuth, but the sampled code does not establish those service connections. Board lists are persisted in browser local storage, while Liveblocks provides the documented collaboration layer. Some component relationships are based on imports or README statements; unsampled behavior is not inferred.

Main entry points: [`src/App.tsx`](https://github.com/danielsteele1/collab-board/blob/main/src/App.tsx) (Application routes), [`src/components/dashboard.tsx`](https://github.com/danielsteele1/collab-board/blob/main/src/components/dashboard.tsx) (Board dashboard), [`src/components/Canvas.tsx`](https://github.com/danielsteele1/collab-board/blob/main/src/components/Canvas.tsx) (Collaborative canvas), [`src/components/whiteboard.tsx`](https://github.com/danielsteele1/collab-board/blob/main/src/components/whiteboard.tsx) (Whiteboard page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Application and navigation"]
  node_app["Application routes<br/>[App.tsx]"]
  node_home["Homepage<br/>[homepage.tsx]"]
  node_typing["Typing animation<br/>[TextType.tsx]"]
  node_notfound["Not found<br/>[FourOFour.tsx]"]
  node_navigationbar["Navigation bar<br/>[navigation.tsx]"]
end

subgraph group_boards["Board discovery and management"]
  node_dashboard["Board dashboard<br/>[dashboard.tsx]"]
  node_boardlist[("Board browser storage<br/>[dashboard.tsx]")]
  node_create["Create board dialog"]
  node_card["Board cards<br/>[WhiteboardCard.tsx]"]
  node_table["Board table"]
  node_quick["Quick-switch sidebar<br/>[Sidebar.tsx]"]
  node_share["Share-code dialog"]
end

subgraph group_collaboration["Collaborative whiteboard"]
  node_boardpage["Whiteboard page<br/>[whiteboard.tsx]"]
  node_room["Board room<br/>[Room.tsx]"]
  node_canvas["Collaborative canvas<br/>[Canvas.tsx]"]
  node_toolbar["Canvas tools<br/>[Toolbar.tsx]"]
  node_inserttext["Text editing<br/>[InsertText.tsx]"]
  node_stickynote["Sticky notes<br/>[StickyNote.tsx]"]
  node_zoom["Canvas zoom<br/>[ZoomWidget.tsx]"]
end

subgraph group_identity["Identity and account"]
  node_login["Login<br/>[login.tsx]"]
  node_accounts["Account view<br/>[Accounts.tsx]"]
  node_store[("Session profile state<br/>[ZustandStore.tsx]")]
end

node_user(("Visitor"))
node_liveblocks{{"Liveblocks service"}}

node_user -->|"opens app"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_boardpage
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_accounts
node_app -->|"routes to"| node_notfound
node_app -->|"renders"| node_navigationbar
node_home -->|"uses animation"| node_typing
node_dashboard -->|"opens"| node_create
node_dashboard -->|"renders"| node_card
node_dashboard -->|"renders"| node_table
node_dashboard -->|"reads and writes"| node_boardlist
node_dashboard -->|"reads profile"| node_store
node_dashboard -.->|"supports code sharing"| node_share
node_card -.->|"opens board"| node_boardpage
node_table -.->|"opens board"| node_boardpage
node_quick -->|"links boards"| node_boardpage
node_boardpage -->|"renders room"| node_room
node_boardpage -->|"renders canvas"| node_canvas
node_room -.->|"joins collaboration"| node_liveblocks
node_canvas -->|"syncs shared state"| node_liveblocks
node_canvas -->|"renders tools"| node_toolbar
node_canvas -->|"renders sidebar"| node_quick
node_canvas -->|"renders zoom"| node_zoom
node_canvas -->|"renders editor"| node_inserttext
node_canvas -->|"renders notes"| node_stickynote
node_login -->|"updates session"| node_store
node_accounts -->|"reads profile"| node_store
node_navigationbar -->|"reads session"| node_store

click node_app "https://github.com/danielsteele1/collab-board/blob/main/src/App.tsx"
click node_home "https://github.com/danielsteele1/collab-board/blob/main/src/components/homepage.tsx"
click node_typing "https://github.com/danielsteele1/collab-board/blob/main/src/react-bits/TextType.tsx"
click node_notfound "https://github.com/danielsteele1/collab-board/blob/main/src/components/FourOFour.tsx"
click node_dashboard "https://github.com/danielsteele1/collab-board/blob/main/src/components/dashboard.tsx"
click node_boardlist "https://github.com/danielsteele1/collab-board/blob/main/src/components/dashboard.tsx"
click node_create "https://github.com/danielsteele1/collab-board/blob/main/src/components/create-board-modal.tsx"
click node_card "https://github.com/danielsteele1/collab-board/blob/main/src/components/WhiteboardCard.tsx"
click node_table "https://github.com/danielsteele1/collab-board/blob/main/src/components/whiteboard-table.tsx"
click node_quick "https://github.com/danielsteele1/collab-board/blob/main/src/components/Sidebar.tsx"
click node_share "https://github.com/danielsteele1/collab-board/blob/main/src/components/share-code-modal.tsx"
click node_boardpage "https://github.com/danielsteele1/collab-board/blob/main/src/components/whiteboard.tsx"
click node_room "https://github.com/danielsteele1/collab-board/blob/main/src/components/Room.tsx"
click node_canvas "https://github.com/danielsteele1/collab-board/blob/main/src/components/Canvas.tsx"
click node_toolbar "https://github.com/danielsteele1/collab-board/blob/main/src/components/Toolbar.tsx"
click node_inserttext "https://github.com/danielsteele1/collab-board/blob/main/src/components/InsertText.tsx"
click node_stickynote "https://github.com/danielsteele1/collab-board/blob/main/src/components/StickyNote.tsx"
click node_zoom "https://github.com/danielsteele1/collab-board/blob/main/src/components/ZoomWidget.tsx"
click node_login "https://github.com/danielsteele1/collab-board/blob/main/src/components/login.tsx"
click node_accounts "https://github.com/danielsteele1/collab-board/blob/main/src/components/Accounts.tsx"
click node_store "https://github.com/danielsteele1/collab-board/blob/main/src/ZustandStore.tsx"
click node_navigationbar "https://github.com/danielsteele1/collab-board/blob/main/src/components/navigation.tsx"

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_app,node_home,node_typing,node_notfound,node_navigationbar toneBlue
class node_dashboard,node_boardlist,node_create,node_card,node_table,node_quick,node_share toneAmber
class node_boardpage,node_room,node_canvas,node_toolbar,node_inserttext,node_stickynote,node_zoom toneMint
class node_login,node_accounts,node_store toneRose
class node_user,node_liveblocks toneIndigo
```

## Components

### Application and navigation

- [Application routes](https://github.com/danielsteele1/collab-board/blob/main/src/App.tsx): `src/App.tsx`
- [Homepage](https://github.com/danielsteele1/collab-board/blob/main/src/components/homepage.tsx): `src/components/homepage.tsx`
- [Typing animation](https://github.com/danielsteele1/collab-board/blob/main/src/react-bits/TextType.tsx): `src/react-bits/TextType.tsx`
- [Not found](https://github.com/danielsteele1/collab-board/blob/main/src/components/FourOFour.tsx): `src/components/FourOFour.tsx`
- [Navigation bar](https://github.com/danielsteele1/collab-board/blob/main/src/components/navigation.tsx): `src/components/navigation.tsx`

### Board discovery and management

- [Board dashboard](https://github.com/danielsteele1/collab-board/blob/main/src/components/dashboard.tsx): `src/components/dashboard.tsx`
- [Board browser storage](https://github.com/danielsteele1/collab-board/blob/main/src/components/dashboard.tsx): `src/components/dashboard.tsx`
- [Create board dialog](https://github.com/danielsteele1/collab-board/blob/main/src/components/create-board-modal.tsx): `src/components/create-board-modal.tsx`
- [Board cards](https://github.com/danielsteele1/collab-board/blob/main/src/components/WhiteboardCard.tsx): `src/components/WhiteboardCard.tsx`
- [Board table](https://github.com/danielsteele1/collab-board/blob/main/src/components/whiteboard-table.tsx): `src/components/whiteboard-table.tsx`
- [Quick-switch sidebar](https://github.com/danielsteele1/collab-board/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Share-code dialog](https://github.com/danielsteele1/collab-board/blob/main/src/components/share-code-modal.tsx): `src/components/share-code-modal.tsx`

### Collaborative whiteboard

- [Whiteboard page](https://github.com/danielsteele1/collab-board/blob/main/src/components/whiteboard.tsx): `src/components/whiteboard.tsx`
- [Board room](https://github.com/danielsteele1/collab-board/blob/main/src/components/Room.tsx): `src/components/Room.tsx`
- [Collaborative canvas](https://github.com/danielsteele1/collab-board/blob/main/src/components/Canvas.tsx): `src/components/Canvas.tsx`
- [Canvas tools](https://github.com/danielsteele1/collab-board/blob/main/src/components/Toolbar.tsx): `src/components/Toolbar.tsx`
- [Text editing](https://github.com/danielsteele1/collab-board/blob/main/src/components/InsertText.tsx): `src/components/InsertText.tsx`
- [Sticky notes](https://github.com/danielsteele1/collab-board/blob/main/src/components/StickyNote.tsx): `src/components/StickyNote.tsx`
- [Canvas zoom](https://github.com/danielsteele1/collab-board/blob/main/src/components/ZoomWidget.tsx): `src/components/ZoomWidget.tsx`

### Identity and account

- [Login](https://github.com/danielsteele1/collab-board/blob/main/src/components/login.tsx): `src/components/login.tsx`
- [Account view](https://github.com/danielsteele1/collab-board/blob/main/src/components/Accounts.tsx): `src/components/Accounts.tsx`
- [Session profile state](https://github.com/danielsteele1/collab-board/blob/main/src/ZustandStore.tsx): `src/ZustandStore.tsx`

### Other components

- **Visitor**
- **Liveblocks service**

## Connections

- Visitor → Application routes: opens app
- Application routes → Homepage: routes to (evidence: `src/App.tsx`)
- Application routes → Board dashboard: routes to (evidence: `src/App.tsx`)
- Application routes → Whiteboard page: routes to (evidence: `src/App.tsx`)
- Application routes → Login: routes to (evidence: `src/App.tsx`)
- Application routes → Account view: routes to (evidence: `src/App.tsx`)
- Application routes → Not found: routes to (evidence: `src/App.tsx`)
- Application routes → Navigation bar: renders (evidence: `src/App.tsx`)
- Homepage → Typing animation: uses animation (evidence: `src/components/homepage.tsx`)
- Board dashboard → Create board dialog: opens (evidence: `src/components/dashboard.tsx`)
- Board dashboard → Board cards: renders (evidence: `src/components/dashboard.tsx`)
- Board dashboard → Board table: renders (evidence: `src/components/dashboard.tsx`)
- Board dashboard → Board browser storage: reads and writes (evidence: `src/components/dashboard.tsx`)
- Board dashboard → Session profile state: reads profile (evidence: `src/components/dashboard.tsx`)
- Board dashboard → Share-code dialog: supports code sharing (evidence: `README.md`)
- Board cards → Whiteboard page: opens board (evidence: `README.md`)
- Board table → Whiteboard page: opens board (evidence: `README.md`)
- Quick-switch sidebar → Whiteboard page: links boards (evidence: `src/components/Sidebar.tsx`)
- Whiteboard page → Board room: renders room (evidence: `src/components/whiteboard.tsx`)
- Whiteboard page → Collaborative canvas: renders canvas (evidence: `src/components/whiteboard.tsx`)
- Board room → Liveblocks service: joins collaboration (evidence: `README.md`)
- Collaborative canvas → Liveblocks service: syncs shared state (evidence: `README.md`)
- Collaborative canvas → Canvas tools: renders tools (evidence: `src/components/Canvas.tsx`)
- Collaborative canvas → Quick-switch sidebar: renders sidebar (evidence: `src/components/Canvas.tsx`)
- Collaborative canvas → Canvas zoom: renders zoom (evidence: `src/components/Canvas.tsx`)
- Collaborative canvas → Text editing: renders editor (evidence: `src/components/Canvas.tsx`)
- Collaborative canvas → Sticky notes: renders notes (evidence: `src/components/Canvas.tsx`)
- Login → Session profile state: updates session (evidence: `src/components/login.tsx`)
- Account view → Session profile state: reads profile (evidence: `src/components/Accounts.tsx`)
- Navigation bar → Session profile state: reads session (evidence: `src/components/navigation.tsx`)
