# nirmal-mekala/kanvy architecture

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

## Overview

Kanvy is a local-first infinite-canvas app. Users open or choose a board, create and edit cards, arrange and connect canvas items, then rely on undoable state and autosave; Network mode loads and writes board data through a REST backend. The graph includes documented multiboard, clipboard, media/link-card, styling, and emoji capabilities. Some subsystem files were not excerpted, so their nodes are included where the tree and README support them; edges are limited to relationships shown in excerpts, the source index, or README.

Main entry points: [`src/router.tsx`](https://github.com/nirmal-mekala/kanvy/blob/main/src/router.tsx) (Board routing), [`src/state/networkBoardLoader.ts`](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/networkBoardLoader.ts) (Network board loader), [`src/App.tsx`](https://github.com/nirmal-mekala/kanvy/blob/main/src/App.tsx) (App bootstrap), [`src/components/canvas/Canvas.tsx`](https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/Canvas.tsx) (Canvas view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_app["App bootstrap<br/>[App.tsx]"]
  node_router["Board routing<br/>[router.tsx]"]
  node_boardpage["Board page<br/>[BoardPage.tsx]"]
end

subgraph group_canvas["Canvas interaction"]
  node_canvas["Canvas view<br/>[Canvas.tsx]"]
  node_interactions["Canvas interactions"]
  node_creation["Card creation<br/>[useCardCreation.ts]"]
  node_clipboard["Clipboard actions"]
  node_rendering["Cards and edges"]
end

subgraph group_domain["Board domain"]
  node_cards["Card data and media"]
  node_geometry["Canvas geometry"]
  node_containers["Container layout"]
  node_schema["Board schemas<br/>[board.ts]"]
  node_boardmeta["Board metadata<br/>[boardMeta.ts]"]
  node_nodeschema["Node schema<br/>[node.ts]"]
  node_emoji["Emoji input<br/>[useEmojiTrigger.ts]"]
end

subgraph group_state["State and persistence"]
  node_boardstate["Board state<br/>[boards.ts]"]
  node_currentboard["Current board<br/>[currentBoard.ts]"]
  node_nodestate["Node operations<br/>[nodes.ts]"]
  node_history["Undo and autosave"]
  node_localstorage[("Local storage<br/>[storage.ts]")]
end

subgraph group_network["Network mode"]
  node_networkloader["Network board loader"]
  node_rest["REST client<br/>[restClient.ts]"]
  node_networkops["Network writes<br/>[networkOps.ts]"]
  node_settings["Network settings<br/>[networkSettings.ts]"]
end

node_user(("Canvas user"))
node_backend[("JSON REST backend")]

node_user -->|"opens"| node_app
node_app -->|"renders"| node_router
node_app -->|"attempts reconnect"| node_networkloader
node_app -->|"reads config"| node_settings
node_router -->|"routes to"| node_boardpage
node_router -->|"reads boards"| node_boardstate
node_router -->|"sets current board"| node_currentboard
node_router -->|"loads board"| node_networkloader
node_boardpage -.->|"renders"| node_canvas
node_user -->|"edits canvas"| node_canvas
node_canvas -.->|"handles interaction"| node_interactions
node_interactions -->|"uses layout math"| node_geometry
node_interactions -->|"creates containers"| node_containers
node_creation -->|"builds cards"| node_cards
node_creation -->|"updates nodes"| node_nodestate
node_clipboard -->|"duplicates nodes"| node_nodestate
node_clipboard -->|"positions pasted nodes"| node_geometry
node_canvas -.->|"displays items"| node_rendering
node_rendering -.->|"supports emoji input"| node_emoji
node_schema -->|"defines node entries"| node_nodeschema
node_schema -->|"defines board entries"| node_boardmeta
node_nodestate -->|"scopes mutations"| node_currentboard
node_nodestate -->|"records operations"| node_history
node_boardstate -->|"uses history"| node_history
node_history -->|"loads and saves"| node_localstorage
node_localstorage -->|"validates board"| node_schema
node_networkloader -->|"fetches collections"| node_rest
node_networkloader -->|"reads connection config"| node_settings
node_networkloader -.->|"loads board data"| node_backend
node_history -->|"dispatches writes"| node_networkops
node_networkops -.->|"writes entities"| node_backend
node_backend -.->|"serves network mode"| node_user

click node_app "https://github.com/nirmal-mekala/kanvy/blob/main/src/App.tsx"
click node_router "https://github.com/nirmal-mekala/kanvy/blob/main/src/router.tsx"
click node_boardpage "https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/BoardPage.tsx"
click node_canvas "https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/Canvas.tsx"
click node_interactions "https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/useBoardInteraction.ts"
click node_creation "https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/useCardCreation.ts"
click node_cards "https://github.com/nirmal-mekala/kanvy/tree/main/src/cards"
click node_clipboard "https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/useClipboardShortcuts.ts"
click node_geometry "https://github.com/nirmal-mekala/kanvy/tree/main/src/geometry"
click node_containers "https://github.com/nirmal-mekala/kanvy/tree/main/src/containers"
click node_rendering "https://github.com/nirmal-mekala/kanvy/tree/main/src/components/card"
click node_schema "https://github.com/nirmal-mekala/kanvy/blob/main/src/schema/board.ts"
click node_boardmeta "https://github.com/nirmal-mekala/kanvy/blob/main/src/schema/boardMeta.ts"
click node_nodeschema "https://github.com/nirmal-mekala/kanvy/blob/main/src/schema/node.ts"
click node_boardstate "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/boards.ts"
click node_currentboard "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/currentBoard.ts"
click node_nodestate "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/nodes.ts"
click node_history "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/history/boardHistoryAtom.ts"
click node_localstorage "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/persistence/storage.ts"
click node_networkloader "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/networkBoardLoader.ts"
click node_rest "https://github.com/nirmal-mekala/kanvy/blob/main/src/api/restClient.ts"
click node_networkops "https://github.com/nirmal-mekala/kanvy/blob/main/src/api/networkOps.ts"
click node_emoji "https://github.com/nirmal-mekala/kanvy/blob/main/src/emoji/useEmojiTrigger.ts"
click node_settings "https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/networkSettings.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_app,node_router,node_boardpage,node_user toneBlue
class node_canvas,node_interactions,node_creation,node_clipboard,node_rendering,node_backend toneAmber
class node_cards,node_geometry,node_containers,node_schema,node_boardmeta,node_nodeschema,node_emoji toneMint
class node_boardstate,node_currentboard,node_nodestate,node_history,node_localstorage toneRose
class node_networkloader,node_rest,node_networkops,node_settings toneIndigo
```

## Components

### App and navigation

- [App bootstrap](https://github.com/nirmal-mekala/kanvy/blob/main/src/App.tsx): `src/App.tsx`
- [Board routing](https://github.com/nirmal-mekala/kanvy/blob/main/src/router.tsx): `src/router.tsx`
- [Board page](https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/BoardPage.tsx): `src/components/canvas/BoardPage.tsx`

### Canvas interaction

- [Canvas view](https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/Canvas.tsx): `src/components/canvas/Canvas.tsx`
- [Canvas interactions](https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/useBoardInteraction.ts): `src/components/canvas/useBoardInteraction.ts`
- [Card creation](https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/useCardCreation.ts): `src/components/canvas/useCardCreation.ts`
- [Clipboard actions](https://github.com/nirmal-mekala/kanvy/blob/main/src/components/canvas/useClipboardShortcuts.ts): `src/components/canvas/useClipboardShortcuts.ts`
- [Cards and edges](https://github.com/nirmal-mekala/kanvy/tree/main/src/components/card): `src/components/card`

### Board domain

- [Card data and media](https://github.com/nirmal-mekala/kanvy/tree/main/src/cards): `src/cards`
- [Canvas geometry](https://github.com/nirmal-mekala/kanvy/tree/main/src/geometry): `src/geometry`
- [Container layout](https://github.com/nirmal-mekala/kanvy/tree/main/src/containers): `src/containers`
- [Board schemas](https://github.com/nirmal-mekala/kanvy/blob/main/src/schema/board.ts): `src/schema/board.ts`
- [Board metadata](https://github.com/nirmal-mekala/kanvy/blob/main/src/schema/boardMeta.ts): `src/schema/boardMeta.ts`
- [Node schema](https://github.com/nirmal-mekala/kanvy/blob/main/src/schema/node.ts): `src/schema/node.ts`
- [Emoji input](https://github.com/nirmal-mekala/kanvy/blob/main/src/emoji/useEmojiTrigger.ts): `src/emoji/useEmojiTrigger.ts`

### State and persistence

- [Board state](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/boards.ts): `src/state/atoms/boards.ts`
- [Current board](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/currentBoard.ts): `src/state/atoms/currentBoard.ts`
- [Node operations](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/nodes.ts): `src/state/atoms/nodes.ts`
- [Undo and autosave](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/history/boardHistoryAtom.ts): `src/state/history/boardHistoryAtom.ts`
- [Local storage](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/persistence/storage.ts): `src/state/persistence/storage.ts`

### Network mode

- [Network board loader](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/networkBoardLoader.ts): `src/state/networkBoardLoader.ts`
- [REST client](https://github.com/nirmal-mekala/kanvy/blob/main/src/api/restClient.ts): `src/api/restClient.ts`
- [Network writes](https://github.com/nirmal-mekala/kanvy/blob/main/src/api/networkOps.ts): `src/api/networkOps.ts`
- [Network settings](https://github.com/nirmal-mekala/kanvy/blob/main/src/state/atoms/networkSettings.ts): `src/state/atoms/networkSettings.ts`

### Other components

- **Canvas user**
- **JSON REST backend**

## Connections

- Canvas user → App bootstrap: opens (evidence: `README.md`)
- App bootstrap → Board routing: renders (evidence: `src/App.tsx`)
- App bootstrap → Network board loader: attempts reconnect (evidence: `src/App.tsx`)
- App bootstrap → Network settings: reads config (evidence: `src/App.tsx`)
- Board routing → Board page: routes to (evidence: `src/router.tsx`)
- Board routing → Board state: reads boards (evidence: `src/router.tsx`)
- Board routing → Current board: sets current board (evidence: `src/router.tsx`)
- Board routing → Network board loader: loads board (evidence: `src/router.tsx`)
- Board page → Canvas view: renders
- Canvas user → Canvas view: edits canvas (evidence: `README.md`)
- Canvas view → Canvas interactions: handles interaction
- Canvas interactions → Canvas geometry: uses layout math (evidence: `src/components/canvas/useBoardInteraction.ts`)
- Canvas interactions → Container layout: creates containers (evidence: `src/components/canvas/useBoardInteraction.ts`)
- Card creation → Card data and media: builds cards (evidence: `src/components/canvas/useCardCreation.ts`)
- Card creation → Node operations: updates nodes (evidence: `src/components/canvas/useCardCreation.ts`)
- Clipboard actions → Node operations: duplicates nodes (evidence: `src/components/canvas/useClipboardShortcuts.ts`)
- Clipboard actions → Canvas geometry: positions pasted nodes (evidence: `src/components/canvas/useClipboardShortcuts.ts`)
- Canvas view → Cards and edges: displays items
- Cards and edges → Emoji input: supports emoji input
- Board schemas → Node schema: defines node entries (evidence: `src/schema/board.ts`)
- Board schemas → Board metadata: defines board entries (evidence: `src/schema/board.ts`)
- Node operations → Current board: scopes mutations (evidence: `src/state/atoms/nodes.ts`)
- Node operations → Undo and autosave: records operations (evidence: `src/state/atoms/nodes.ts`)
- Board state → Undo and autosave: uses history (evidence: `src/state/atoms/boards.ts`)
- Undo and autosave → Local storage: loads and saves (evidence: `src/state/history/boardHistoryAtom.ts`)
- Local storage → Board schemas: validates board (evidence: `src/state/persistence/storage.ts`)
- Network board loader → REST client: fetches collections (evidence: `src/state/networkBoardLoader.ts`)
- Network board loader → Network settings: reads connection config (evidence: `src/state/networkBoardLoader.ts`)
- Network board loader → JSON REST backend: loads board data
- Undo and autosave → Network writes: dispatches writes (evidence: `src/state/history/boardHistoryAtom.ts`)
- Network writes → JSON REST backend: writes entities
- JSON REST backend → Canvas user: serves network mode (evidence: `README.md`)
