# kartikeya1911/canvas architecture

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

- Interactive diagram: https://gitdiagram.com/kartikeya1911/canvas
- Repository: https://github.com/kartikeya1911/canvas

## Overview

ColabCanvas is a browser-based collaborative whiteboard. Users sign up or log in, open the dashboard, create or select a board, then draw and collaborate; board state is managed through HTTP services and live updates through Socket.IO. Sharing links and board access extend that workflow, while export, layers, presence, cursor tracking, themes, and shortcuts are additional product capabilities. The graph combines sampled routing and service wiring with README-documented features; several UI and socket internals were not excerpted, so those links are documented or left out rather than inferred from names alone.

Main entry points: [`client/src/App.js`](https://github.com/kartikeya1911/canvas/blob/main/client/src/App.js) (Route application), [`client/src/pages/Board.jsx`](https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Board.jsx) (Whiteboard canvas), [`client/src/services/boardService.js`](https://github.com/kartikeya1911/canvas/blob/main/client/src/services/boardService.js) (Board API client), [`server/models/User.js`](https://github.com/kartikeya1911/canvas/blob/main/server/models/User.js) (User records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_app["Route application<br/>[App.js]"]
  node_authui["Authentication UI<br/>[Login.jsx]"]
  node_authstate["Authentication state<br/>[AuthContext.js]"]
  node_dashboard["Board dashboard<br/>[Dashboard.jsx]"]
  node_boardservice["Board API client<br/>[boardService.js]"]
  node_api["HTTP client<br/>[api.js]"]
  node_theme["Theme state<br/>[ThemeContext.js]"]
end

subgraph group_canvas["Canvas collaboration"]
  node_boardui["Whiteboard canvas<br/>[Board.jsx]"]
  node_invite["Invite joining<br/>[BoardInvite.jsx]"]
  node_socketclient["Realtime client<br/>[socketService.js]"]
  node_layers["Layer controls<br/>[LayerManager.jsx]"]
  node_cursors["Cursor display<br/>[CursorManager.jsx]"]
  node_sharing["Share controls<br/>[ShareModal.jsx]"]
  node_export["Board export<br/>[ExportModal.jsx]"]
end

subgraph group_backend["Backend services"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_authcontroller["Authentication logic<br/>[authController.js]"]
  node_authmiddleware["JWT verification<br/>[authMiddleware.js]"]
  node_boardroutes["Board routes<br/>[boardRoutes.js]"]
  node_boardcontroller["Board operations<br/>[boardController.js]"]
  node_sockethandler["Whiteboard events"]
end

subgraph group_data["Persistent data"]
  node_users[("User records<br/>[User.js]")]
  node_boards[("Board records<br/>[Board.js]")]
end

node_user(("Team member"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_boardui
node_app -->|"routes to"| node_invite
node_authui -->|"uses"| node_authstate
node_authstate -->|"calls"| node_api
node_dashboard -->|"requests boards"| node_boardservice
node_boardui -->|"loads and saves"| node_boardservice
node_boardui -->|"uses live updates"| node_socketclient
node_invite -->|"joins board"| node_boardservice
node_sharing -->|"requests invites"| node_boardservice
node_boardservice -->|"sends requests"| node_api
node_boardui -.->|"manages layers"| node_layers
node_boardui -.->|"shows cursors"| node_cursors
node_boardui -.->|"exports board"| node_export
node_app -->|"provides theme"| node_theme
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_boardroutes
node_server -->|"registers events"| node_sockethandler
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"protects routes"| node_authmiddleware
node_boardroutes -->|"dispatches"| node_boardcontroller
node_boardroutes -->|"protects routes"| node_authmiddleware
node_authcontroller -->|"reads and writes"| node_users
node_authcontroller -->|"populates boards"| node_boards
node_authmiddleware -->|"loads user"| node_users
node_boardcontroller -->|"reads and writes"| node_boards
node_boardcontroller -->|"updates membership"| node_users
node_sockethandler -->|"uses board model"| node_boards
node_users -->|"persists"| node_mongodb
node_boards -->|"persists"| node_mongodb
node_socketclient -.->|"exchanges events"| node_sockethandler

click node_app "https://github.com/kartikeya1911/canvas/blob/main/client/src/App.js"
click node_authui "https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Login.jsx"
click node_authstate "https://github.com/kartikeya1911/canvas/blob/main/client/src/contexts/AuthContext.js"
click node_dashboard "https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Dashboard.jsx"
click node_boardui "https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Board.jsx"
click node_invite "https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/BoardInvite.jsx"
click node_boardservice "https://github.com/kartikeya1911/canvas/blob/main/client/src/services/boardService.js"
click node_api "https://github.com/kartikeya1911/canvas/blob/main/client/src/services/api.js"
click node_socketclient "https://github.com/kartikeya1911/canvas/blob/main/client/src/services/socketService.js"
click node_layers "https://github.com/kartikeya1911/canvas/blob/main/client/src/components/LayerManager.jsx"
click node_cursors "https://github.com/kartikeya1911/canvas/blob/main/client/src/components/CursorManager.jsx"
click node_sharing "https://github.com/kartikeya1911/canvas/blob/main/client/src/components/ShareModal.jsx"
click node_export "https://github.com/kartikeya1911/canvas/blob/main/client/src/components/ExportModal.jsx"
click node_theme "https://github.com/kartikeya1911/canvas/blob/main/client/src/contexts/ThemeContext.js"
click node_server "https://github.com/kartikeya1911/canvas/blob/main/server/server.js"
click node_authroutes "https://github.com/kartikeya1911/canvas/blob/main/server/routes/authRoutes.js"
click node_authcontroller "https://github.com/kartikeya1911/canvas/blob/main/server/controllers/authController.js"
click node_authmiddleware "https://github.com/kartikeya1911/canvas/blob/main/server/middleware/authMiddleware.js"
click node_boardroutes "https://github.com/kartikeya1911/canvas/blob/main/server/routes/boardRoutes.js"
click node_boardcontroller "https://github.com/kartikeya1911/canvas/blob/main/server/controllers/boardController.js"
click node_sockethandler "https://github.com/kartikeya1911/canvas/blob/main/server/socketHandlers/whiteboardEvents.js"
click node_users "https://github.com/kartikeya1911/canvas/blob/main/server/models/User.js"
click node_boards "https://github.com/kartikeya1911/canvas/blob/main/server/models/Board.js"

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_authui,node_authstate,node_dashboard,node_boardservice,node_api,node_theme toneBlue
class node_boardui,node_invite,node_socketclient,node_layers,node_cursors,node_sharing,node_export,node_mongodb toneAmber
class node_server,node_authroutes,node_authcontroller,node_authmiddleware,node_boardroutes,node_boardcontroller,node_sockethandler toneMint
class node_users,node_boards toneRose
class node_user toneIndigo
```

## Components

### Client application

- [Route application](https://github.com/kartikeya1911/canvas/blob/main/client/src/App.js): `client/src/App.js`
- [Authentication UI](https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Authentication state](https://github.com/kartikeya1911/canvas/blob/main/client/src/contexts/AuthContext.js): `client/src/contexts/AuthContext.js`
- [Board dashboard](https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Board API client](https://github.com/kartikeya1911/canvas/blob/main/client/src/services/boardService.js): `client/src/services/boardService.js`
- [HTTP client](https://github.com/kartikeya1911/canvas/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Theme state](https://github.com/kartikeya1911/canvas/blob/main/client/src/contexts/ThemeContext.js): `client/src/contexts/ThemeContext.js`

### Canvas collaboration

- [Whiteboard canvas](https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/Board.jsx): `client/src/pages/Board.jsx`
- [Invite joining](https://github.com/kartikeya1911/canvas/blob/main/client/src/pages/BoardInvite.jsx): `client/src/pages/BoardInvite.jsx`
- [Realtime client](https://github.com/kartikeya1911/canvas/blob/main/client/src/services/socketService.js): `client/src/services/socketService.js`
- [Layer controls](https://github.com/kartikeya1911/canvas/blob/main/client/src/components/LayerManager.jsx): `client/src/components/LayerManager.jsx`
- [Cursor display](https://github.com/kartikeya1911/canvas/blob/main/client/src/components/CursorManager.jsx): `client/src/components/CursorManager.jsx`
- [Share controls](https://github.com/kartikeya1911/canvas/blob/main/client/src/components/ShareModal.jsx): `client/src/components/ShareModal.jsx`
- [Board export](https://github.com/kartikeya1911/canvas/blob/main/client/src/components/ExportModal.jsx): `client/src/components/ExportModal.jsx`

### Backend services

- [HTTP and socket server](https://github.com/kartikeya1911/canvas/blob/main/server/server.js): `server/server.js`
- [Authentication routes](https://github.com/kartikeya1911/canvas/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Authentication logic](https://github.com/kartikeya1911/canvas/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [JWT verification](https://github.com/kartikeya1911/canvas/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Board routes](https://github.com/kartikeya1911/canvas/blob/main/server/routes/boardRoutes.js): `server/routes/boardRoutes.js`
- [Board operations](https://github.com/kartikeya1911/canvas/blob/main/server/controllers/boardController.js): `server/controllers/boardController.js`
- [Whiteboard events](https://github.com/kartikeya1911/canvas/blob/main/server/socketHandlers/whiteboardEvents.js): `server/socketHandlers/whiteboardEvents.js`

### Persistent data

- [User records](https://github.com/kartikeya1911/canvas/blob/main/server/models/User.js): `server/models/User.js`
- [Board records](https://github.com/kartikeya1911/canvas/blob/main/server/models/Board.js): `server/models/Board.js`

### Other components

- **Team member**
- **MongoDB**

## Connections

- Team member → Route application: uses (evidence: `README.md`)
- Route application → Authentication UI: routes to (evidence: `client/src/App.js`)
- Route application → Board dashboard: routes to (evidence: `client/src/App.js`)
- Route application → Whiteboard canvas: routes to (evidence: `client/src/App.js`)
- Route application → Invite joining: routes to (evidence: `client/src/App.js`)
- Authentication UI → Authentication state: uses (evidence: `client/src/pages/Login.jsx`)
- Authentication state → HTTP client: calls (evidence: `client/src/contexts/AuthContext.js`)
- Board dashboard → Board API client: requests boards (evidence: `client/src/pages/Dashboard.jsx`)
- Whiteboard canvas → Board API client: loads and saves (evidence: `client/src/pages/Board.jsx`)
- Whiteboard canvas → Realtime client: uses live updates (evidence: `client/src/pages/Board.jsx`)
- Invite joining → Board API client: joins board (evidence: `client/src/pages/BoardInvite.jsx`)
- Share controls → Board API client: requests invites (evidence: `client/src/components/ShareModal.jsx`)
- Board API client → HTTP client: sends requests (evidence: `client/src/services/boardService.js`)
- Whiteboard canvas → Layer controls: manages layers
- Whiteboard canvas → Cursor display: shows cursors
- Whiteboard canvas → Board export: exports board
- Route application → Theme state: provides theme (evidence: `client/src/App.js`)
- HTTP and socket server → Authentication routes: mounts (evidence: `server/server.js`)
- HTTP and socket server → Board routes: mounts (evidence: `server/server.js`)
- HTTP and socket server → Whiteboard events: registers events (evidence: `server/server.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `server/routes/authRoutes.js`)
- Authentication routes → JWT verification: protects routes (evidence: `server/routes/authRoutes.js`)
- Board routes → Board operations: dispatches (evidence: `server/routes/boardRoutes.js`)
- Board routes → JWT verification: protects routes (evidence: `server/routes/boardRoutes.js`)
- Authentication logic → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Authentication logic → Board records: populates boards (evidence: `server/controllers/authController.js`)
- JWT verification → User records: loads user (evidence: `server/middleware/authMiddleware.js`)
- Board operations → Board records: reads and writes (evidence: `server/controllers/boardController.js`)
- Board operations → User records: updates membership (evidence: `server/controllers/boardController.js`)
- Whiteboard events → Board records: uses board model (evidence: `server/socketHandlers/whiteboardEvents.js`)
- User records → MongoDB: persists (evidence: `README.md`)
- Board records → MongoDB: persists (evidence: `README.md`)
- Realtime client → Whiteboard events: exchanges events
