# storytold/artcraft architecture

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

- Interactive diagram: https://gitdiagram.com/storytold/artcraft
- Repository: https://github.com/storytold/artcraft

## Overview

ArtCraft is a desktop creative IDE for AI image and video work. Artists can prompt directly or refine compositions with 2D canvases, 3D scenes, and a video timeline; generated media can then be reviewed in the feed and library. The sampled native app owns UI requests and initializes the asynchronous API backend, which submits generation and reports events back. The README documents additional creative tools whose implementation links were not sampled, so those branches are shown as capabilities without speculative call edges.

Main entry points: [`artcraft-native/src/app.rs`](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/app.rs) (Native app), [`artcraft-native/src/backend/mod.rs`](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/mod.rs) (API backend), [`artcraft-native/src/prompt_box/editor.rs`](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/prompt_box/editor.rs) (Prompt editor), [`artcraft-native/src/backend/media_cache.rs`](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/media_cache.rs) (Media cache)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creative["Creative tools"]
  node_prompt["Prompt editor<br/>[editor.rs]"]
  node_references["Prompt references<br/>[refs.rs]"]
  node_image["Image creation<br/>[create_image.rs]"]
  node_video["Video creation<br/>[create_video.rs]"]
  node_audio["Audio creation<br/>[create_audio.rs]"]
  node_canvas2d["2D compositing"]
  node_scene3d["3D scene tools"]
  node_timeline["Video timeline"]
  node_characters["Characters<br/>[characters.rs]"]
end

subgraph group_generation["Generation workflow"]
  node_backend["API backend<br/>[mod.rs]"]
  node_provider["Provider jobs<br/>[submit.rs]"]
  node_api["ArtCraft API"]
end

subgraph group_results["Results and library"]
  node_feed["Generation feed<br/>[grid.rs]"]
  node_feedstore[("Feed state<br/>[store.rs]")]
  node_media[("Media cache<br/>[media_cache.rs]")]
  node_library["Media library<br/>[library_picker.rs]"]
  node_lightbox["Media preview<br/>[lightbox.rs]"]
end

subgraph group_platform["Application platform"]
  node_app["Native app<br/>[app.rs]"]
  node_shell["App shell<br/>[shell.rs]"]
end

node_artist(("Artist"))
node_service["ArtCraft service"]

node_artist -->|"uses"| node_app
node_app -->|"renders"| node_shell
node_app -->|"initializes"| node_backend
node_app -->|"renders"| node_feed
node_app -->|"uses"| node_feedstore
node_app -->|"opens"| node_library
node_app -->|"opens"| node_lightbox
node_app -->|"reads"| node_media
node_app -->|"routes requests"| node_characters
node_artist -->|"enters prompt"| node_prompt
node_prompt -.->|"attaches references"| node_references
node_artist -->|"creates images"| node_image
node_artist -->|"creates videos"| node_video
node_artist -.->|"creates audio"| node_audio
node_artist -->|"composes"| node_canvas2d
node_artist -->|"stages scenes"| node_scene3d
node_artist -.->|"edits video"| node_timeline
node_artist -.->|"creates characters"| node_characters
node_prompt -.->|"submits generation"| node_backend
node_image -.->|"requests generation"| node_backend
node_video -.->|"requests generation"| node_backend
node_audio -.->|"requests generation"| node_backend
node_backend -->|"calls API"| node_service
node_backend -.->|"dispatches jobs"| node_provider
node_backend -.->|"uses request shapes"| node_api
node_feed -.->|"reads state"| node_feedstore
node_library -.->|"loads media"| node_media
node_lightbox -->|"loads preview"| node_media

