# tigerowo/infinite-canvas architecture

> Architecture diagram of the GitHub repository tigerowo/infinite-canvas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tigerowo/infinite-canvas
- Repository: https://github.com/tigerowo/infinite-canvas

## Overview

Infinite Canvas is an AI-powered creative workspace for composing and iterating on image, video, and audio projects. The principal workflow starts in the infinite canvas: users arrange connected nodes, invoke generation or editing, and bring results back into the project for further iteration. Separate workbenches expose image and video creation; workflows, prompts, assets, and the canvas agent support reuse and automation. The Go backend routes API requests through handlers and services to persistence or external providers. Relationships for unsampled features are based on README descriptions; source excerpts show selected canvas, storage, and routing links.

Main entry points: [`router/router.go`](https://github.com/tigerowo/infinite-canvas/blob/main/router/router.go) (API routing), [`web/src/app/(user)/canvas/[id]/canvas-client-page.tsx`](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/%5Bid%5D/canvas-client-page.tsx) (Canvas workspace), [`service/storage.go`](https://github.com/tigerowo/infinite-canvas/blob/main/service/storage.go) (Storage service), [`web/src/app/(user)/canvas/agent/canvas-agent-runtime.ts`](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/agent/canvas-agent-runtime.ts) (Canvas agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_canvas["Canvas creation"]
  node_canvas_ui["Canvas workspace"]
  node_canvas_generation["Node generation"]
  node_canvas_agent["Canvas agent"]
  node_agent_tools["Agent tools"]
  node_director["3D director"]
  node_panorama["Panorama tools<br/>[canvas-panorama.ts]"]
end

subgraph group_workbenches["Creation workbenches"]
  node_image_workbench["Image workbench<br/>[page.tsx]"]
  node_video_workbench["Video workbench<br/>[page.tsx]"]
  node_workflow_editor["Workflow editor"]
  node_prompt_library["Prompt library<br/>[page.tsx]"]
  node_asset_library["Asset library<br/>[page.tsx]"]
end

subgraph group_backend["Backend capabilities"]
  node_api_router{{"API routing<br/>[router.go]"}}
  node_ai_handlers["AI handlers<br/>[ai.go]"]
  node_canvas_handlers["Canvas task handlers<br/>[canvas_task.go]"]
  node_workflow_services["Workflow services<br/>[workflow.go]"]
  node_provider_adapters["Model integrations<br/>[model_protocol.go]"]
  node_storage_handler["Storage handlers<br/>[storage.go]"]
end

subgraph group_platform["Persistence and integrations"]
  node_storage_service["Storage service<br/>[storage.go]"]
  node_storage_db[("Object metadata<br/>[storage.go]")]
  node_media_storage["Media storage<br/>[image-storage.ts]"]
end

node_creator(("Creator"))
node_models{{"AI model providers"}}
node_object_provider[("Object storage providers")]

node_creator -->|"arranges nodes"| node_canvas_ui
node_creator -->|"creates images"| node_image_workbench
node_creator -->|"creates videos"| node_video_workbench
node_canvas_ui -.->|"starts generation"| node_canvas_generation
node_canvas_ui -->|"opens assistant"| node_canvas_agent
node_canvas_agent -.->|"uses tools"| node_agent_tools
node_creator -->|"stages scenes"| node_director
node_director -->|"sends camera images"| node_canvas_ui
node_creator -->|"imports panoramas"| node_panorama
node_canvas_ui -->|"uploads media"| node_media_storage
node_image_workbench -.->|"requests generation"| node_api_router
node_video_workbench -.->|"requests generation"| node_api_router
node_creator -->|"builds workflows"| node_workflow_editor
node_creator -->|"selects prompts"| node_prompt_library
node_creator -->|"reuses assets"| node_asset_library
node_api_router -->|"routes requests"| node_ai_handlers
node_api_router -->|"routes tasks"| node_canvas_handlers
node_api_router -->|"routes files"| node_storage_handler
node_workflow_editor -.->|"executes workflows"| node_workflow_services
node_ai_handlers -.->|"dispatches requests"| node_provider_adapters
node_provider_adapters -.->|"calls models"| node_models
node_canvas_handlers -.->|"uses workflows"| node_workflow_services
node_storage_handler -->|"delegates storage"| node_storage_service
node_storage_service -.->|"persists metadata"| node_storage_db
node_storage_service -.->|"reads and writes"| node_object_provider
node_media_storage -.->|"uploads files"| node_api_router

click node_canvas_ui "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/%5Bid%5D/canvas-client-page.tsx"
click node_canvas_generation "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/components/canvas-node-generation.ts"
click node_canvas_agent "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/agent/canvas-agent-runtime.ts"
click node_agent_tools "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/agent/canvas-agent-tools.ts"
click node_director "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/components/canvas-director.tsx"
click node_panorama "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/utils/canvas-panorama.ts"
click node_image_workbench "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/image/page.tsx"
click node_video_workbench "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/video/page.tsx"
click node_workflow_editor "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/components/workflows/creative-workflow-workspace.tsx"
click node_prompt_library "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/prompts/page.tsx"
click node_asset_library "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/asset-library/page.tsx"
click node_api_router "https://github.com/tigerowo/infinite-canvas/blob/main/router/router.go"
click node_ai_handlers "https://github.com/tigerowo/infinite-canvas/blob/main/handler/ai.go"
click node_canvas_handlers "https://github.com/tigerowo/infinite-canvas/blob/main/handler/canvas_task.go"
click node_workflow_services "https://github.com/tigerowo/infinite-canvas/blob/main/service/workflow.go"
click node_provider_adapters "https://github.com/tigerowo/infinite-canvas/blob/main/handler/model_protocol.go"
click node_storage_service "https://github.com/tigerowo/infinite-canvas/blob/main/service/storage.go"
click node_storage_handler "https://github.com/tigerowo/infinite-canvas/blob/main/handler/storage.go"
click node_storage_db "https://github.com/tigerowo/infinite-canvas/blob/main/repository/storage.go"
click node_media_storage "https://github.com/tigerowo/infinite-canvas/blob/main/web/src/services/image-storage.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_canvas_ui,node_canvas_generation,node_canvas_agent,node_agent_tools,node_director,node_panorama toneBlue
class node_image_workbench,node_video_workbench,node_workflow_editor,node_prompt_library,node_asset_library,node_object_provider toneAmber
class node_api_router,node_ai_handlers,node_canvas_handlers,node_workflow_services,node_provider_adapters,node_storage_handler toneMint
class node_storage_service,node_storage_db,node_media_storage toneRose
class node_creator,node_models toneIndigo
```

## Components

### Canvas creation

- [Canvas workspace](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/%5Bid%5D/canvas-client-page.tsx): `web/src/app/(user)/canvas/[id]/canvas-client-page.tsx`
- [Node generation](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/components/canvas-node-generation.ts): `web/src/app/(user)/canvas/components/canvas-node-generation.ts`
- [Canvas agent](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/agent/canvas-agent-runtime.ts): `web/src/app/(user)/canvas/agent/canvas-agent-runtime.ts`
- [Agent tools](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/agent/canvas-agent-tools.ts): `web/src/app/(user)/canvas/agent/canvas-agent-tools.ts`
- [3D director](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/components/canvas-director.tsx): `web/src/app/(user)/canvas/components/canvas-director.tsx`
- [Panorama tools](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/canvas/utils/canvas-panorama.ts): `web/src/app/(user)/canvas/utils/canvas-panorama.ts`

### Creation workbenches

- [Image workbench](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/image/page.tsx): `web/src/app/(user)/image/page.tsx`
- [Video workbench](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/video/page.tsx): `web/src/app/(user)/video/page.tsx`
- [Workflow editor](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/components/workflows/creative-workflow-workspace.tsx): `web/src/components/workflows/creative-workflow-workspace.tsx`
- [Prompt library](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/prompts/page.tsx): `web/src/app/(user)/prompts/page.tsx`
- [Asset library](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/app/(user)/asset-library/page.tsx): `web/src/app/(user)/asset-library/page.tsx`

### Backend capabilities

- [API routing](https://github.com/tigerowo/infinite-canvas/blob/main/router/router.go): `router/router.go`
- [AI handlers](https://github.com/tigerowo/infinite-canvas/blob/main/handler/ai.go): `handler/ai.go`
- [Canvas task handlers](https://github.com/tigerowo/infinite-canvas/blob/main/handler/canvas_task.go): `handler/canvas_task.go`
- [Workflow services](https://github.com/tigerowo/infinite-canvas/blob/main/service/workflow.go): `service/workflow.go`
- [Model integrations](https://github.com/tigerowo/infinite-canvas/blob/main/handler/model_protocol.go): `handler/model_protocol.go`
- [Storage handlers](https://github.com/tigerowo/infinite-canvas/blob/main/handler/storage.go): `handler/storage.go`

### Persistence and integrations

- [Storage service](https://github.com/tigerowo/infinite-canvas/blob/main/service/storage.go): `service/storage.go`
- [Object metadata](https://github.com/tigerowo/infinite-canvas/blob/main/repository/storage.go): `repository/storage.go`
- [Media storage](https://github.com/tigerowo/infinite-canvas/blob/main/web/src/services/image-storage.ts): `web/src/services/image-storage.ts`

### Other components

- **Creator**
- **AI model providers**
- **Object storage providers**

## Connections

- Creator → Canvas workspace: arranges nodes (evidence: `README.md`)
- Creator → Image workbench: creates images (evidence: `README.md`)
- Creator → Video workbench: creates videos (evidence: `README.md`)
- Canvas workspace → Node generation: starts generation (evidence: `web/src/app/(user)/canvas/[id]/canvas-client-page.tsx`)
- Canvas workspace → Canvas agent: opens assistant
- Canvas agent → Agent tools: uses tools
- Creator → 3D director: stages scenes (evidence: `README.md`)
- 3D director → Canvas workspace: sends camera images (evidence: `README.md`)
- Creator → Panorama tools: imports panoramas (evidence: `README.md`)
- Canvas workspace → Media storage: uploads media (evidence: `web/src/app/(user)/canvas/[id]/canvas-client-page.tsx`)
- Image workbench → API routing: requests generation
- Video workbench → API routing: requests generation
- Creator → Workflow editor: builds workflows (evidence: `README.md`)
- Creator → Prompt library: selects prompts (evidence: `README.md`)
- Creator → Asset library: reuses assets (evidence: `README.md`)
- API routing → AI handlers: routes requests (evidence: `router/router.go`)
- API routing → Canvas task handlers: routes tasks (evidence: `router/router.go`)
- API routing → Storage handlers: routes files (evidence: `router/router.go`)
- Workflow editor → Workflow services: executes workflows
- AI handlers → Model integrations: dispatches requests
- Model integrations → AI model providers: calls models
- Canvas task handlers → Workflow services: uses workflows
- Storage handlers → Storage service: delegates storage (evidence: `handler/storage.go`)
- Storage service → Object metadata: persists metadata
- Storage service → Object storage providers: reads and writes
- Media storage → API routing: uploads files
