How heyimjames/tela works
Tela is a local-first editor for social and ad creatives. Users start in the file library, open or create a design from a template or blank canvas, edit layers on a multi-format canvas, and export or resize the result. The editor combines interaction hooks, persisted design/workspace state, and rendering/export engines; optional AI generation and the RPC bridge extend that workflow. The README documents these capabilities, while several implementation details are unsampled, so those links are documented rather than inferred from filenames.
Main entry points: useDesignStore.ts Design document · PreviewPanel.tsx Editor canvas · useWorkspaceStore.ts Workspace frames · App.tsx Tela app
Components 22
App and library
- Tela app
src/App.tsx - File library
src/components/library/HomePage.tsx - Templates
src/brand/templates.ts
Canvas editing
- Editor canvas
src/components/layout/PreviewPanel.tsx - Canvas interaction
src/hooks/useCanvasInteraction.ts - Snap computation
src/hooks/canvas/useSnapComputation.ts - Freehand drawing
src/hooks/useDrawTool.ts - Keyboard shortcuts
src/hooks/useKeyboardShortcuts.ts
Design state and brand
- Design document
src/store/useDesignStore.ts - Workspace frames
src/store/useWorkspaceStore.ts - File persistence
src/store/useFileStore.ts - Brand system
src/brand/brand.config.ts - Layer model
src/types/design.ts
Render and export
- SVG scene
src/components/canvas/DesignSvgScene.tsx - Format reflow
src/engine/reflow.ts - Layer renderer
src/engine/layerRenderer.ts - Export compositor
src/engine/compositor.ts
Optional integrations
- AI generation
src/store/useAIStore.ts - RPC bridge
src/agent/rpc.ts
Other components
- Designer
- Configured AI endpoint
- Parent app or agent
Connections 27
- Designer → Tela app: opens
README.md - Tela app → File library: routes to
src/App.tsx - File library → Templates: offers templates
src/components/library/HomePage.tsx - Designer → Editor canvas: edits designs
README.md - Tela app → Editor canvas: mounts editor
src/App.tsx - Editor canvas → SVG scene: renders scene
src/components/layout/PreviewPanel.tsx - Editor canvas → Canvas interaction: handles gestures
src/components/layout/PreviewPanel.tsx - Canvas interaction → Snap computation: computes snapping
src/hooks/useCanvasInteraction.ts - Canvas interaction → Design document: updates selection
src/hooks/useCanvasInteraction.ts - Freehand drawing → Design document: adds strokes
src/hooks/useDrawTool.ts - Keyboard shortcuts → Design document: dispatches edits
src/hooks/useKeyboardShortcuts.ts - Keyboard shortcuts → Workspace frames: duplicates frames
src/hooks/useKeyboardShortcuts.ts - Design document → Workspace frames: syncs active frame
src/store/useDesignStore.ts - Design document → Format reflow: reflows layers
src/store/useDesignStore.ts - Workspace frames → Format reflow: reflows formats
src/store/useWorkspaceStore.ts - Design document → Layer model: uses layer types
src/store/useDesignStore.ts - Brand system → Templates: configures starter designs
src/brand/templates.ts - Design document → Layer renderer: supplies layer model
README.md - Layer renderer → Export compositor: renders bitmap
- Designer → Export compositor: exports artwork
README.md - File library → File persistence: loads and saves files
src/components/library/HomePage.tsx - Design document → File persistence: persists locally
README.md - Workspace frames → File persistence: persists locally
README.md - Editor canvas → AI generation: requests relayout
src/components/layout/PreviewPanel.tsx - AI generation → Configured AI endpoint: posts prompts
README.md - Parent app or agent → RPC bridge: dispatches commands
README.md - RPC bridge → Design document: routes commands
src/agent/rpc.ts