click node_app "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/app.rs"
click node_shell "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/shell.rs"
click node_prompt "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/prompt_box/editor.rs"
click node_references "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/prompt_box/refs.rs"
click node_image "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/pages/create_image.rs"
click node_video "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/pages/create_video.rs"
click node_audio "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/pages/create_audio.rs"
click node_canvas2d "https://github.com/storytold/artcraft/tree/main/frontend/libs/components/moodboard/src/lib/canvas"
click node_scene3d "https://github.com/storytold/artcraft/tree/main/frontend/libs/components/pagescene/src/lib"
click node_timeline "https://github.com/storytold/artcraft/tree/main/frontend/libs/components/video-editor/src/lib/timeline"
click node_backend "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/mod.rs"
click node_provider "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/providers/submit.rs"
click node_api "https://github.com/storytold/artcraft/tree/main/crates/api_clients/artcraft/artcraft_api_defs/src/omni_gen/cost_and_generate_requests"
click node_feed "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/feed/grid.rs"
click node_feedstore "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/feed/store.rs"
click node_media "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/media_cache.rs"
click node_library "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/overlays/library_picker.rs"
click node_lightbox "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/overlays/lightbox.rs"
click node_characters "https://github.com/storytold/artcraft/blob/main/artcraft-native/src/overlays/characters.rs"

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_prompt,node_references,node_image,node_video,node_audio,node_canvas2d,node_scene3d,node_timeline,node_characters toneBlue
class node_backend,node_provider,node_api toneAmber
class node_feed,node_feedstore,node_media,node_library,node_lightbox toneMint
class node_app,node_shell toneRose
class node_artist,node_service toneIndigo
```

## Components

### Creative tools

- [Prompt editor](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/prompt_box/editor.rs): `artcraft-native/src/prompt_box/editor.rs`
- [Prompt references](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/prompt_box/refs.rs): `artcraft-native/src/prompt_box/refs.rs`
- [Image creation](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/pages/create_image.rs): `artcraft-native/src/pages/create_image.rs`
- [Video creation](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/pages/create_video.rs): `artcraft-native/src/pages/create_video.rs`
- [Audio creation](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/pages/create_audio.rs): `artcraft-native/src/pages/create_audio.rs`
- [2D compositing](https://github.com/storytold/artcraft/tree/main/frontend/libs/components/moodboard/src/lib/canvas): `frontend/libs/components/moodboard/src/lib/canvas`
- [3D scene tools](https://github.com/storytold/artcraft/tree/main/frontend/libs/components/pagescene/src/lib): `frontend/libs/components/pagescene/src/lib`
- [Video timeline](https://github.com/storytold/artcraft/tree/main/frontend/libs/components/video-editor/src/lib/timeline): `frontend/libs/components/video-editor/src/lib/timeline`
- [Characters](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/overlays/characters.rs): `artcraft-native/src/overlays/characters.rs`

### Generation workflow

- [API backend](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/mod.rs): `artcraft-native/src/backend/mod.rs`
- [Provider jobs](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/providers/submit.rs): `artcraft-native/src/backend/providers/submit.rs`
- [ArtCraft API](https://github.com/storytold/artcraft/tree/main/crates/api_clients/artcraft/artcraft_api_defs/src/omni_gen/cost_and_generate_requests): `crates/api_clients/artcraft/artcraft_api_defs/src/omni_gen/cost_and_generate_requests`

### Results and library

- [Generation feed](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/feed/grid.rs): `artcraft-native/src/feed/grid.rs`
- [Feed state](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/feed/store.rs): `artcraft-native/src/feed/store.rs`
- [Media cache](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/backend/media_cache.rs): `artcraft-native/src/backend/media_cache.rs`
- [Media library](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/overlays/library_picker.rs): `artcraft-native/src/overlays/library_picker.rs`
- [Media preview](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/overlays/lightbox.rs): `artcraft-native/src/overlays/lightbox.rs`

### Application platform

- [Native app](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/app.rs): `artcraft-native/src/app.rs`
- [App shell](https://github.com/storytold/artcraft/blob/main/artcraft-native/src/shell.rs): `artcraft-native/src/shell.rs`

### Other components

- **Artist**
- **ArtCraft service**

## Connections

- Artist → Native app: uses (evidence: `README.md`)
- Native app → App shell: renders (evidence: `artcraft-native/src/app.rs`)
- Native app → API backend: initializes (evidence: `artcraft-native/src/app.rs`)
- Native app → Generation feed: renders (evidence: `artcraft-native/src/app.rs`)
- Native app → Feed state: uses (evidence: `artcraft-native/src/app.rs`)
- Native app → Media library: opens (evidence: `artcraft-native/src/app.rs`)
- Native app → Media preview: opens (evidence: `artcraft-native/src/app.rs`)
- Native app → Media cache: reads (evidence: `artcraft-native/src/app.rs`)
- Native app → Characters: routes requests (evidence: `artcraft-native/src/app.rs`)
- Artist → Prompt editor: enters prompt (evidence: `README.md`)
- Prompt editor → Prompt references: attaches references
- Artist → Image creation: creates images (evidence: `README.md`)
- Artist → Video creation: creates videos (evidence: `README.md`)
- Artist → Audio creation: creates audio
- Artist → 2D compositing: composes (evidence: `README.md`)
- Artist → 3D scene tools: stages scenes (evidence: `README.md`)
- Artist → Video timeline: edits video (evidence: `README.md`)
- Artist → Characters: creates characters
- Prompt editor → API backend: submits generation
- Image creation → API backend: requests generation
- Video creation → API backend: requests generation
- Audio creation → API backend: requests generation
- API backend → ArtCraft service: calls API (evidence: `artcraft-native/src/backend/mod.rs`)
- API backend → Provider jobs: dispatches jobs
- API backend → ArtCraft API: uses request shapes
- Generation feed → Feed state: reads state
- Media library → Media cache: loads media
- Media preview → Media cache: loads preview (evidence: `artcraft-native/src/app.rs`)
