How leonardossm/aurora-board works
Aurora Board is a browser-based infinite whiteboard where users create and connect visual elements and functional widgets, then save, export, or share workspaces through local files. The principal workflow runs from editor controls and canvas gestures through editor actions and shared state into the board model; widgets can consume typed connections, while persistence saves changes locally. The README documents broader capabilities such as import/migration, image export, and isolated plugins. Some subsystem links below reflect README documentation because their implementation files were not sampled.
Main entry points: actions.ts Editor actions · App.tsx Application shell · Canvas.tsx Canvas view · controller.ts Gesture controller
Components 22
Editor shell
- Application shell
src/App.tsx - Editor controls
src/ui/Toolbar.tsx
Canvas interaction
- Canvas view
src/canvas/Canvas.tsx - Gesture controller
src/canvas/controller.ts - Element rendering
src/canvas/ElementView.tsx
Board model
- Editor actions
src/store/actions.ts - Editor state
src/store/editor.ts - Board schema
src/core/schema.ts - Geometry and bindings
src/core/bindings.ts - Typed dataflow
src/core/dataflow.ts
Widgets and integrations
- Widget frame
src/widgets/WidgetFrame.tsx - Widget registry
src/widgets/registry.ts - Built-in widgets
src/widgets/builtin - AI assistant
src/widgets/builtin/ai.tsx - AI client
src/integrations/aiClient.ts - Local integrations server
server/index.ts
Persistence and export
- Autosave and recovery
src/persistence/autosave.ts - IndexedDB storage
src/persistence/indexeddb.ts - Import and migration
src/persistence/exportImport.ts - Image export
src/render/exportImage.ts
Other components
- Board editor
- AI providers
Connections 22
- Board editor → Application shell: uses
src/App.tsx - Application shell → Canvas view: renders
src/App.tsx - Application shell → Editor controls: renders
src/App.tsx - Editor controls → Editor actions: dispatches
src/ui/Toolbar.tsx - Canvas view → Gesture controller: routes gestures
src/canvas/Canvas.tsx - Canvas view → Element rendering: renders elements
src/canvas/Canvas.tsx - Gesture controller → Editor actions: commits edits
src/canvas/controller.ts - Gesture controller → Geometry and bindings: resolves bindings
src/canvas/controller.ts - Editor actions → Editor state: updates
src/store/actions.ts - Editor actions → Board schema: uses element types
src/store/actions.ts - Editor actions → Autosave and recovery: persists changes
src/store/actions.ts - Widget frame → Typed dataflow: evaluates connections
src/widgets/WidgetFrame.tsx - Widget frame → Widget registry: looks up widgets
src/widgets/WidgetFrame.tsx - Built-in widgets → Widget registry: registers widgets
README.md - AI assistant → AI client: requests responses
src/widgets/builtin/ai.tsx - AI client → Local integrations server: calls local API
README.md - Local integrations server → AI providers: dispatches provider calls
server/index.ts - Autosave and recovery → IndexedDB storage: writes board data
src/persistence/autosave.ts - Board editor → Import and migration: imports JSON
README.md - Import and migration → Board schema: validates and migrates
README.md - Board editor → Image export: exports images
README.md - Image export → Widget registry: renders widget content
src/render/exportImage.ts