How nelay04/meadow works
Meadow is a collaborative infinite-canvas workspace for drawing, writing, organizing, and sharing glades, with leas as a ruled-page board kind. Users sign in or follow a share link, open a board, edit its shared document, and see collaborators’ updates; they can also manage access, accounts, and preferences. The map includes the web canvas, shared document model, API and realtime persistence, plus the MCP assistant interface. Many subsystem links are documented in the README; unsampled implementation details are not treated as inspected.
Main entry points: App.tsx App routing · engine.ts Canvas engine · main.py API application · useCanvas.ts Canvas host
Components 22
Web app
- App routing
apps/web/src/App.tsx - Sign-in and account
apps/web/src/features/auth - Board workspace
apps/web/src/features/board - Board discovery
apps/web/src/features/boards - Profile settings
apps/web/src/features/profile - Web API client
apps/web/src/lib/api.ts
Canvas and document
- Canvas host
apps/web/src/features/board/useCanvas.ts - Canvas engine
apps/web/src/canvas/engine.ts - Canvas rendering
apps/web/src/canvas/renderers - Canvas tools
apps/web/src/canvas/tools - Text and language input
apps/web/src/text - Shared document model
packages/schema/src/objects.ts
API and identity
- API application
services/api/app/main.py - Authentication routes
services/api/app/api/v1/auth.py - Boards and sharing
services/api/app/api/v1 - Access permissions
services/api/app/services/permissions.py - Persistent models
services/api/app/models.py
Realtime collaboration
- Sync provider
apps/web/src/sync/provider.ts - Realtime room server
services/api/app/realtime/server.py
Assistant integration
- MCP tools
packages/mcp/src/server.ts - MCP board sessions
packages/mcp/src/room.ts
Other components
- Board user
Connections 26
- Board user → App routing: opens
- App routing → Sign-in and account: routes to
apps/web/src/App.tsx - App routing → Board workspace: routes to
apps/web/src/App.tsx - App routing → Board discovery: routes to
apps/web/src/App.tsx - App routing → Profile settings: routes to
apps/web/src/App.tsx - Sign-in and account → Web API client: requests
apps/web/src/features/auth/AuthContext.tsx - Board workspace → Canvas host: hosts
apps/web/src/features/board/useCanvas.ts - Canvas host → Canvas engine: creates
apps/web/src/features/board/useCanvas.ts - Canvas engine → Canvas rendering: renders with
apps/web/src/canvas/engine.ts - Canvas engine → Canvas tools: dispatches tools
apps/web/src/canvas/engine.ts - Canvas host → Sync provider: syncs document
- Canvas engine → Shared document model: reads objects
apps/web/src/canvas/engine.ts - Canvas tools → Shared document model: edits objects
- Text and language input → Canvas host: supplies text
- Board user → Web API client: requests services
- Web API client → API application: calls REST API
- API application → Authentication routes: mounts routes
services/api/app/main.py - API application → Boards and sharing: mounts routes
services/api/app/main.py - Authentication routes → Persistent models: reads and writes
services/api/app/api/v1/auth.py - Boards and sharing → Access permissions: checks access
- API application → Realtime room server: serves rooms
services/api/app/main.py - Realtime room server → Persistent models: persists board state
services/api/app/realtime/server.py - Sync provider → Realtime room server: exchanges updates
- MCP tools → MCP board sessions: opens sessions
packages/mcp/src/server.ts - Board user → MCP tools: uses assistant
- MCP tools → Shared document model: reads and plans edits
packages/mcp/src/server.ts