How nirmal-mekala/kanvy works
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: router.tsx Board routing · networkBoardLoader.ts Network board loader · App.tsx App bootstrap · Canvas.tsx Canvas view
Components 26
App and navigation
- App bootstrap
src/App.tsx - Board routing
src/router.tsx - Board page
src/components/canvas/BoardPage.tsx
Canvas interaction
- Canvas view
src/components/canvas/Canvas.tsx - Canvas interactions
src/components/canvas/useBoardInteraction.ts - Card creation
src/components/canvas/useCardCreation.ts - Clipboard actions
src/components/canvas/useClipboardShortcuts.ts - Cards and edges
src/components/card
Board domain
- Card data and media
src/cards - Canvas geometry
src/geometry - Container layout
src/containers - Board schemas
src/schema/board.ts - Board metadata
src/schema/boardMeta.ts - Node schema
src/schema/node.ts - Emoji input
src/emoji/useEmojiTrigger.ts
State and persistence
- Board state
src/state/atoms/boards.ts - Current board
src/state/atoms/currentBoard.ts - Node operations
src/state/atoms/nodes.ts - Undo and autosave
src/state/history/boardHistoryAtom.ts - Local storage
src/state/persistence/storage.ts
Network mode
- Network board loader
src/state/networkBoardLoader.ts - REST client
src/api/restClient.ts - Network writes
src/api/networkOps.ts - Network settings
src/state/atoms/networkSettings.ts
Other components
- Canvas user
- JSON REST backend
Connections 32
- Canvas user → App bootstrap: opens
README.md - App bootstrap → Board routing: renders
src/App.tsx - App bootstrap → Network board loader: attempts reconnect
src/App.tsx - App bootstrap → Network settings: reads config
src/App.tsx - Board routing → Board page: routes to
src/router.tsx - Board routing → Board state: reads boards
src/router.tsx - Board routing → Current board: sets current board
src/router.tsx - Board routing → Network board loader: loads board
src/router.tsx - Board page → Canvas view: renders
- Canvas user → Canvas view: edits canvas
README.md - Canvas view → Canvas interactions: handles interaction
- Canvas interactions → Canvas geometry: uses layout math
src/components/canvas/useBoardInteraction.ts - Canvas interactions → Container layout: creates containers
src/components/canvas/useBoardInteraction.ts - Card creation → Card data and media: builds cards
src/components/canvas/useCardCreation.ts - Card creation → Node operations: updates nodes
src/components/canvas/useCardCreation.ts - Clipboard actions → Node operations: duplicates nodes
src/components/canvas/useClipboardShortcuts.ts - Clipboard actions → Canvas geometry: positions pasted nodes
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
src/schema/board.ts - Board schemas → Board metadata: defines board entries
src/schema/board.ts - Node operations → Current board: scopes mutations
src/state/atoms/nodes.ts - Node operations → Undo and autosave: records operations
src/state/atoms/nodes.ts - Board state → Undo and autosave: uses history
src/state/atoms/boards.ts - Undo and autosave → Local storage: loads and saves
src/state/history/boardHistoryAtom.ts - Local storage → Board schemas: validates board
src/state/persistence/storage.ts - Network board loader → REST client: fetches collections
src/state/networkBoardLoader.ts - Network board loader → Network settings: reads connection config
src/state/networkBoardLoader.ts - Network board loader → JSON REST backend: loads board data
- Undo and autosave → Network writes: dispatches writes
src/state/history/boardHistoryAtom.ts - Network writes → JSON REST backend: writes entities
- JSON REST backend → Canvas user: serves network mode
README.md