How kasfreedom/sabura-editor works
Sabura is an offline, single-file visual whiteboard. Users open a board, edit and present it with drawing tools, then save a portable copy containing its document and runtime. Its core flow runs from the browser editor through workspace interactions, validated document commands, SVG rendering, and file packaging. Separate branches provide themes and revision lineage, plus optional browser-agent automation. The graph uses documented capabilities and indexed imports; unsampled implementation details are not treated as verified calls.
Main entry points: main.js App coordinator · document.js Document schema · workspace.js Workspace gestures · svg-renderer.js SVG renderer
Components 24
Editor experience
- App coordinator
src/main.js - Workspace gestures
src/ui/workspace.js - Tool wheel
src/ui/wheel.js - Top bar
src/ui/topbar.js - Keyboard shortcuts
src/ui/shortcuts.js - Text editing
src/ui/text-editor.js - Zoom controls
src/ui/zoom-toolbar.js - Help and shortcuts
src/ui/help-modal.js - SVG renderer
src/renderer/svg-renderer.js - Presentation laser
src/renderer/laser.js
Canvas model
- Command engine
src/core/commands.js - Document schema
src/core/document.js - Geometry engine
src/core/geometry.js - Revision lineage
src/core/revision.js - Schemas and themes
src/core/types.js - Sketch paths
src/core/sketch.js - Contrast colors
src/core/color.js - Theme palettes
src/core/theme-colors.js
Portable files
- HTML file packer
src/storage/file-packer.js
Agent automation
- Versioned agent API
src/agent-api.js - WebMCP tools
src/webmcp.js
Other components
- Board user
- Browser download
- Browser agent
Connections 29
- Board user → App coordinator: opens and edits
README.md - App coordinator → Workspace gestures: coordinates
src/main.js - App coordinator → Tool wheel: coordinates
src/main.js - App coordinator → Top bar: coordinates
src/main.js - App coordinator → Keyboard shortcuts: coordinates
src/main.js - App coordinator → Text editing: coordinates
src/main.js - App coordinator → Zoom controls: coordinates
src/main.js - App coordinator → Help and shortcuts: coordinates
src/main.js - Workspace gestures → SVG renderer: renders scene
src/ui/workspace.js - Workspace gestures → Geometry engine: uses transforms
src/ui/workspace.js - Workspace gestures → Document schema: clones objects
src/ui/workspace.js - App coordinator → Command engine: dispatches edits
src/main.js - Command engine → Document schema: clones documents
src/core/commands.js - Document schema → Revision lineage: validates lineage
src/core/document.js - Document schema → Schemas and themes: uses schema
src/core/document.js - Geometry engine → Schemas and themes: uses constants
src/core/geometry.js - SVG renderer → Geometry engine: resolves connectors
src/renderer/svg-renderer.js - SVG renderer → Sketch paths: generates paths
src/renderer/svg-renderer.js - SVG renderer → Contrast colors: resolves contrast
src/renderer/svg-renderer.js - Tool wheel → Sketch paths: draws decoration
src/ui/wheel.js - Tool wheel → Theme palettes: gets palettes
src/ui/wheel.js - App coordinator → HTML file packer: packages save copy
src/main.js - HTML file packer → Document schema: validates and serializes
src/storage/file-packer.js - HTML file packer → Browser download: downloads HTML
src/storage/file-packer.js - App coordinator → Versioned agent API: exposes API
src/main.js - Versioned agent API → Command engine: dispatches batches
src/agent-api.js - App coordinator → WebMCP tools: registers tools
src/main.js - WebMCP tools → Versioned agent API: exposes capabilities
src/webmcp.js - Browser agent → Versioned agent API: uses API
README.md