# storytold/photocraft architecture

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

- Interactive diagram: https://gitdiagram.com/storytold/photocraft
- Repository: https://github.com/storytold/photocraft
- Video tour (about a minute): https://gitdiagram.com/storytold/photocraft/video

## Overview

PhotoCraft is a native Rust image editor, with CLI, web, and automation interfaces. Its main workflow is user interaction through the editor (or an automation client), command execution against an editing session, and document rendering or file output. The README documents broad editing features and shared command-driven access; the source index confirms key UI, session, automation, and platform-service modules. Some domain links below are documented rather than verified in sampled implementation, so those are marked dashed or omitted.

Main entry points: [`crates/engine/src/cmd`](https://github.com/storytold/photocraft/tree/main/crates/engine/src/cmd) (Editor commands), [`crates/ui-egui/src/app.rs`](https://github.com/storytold/photocraft/blob/main/crates/ui-egui/src/app.rs) (Editor UI), [`apps/photocraft/src/main.rs`](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/main.rs) (Desktop application), [`apps/photocraft/src/services.rs`](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/services.rs) (Native services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Product interfaces"]
  node_desktop["Desktop application<br/>[main.rs]"]
  node_editor_ui["Editor UI<br/>[app.rs]"]
  node_web_app["Web application<br/>[web.rs]"]
  node_web_presets["Web preset bridge<br/>[preset_bridge.rs]"]
  node_web_index[("Indexed presets<br/>[indexed_presets.rs]")]
  node_cli["CLI<br/>[main.rs]"]
  node_mcp["MCP server<br/>[server.rs]"]
  node_ui_state["UI state<br/>[state.rs]"]
end

subgraph group_editing["Editing and documents"]
  node_session["Editing session<br/>[session.rs]"]
  node_commands["Editor commands"]
  node_image_edits["Image editing"]
  node_composition["Layer composition"]
end

subgraph group_media["Image and file handling"]
  node_document_formats[("PSD and documents<br/>[store.rs]")]
  node_codecs["Image codecs"]
  node_color_management["Color management<br/>[pipeline.rs]"]
  node_vector_import["External SVG<br/>[external_svg.rs]"]
end

subgraph group_platform["Platform services"]
  node_native_services["Native services<br/>[services.rs]"]
  node_app_directories["App directories<br/>[app_dirs.rs]"]
  node_file_dialog_probe["File dialog probe"]
  node_linux_libraries["Linux libraries<br/>[linux_libs.rs]"]
end

node_artist(("Editor user"))
node_automation_client(("Automation client"))

node_artist -->|"edits in"| node_editor_ui
node_desktop -->|"starts"| node_editor_ui
node_editor_ui -.->|"issues commands"| node_commands
node_cli -.->|"drives commands"| node_commands
node_automation_client -.->|"requests tools"| node_mcp
node_mcp -->|"runs commands"| node_commands
node_editor_ui -->|"uses state"| node_ui_state
node_session -->|"dispatches"| node_commands
node_commands -.->|"applies edits"| node_image_edits
node_commands -.->|"renders layers"| node_composition
node_session -.->|"edits documents"| node_document_formats
node_document_formats -.->|"reads and writes images"| node_codecs
node_composition -.->|"uses profiles"| node_color_management
node_web_app -->|"uses bridge"| node_web_presets
node_web_app -->|"loads presets"| node_web_index
node_web_index -->|"references bridge"| node_web_presets
node_desktop -->|"configures services"| node_native_services
node_native_services -->|"uses directories"| node_app_directories
node_native_services -->|"probes dialogs"| node_file_dialog_probe
node_file_dialog_probe -->|"checks libraries"| node_linux_libraries
node_desktop -->|"registers support"| node_vector_import

click node_desktop "https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/main.rs"
click node_editor_ui "https://github.com/storytold/photocraft/blob/main/crates/ui-egui/src/app.rs"
click node_web_app "https://github.com/storytold/photocraft/blob/main/apps/photocraft-web/src/web.rs"
click node_web_presets "https://github.com/storytold/photocraft/blob/main/apps/photocraft-web/src/preset_bridge.rs"
click node_web_index "https://github.com/storytold/photocraft/blob/main/apps/photocraft-web/src/indexed_presets.rs"
click node_cli "https://github.com/storytold/photocraft/blob/main/apps/photocraft-cli/src/main.rs"
click node_mcp "https://github.com/storytold/photocraft/blob/main/crates/automation/src/server.rs"
click node_ui_state "https://github.com/storytold/photocraft/blob/main/crates/ui-egui/src/state.rs"
click node_session "https://github.com/storytold/photocraft/blob/main/crates/engine/src/session.rs"
click node_commands "https://github.com/storytold/photocraft/tree/main/crates/engine/src/cmd"
click node_image_edits "https://github.com/storytold/photocraft/tree/main/crates/algo/src"
click node_composition "https://github.com/storytold/photocraft/tree/main/crates/compose/src"
click node_document_formats "https://github.com/storytold/photocraft/blob/main/crates/format/src/store.rs"
click node_codecs "https://github.com/storytold/photocraft/tree/main/crates/codecs/src"
click node_color_management "https://github.com/storytold/photocraft/blob/main/crates/cms/src/pipeline.rs"
click node_vector_import "https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/external_svg.rs"
click node_native_services "https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/services.rs"
click node_app_directories "https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/app_dirs.rs"
click node_file_dialog_probe "https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/file_dialog_probe.rs"
click node_linux_libraries "https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/linux_libs.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_desktop,node_editor_ui,node_web_app,node_web_presets,node_web_index,node_cli,node_mcp,node_ui_state,node_artist,node_automation_client toneBlue
class node_session,node_commands,node_image_edits,node_composition toneAmber
class node_document_formats,node_codecs,node_color_management,node_vector_import toneMint
class node_native_services,node_app_directories,node_file_dialog_probe,node_linux_libraries toneRose
```

## Components

### Product interfaces

- [Desktop application](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/main.rs): `apps/photocraft/src/main.rs`
- [Editor UI](https://github.com/storytold/photocraft/blob/main/crates/ui-egui/src/app.rs): `crates/ui-egui/src/app.rs`
- [Web application](https://github.com/storytold/photocraft/blob/main/apps/photocraft-web/src/web.rs): `apps/photocraft-web/src/web.rs`
- [Web preset bridge](https://github.com/storytold/photocraft/blob/main/apps/photocraft-web/src/preset_bridge.rs): `apps/photocraft-web/src/preset_bridge.rs`
- [Indexed presets](https://github.com/storytold/photocraft/blob/main/apps/photocraft-web/src/indexed_presets.rs): `apps/photocraft-web/src/indexed_presets.rs`
- [CLI](https://github.com/storytold/photocraft/blob/main/apps/photocraft-cli/src/main.rs): `apps/photocraft-cli/src/main.rs`
- [MCP server](https://github.com/storytold/photocraft/blob/main/crates/automation/src/server.rs): `crates/automation/src/server.rs`
- [UI state](https://github.com/storytold/photocraft/blob/main/crates/ui-egui/src/state.rs): `crates/ui-egui/src/state.rs`

### Editing and documents

- [Editing session](https://github.com/storytold/photocraft/blob/main/crates/engine/src/session.rs): `crates/engine/src/session.rs`
- [Editor commands](https://github.com/storytold/photocraft/tree/main/crates/engine/src/cmd): `crates/engine/src/cmd`
- [Image editing](https://github.com/storytold/photocraft/tree/main/crates/algo/src): `crates/algo/src`
- [Layer composition](https://github.com/storytold/photocraft/tree/main/crates/compose/src): `crates/compose/src`

### Image and file handling

- [PSD and documents](https://github.com/storytold/photocraft/blob/main/crates/format/src/store.rs): `crates/format/src/store.rs`
- [Image codecs](https://github.com/storytold/photocraft/tree/main/crates/codecs/src): `crates/codecs/src`
- [Color management](https://github.com/storytold/photocraft/blob/main/crates/cms/src/pipeline.rs): `crates/cms/src/pipeline.rs`
- [External SVG](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/external_svg.rs): `apps/photocraft/src/external_svg.rs`

### Platform services

- [Native services](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/services.rs): `apps/photocraft/src/services.rs`
- [App directories](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/app_dirs.rs): `apps/photocraft/src/app_dirs.rs`
- [File dialog probe](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/file_dialog_probe.rs): `apps/photocraft/src/file_dialog_probe.rs`
- [Linux libraries](https://github.com/storytold/photocraft/blob/main/apps/photocraft/src/linux_libs.rs): `apps/photocraft/src/linux_libs.rs`

### Other components

- **Editor user**
- **Automation client**

## Connections

- Editor user → Editor UI: edits in (evidence: `README.md`)
- Desktop application → Editor UI: starts (evidence: `apps/photocraft/src/main.rs`)
- Editor UI → Editor commands: issues commands (evidence: `README.md`)
- CLI → Editor commands: drives commands (evidence: `README.md`)
- Automation client → MCP server: requests tools (evidence: `README.md`)
- MCP server → Editor commands: runs commands (evidence: `crates/automation/src/server.rs`)
- Editor UI → UI state: uses state (evidence: `crates/ui-egui/src/app.rs`)
- Editing session → Editor commands: dispatches (evidence: `crates/engine/src/session.rs`)
- Editor commands → Image editing: applies edits
- Editor commands → Layer composition: renders layers
- Editing session → PSD and documents: edits documents (evidence: `README.md`)
- PSD and documents → Image codecs: reads and writes images
- Layer composition → Color management: uses profiles
- Web application → Web preset bridge: uses bridge (evidence: `apps/photocraft-web/src/main.rs`)
- Web application → Indexed presets: loads presets (evidence: `apps/photocraft-web/src/main.rs`)
- Indexed presets → Web preset bridge: references bridge (evidence: `apps/photocraft-web/src/indexed_presets.rs`)
- Desktop application → Native services: configures services (evidence: `apps/photocraft/src/main.rs`)
- Native services → App directories: uses directories (evidence: `apps/photocraft/src/services.rs`)
- Native services → File dialog probe: probes dialogs (evidence: `apps/photocraft/src/services.rs`)
- File dialog probe → Linux libraries: checks libraries (evidence: `apps/photocraft/src/file_dialog_probe.rs`)
- Desktop application → External SVG: registers support (evidence: `apps/photocraft/src/main.rs`)
