# godhuber/scratchpad architecture

> Architecture diagram of the GitHub repository godhuber/scratchpad, 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/godhuber/scratchpad
- Repository: https://github.com/godhuber/scratchpad

## Overview

Scratchpad is a shared creative workspace combining an infinite canvas, bookmark library, team management and collaboration. The main user flow is sign-in, select or join a workspace, then work on its canvas and bookmarks; team and invitation screens manage access. The canvas hook persists versioned content and subscribes to realtime changes, while presence supports collaborator avatars. The README documents media cards, role-based access and conflict reconciliation. Some page and canvas wiring is visible in the source index, but unsampled implementations are represented at their listed paths; edges are limited to shown or documented relationships.

Main entry points: [`src/pages/WorkspacePage.tsx`](https://github.com/godhuber/scratchpad/blob/main/src/pages/WorkspacePage.tsx) (Workspace screen), [`src/integrations/supabase/client.ts`](https://github.com/godhuber/scratchpad/blob/main/src/integrations/supabase/client.ts) (Supabase client), [`src/App.tsx`](https://github.com/godhuber/scratchpad/blob/main/src/App.tsx) (App routes), [`src/contexts/WorkspaceContext.tsx`](https://github.com/godhuber/scratchpad/blob/main/src/contexts/WorkspaceContext.tsx) (Workspace state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and identity"]
  node_router["App routes<br/>[App.tsx]"]
  node_signin["Sign-in<br/>[SignInPage.tsx]"]
  node_auth["Authentication state<br/>[AuthContext.tsx]"]
end

subgraph group_workspace["Workspace and teams"]
  node_workspace_ctx["Workspace state"]
  node_workspace_page["Workspace screen<br/>[WorkspacePage.tsx]"]
  node_teams["Team management<br/>[TeamsPage.tsx]"]
  node_invitations["Invitation flows"]
  node_join_invite["Join invitation<br/>[JoinInvitePage.tsx]"]
  node_presence["Presence avatars<br/>[usePresence.ts]"]
end

subgraph group_canvas["Canvas and content"]
  node_canvas["Workspace canvas"]
  node_toolbar["Canvas tools"]
  node_context_tools["Context tools<br/>[ContextToolbox.tsx]"]
  node_canvas_items["Canvas persistence<br/>[useCanvasItems.ts]"]
  node_bookmarks["Bookmark library<br/>[BookmarksPage.tsx]"]
  node_bookmark_editor["Bookmark editor"]
  node_media["Media links"]
  node_drive["Drive link parsing<br/>[drive.ts]"]
end

subgraph group_platform["Backend and collaboration"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
  node_supabase[("Supabase backend")]
end

node_user(("User"))

node_user -->|"uses app"| node_router
node_router -->|"routes to"| node_signin
node_router -->|"routes to"| node_workspace_page
node_router -->|"routes to"| node_teams
node_router -->|"routes to"| node_invitations
node_router -->|"routes to"| node_join_invite
node_signin -->|"uses"| node_auth
node_auth -->|"authenticates through"| node_supabase_client
node_workspace_ctx -->|"reads identity"| node_auth
node_workspace_ctx -->|"loads workspace data"| node_supabase_client
node_workspace_page -->|"uses workspace"| node_workspace_ctx
node_workspace_page -->|"renders canvas"| node_canvas
node_workspace_page -->|"uses content hook"| node_canvas_items
node_workspace_page -->|"tracks collaborators"| node_presence
node_workspace_page -->|"renders tools"| node_toolbar
node_workspace_page -->|"renders tools"| node_context_tools
node_canvas -->|"reads and updates"| node_canvas_items
node_toolbar -->|"edits items"| node_canvas_items
node_context_tools -->|"renders"| node_toolbar
node_canvas_items -->|"persists and subscribes"| node_supabase_client
node_bookmarks -->|"uses workspace"| node_workspace_ctx
node_bookmarks -->|"opens editor"| node_bookmark_editor
node_bookmarks -->|"reads and writes"| node_supabase_client
node_bookmark_editor -->|"saves bookmark"| node_supabase_client
node_workspace_page -->|"opens link dialog"| node_media
node_media -->|"parses links"| node_drive
node_media -->|"stores media link"| node_supabase_client
node_presence -->|"uses realtime"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_supabase -.->|"syncs shared changes"| node_user

click node_router "https://github.com/godhuber/scratchpad/blob/main/src/App.tsx"
click node_signin "https://github.com/godhuber/scratchpad/blob/main/src/pages/SignInPage.tsx"
click node_auth "https://github.com/godhuber/scratchpad/blob/main/src/contexts/AuthContext.tsx"
click node_workspace_ctx "https://github.com/godhuber/scratchpad/blob/main/src/contexts/WorkspaceContext.tsx"
click node_workspace_page "https://github.com/godhuber/scratchpad/blob/main/src/pages/WorkspacePage.tsx"
click node_teams "https://github.com/godhuber/scratchpad/blob/main/src/pages/TeamsPage.tsx"
click node_invitations "https://github.com/godhuber/scratchpad/blob/main/src/pages/InvitationsPage.tsx"
click node_join_invite "https://github.com/godhuber/scratchpad/blob/main/src/pages/JoinInvitePage.tsx"
click node_canvas "https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/WorkspaceCanvas.tsx"
click node_toolbar "https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/FloatingToolbar.tsx"
click node_context_tools "https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/ContextToolbox.tsx"
click node_canvas_items "https://github.com/godhuber/scratchpad/blob/main/src/hooks/useCanvasItems.ts"
click node_bookmarks "https://github.com/godhuber/scratchpad/blob/main/src/pages/BookmarksPage.tsx"
click node_bookmark_editor "https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/BookmarkEditorModal.tsx"
click node_media "https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/AddMediaLinkModal.tsx"
click node_drive "https://github.com/godhuber/scratchpad/blob/main/src/lib/drive.ts"
click node_presence "https://github.com/godhuber/scratchpad/blob/main/src/hooks/usePresence.ts"
click node_supabase_client "https://github.com/godhuber/scratchpad/blob/main/src/integrations/supabase/client.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_router,node_signin,node_auth,node_user toneBlue
class node_workspace_ctx,node_workspace_page,node_teams,node_invitations,node_join_invite,node_presence toneAmber
class node_canvas,node_toolbar,node_context_tools,node_canvas_items,node_bookmarks,node_bookmark_editor,node_media,node_drive toneMint
class node_supabase_client,node_supabase toneRose
```

## Components

### App and identity

- [App routes](https://github.com/godhuber/scratchpad/blob/main/src/App.tsx): `src/App.tsx`
- [Sign-in](https://github.com/godhuber/scratchpad/blob/main/src/pages/SignInPage.tsx): `src/pages/SignInPage.tsx`
- [Authentication state](https://github.com/godhuber/scratchpad/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`

### Workspace and teams

- [Workspace state](https://github.com/godhuber/scratchpad/blob/main/src/contexts/WorkspaceContext.tsx): `src/contexts/WorkspaceContext.tsx`
- [Workspace screen](https://github.com/godhuber/scratchpad/blob/main/src/pages/WorkspacePage.tsx): `src/pages/WorkspacePage.tsx`
- [Team management](https://github.com/godhuber/scratchpad/blob/main/src/pages/TeamsPage.tsx): `src/pages/TeamsPage.tsx`
- [Invitation flows](https://github.com/godhuber/scratchpad/blob/main/src/pages/InvitationsPage.tsx): `src/pages/InvitationsPage.tsx`
- [Join invitation](https://github.com/godhuber/scratchpad/blob/main/src/pages/JoinInvitePage.tsx): `src/pages/JoinInvitePage.tsx`
- [Presence avatars](https://github.com/godhuber/scratchpad/blob/main/src/hooks/usePresence.ts): `src/hooks/usePresence.ts`

### Canvas and content

- [Workspace canvas](https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/WorkspaceCanvas.tsx): `src/components/canvas/WorkspaceCanvas.tsx`
- [Canvas tools](https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/FloatingToolbar.tsx): `src/components/canvas/FloatingToolbar.tsx`
- [Context tools](https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/ContextToolbox.tsx): `src/components/canvas/ContextToolbox.tsx`
- [Canvas persistence](https://github.com/godhuber/scratchpad/blob/main/src/hooks/useCanvasItems.ts): `src/hooks/useCanvasItems.ts`
- [Bookmark library](https://github.com/godhuber/scratchpad/blob/main/src/pages/BookmarksPage.tsx): `src/pages/BookmarksPage.tsx`
- [Bookmark editor](https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/BookmarkEditorModal.tsx): `src/components/canvas/BookmarkEditorModal.tsx`
- [Media links](https://github.com/godhuber/scratchpad/blob/main/src/components/canvas/AddMediaLinkModal.tsx): `src/components/canvas/AddMediaLinkModal.tsx`
- [Drive link parsing](https://github.com/godhuber/scratchpad/blob/main/src/lib/drive.ts): `src/lib/drive.ts`

### Backend and collaboration

- [Supabase client](https://github.com/godhuber/scratchpad/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- **Supabase backend**

### Other components

- **User**

## Connections

- User → App routes: uses app (evidence: `src/App.tsx`)
- App routes → Sign-in: routes to (evidence: `src/App.tsx`)
- App routes → Workspace screen: routes to (evidence: `src/App.tsx`)
- App routes → Team management: routes to (evidence: `src/App.tsx`)
- App routes → Invitation flows: routes to (evidence: `src/App.tsx`)
- App routes → Join invitation: routes to (evidence: `src/App.tsx`)
- Sign-in → Authentication state: uses (evidence: `src/pages/SignInPage.tsx`)
- Authentication state → Supabase client: authenticates through (evidence: `src/contexts/AuthContext.tsx`)
- Workspace state → Authentication state: reads identity (evidence: `src/contexts/WorkspaceContext.tsx`)
- Workspace state → Supabase client: loads workspace data (evidence: `src/contexts/WorkspaceContext.tsx`)
- Workspace screen → Workspace state: uses workspace (evidence: `src/pages/WorkspacePage.tsx`)
- Workspace screen → Workspace canvas: renders canvas (evidence: `src/pages/WorkspacePage.tsx`)
- Workspace screen → Canvas persistence: uses content hook (evidence: `src/pages/WorkspacePage.tsx`)
- Workspace screen → Presence avatars: tracks collaborators (evidence: `src/pages/WorkspacePage.tsx`)
- Workspace screen → Canvas tools: renders tools (evidence: `src/pages/WorkspacePage.tsx`)
- Workspace screen → Context tools: renders tools (evidence: `src/pages/WorkspacePage.tsx`)
- Workspace canvas → Canvas persistence: reads and updates (evidence: `src/components/canvas/WorkspaceCanvas.tsx`)
- Canvas tools → Canvas persistence: edits items (evidence: `src/components/canvas/FloatingToolbar.tsx`)
- Context tools → Canvas tools: renders (evidence: `src/components/canvas/ContextToolbox.tsx`)
- Canvas persistence → Supabase client: persists and subscribes (evidence: `src/hooks/useCanvasItems.ts`)
- Bookmark library → Workspace state: uses workspace (evidence: `src/pages/BookmarksPage.tsx`)
- Bookmark library → Bookmark editor: opens editor (evidence: `src/pages/BookmarksPage.tsx`)
- Bookmark library → Supabase client: reads and writes (evidence: `src/pages/BookmarksPage.tsx`)
- Bookmark editor → Supabase client: saves bookmark (evidence: `src/components/canvas/BookmarkEditorModal.tsx`)
- Workspace screen → Media links: opens link dialog (evidence: `src/pages/WorkspacePage.tsx`)
- Media links → Drive link parsing: parses links (evidence: `src/components/canvas/AddMediaLinkModal.tsx`)
- Media links → Supabase client: stores media link (evidence: `src/components/canvas/AddMediaLinkModal.tsx`)
- Presence avatars → Supabase client: uses realtime (evidence: `src/hooks/usePresence.ts`)
- Supabase client → Supabase backend: connects to (evidence: `src/integrations/supabase/client.ts`)
- Supabase backend → User: syncs shared changes
