# storytold/designcraft architecture

> Architecture diagram of the GitHub repository storytold/designcraft, 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/storytold/designcraft
- Repository: https://github.com/storytold/designcraft

## Overview

DesignCraft is a Rust page-layout and publishing application for desktop and browser, with headless and agent-driven entry points. Users create or open a document, edit pages and content through the UI or commands, compose and render spreads, then save or export formats such as IDML and PDF. The engine is the command/session boundary shared by these routes; text composition and rendering are distinct stages. The graph preserves documented format, color, and MCP capabilities. Some links are README-documented or inferred from architecture because their implementation excerpts were not provided.

Main entry points: [`crates/engine/src/lib.rs`](https://github.com/storytold/designcraft/blob/main/crates/engine/src/lib.rs) (Session commands), [`crates/ui-egui/src/canvas.rs`](https://github.com/storytold/designcraft/blob/main/crates/ui-egui/src/canvas.rs) (Editor UI), [`crates/compose/src/lib.rs`](https://github.com/storytold/designcraft/blob/main/crates/compose/src/lib.rs) (Text composition), [`crates/doc`](https://github.com/storytold/designcraft/tree/main/crates/doc) (Document model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_desktop["Desktop app<br/>[main.rs]"]
  node_web["Browser app<br/>[main.rs]"]
  node_webshell["Web file shell<br/>[web.rs]"]
  node_cli["Headless CLI<br/>[main.rs]"]
  node_ui["Editor UI<br/>[canvas.rs]"]
  node_properties["Properties panel<br/>[properties.rs]"]
end

subgraph group_engine["Document engine"]
  node_session["Session commands<br/>[lib.rs]"]
  node_commandset["Editing commands<br/>[object.rs]"]
  node_docmodel["Document model"]
end

subgraph group_content["Layout and content"]
  node_compose["Text composition<br/>[lib.rs]"]
  node_breaker["Paragraph breaking<br/>[breaker.rs]"]
  node_fonts[("Font database<br/>[fontdb.rs]")]
  node_geometry["Geometry<br/>[path.rs]"]
  node_tools["Pointer tools<br/>[snap.rs]"]
  node_renderer["Spread renderer<br/>[lib.rs]"]
  node_color["Color management<br/>[mod.rs]"]
end

subgraph group_output["Formats and output"]
  node_idml["IDML exchange<br/>[import.rs]"]
  node_pdf["PDF export<br/>[export.rs]"]
  node_epub["EPUB export<br/>[lib.rs]"]
  node_textimport["Text import<br/>[docx.rs]"]
end

subgraph group_agents["Automation"]
  node_control["JSON control<br/>[control_server.rs]"]
  node_mcp["MCP server<br/>[server.rs]"]
end

node_designer(("Designer"))
node_agent(("Agent client"))

node_designer -->|"uses"| node_desktop
node_designer -->|"uses"| node_web
node_designer -->|"runs"| node_cli
node_desktop -->|"hosts"| node_ui
node_web -->|"hosts"| node_ui
node_web -->|"starts"| node_webshell
node_webshell -->|"delivers files"| node_ui
node_ui -->|"executes commands"| node_session
node_properties -->|"renders in"| node_ui
node_cli -->|"executes commands"| node_session
node_session -->|"dispatches"| node_commandset
node_session -.->|"edits"| node_docmodel
node_commandset -.->|"updates"| node_docmodel
node_session -->|"composes stories"| node_compose
node_compose -->|"breaks paragraphs"| node_breaker
node_compose -.->|"shapes text"| node_fonts
node_tools -->|"reduces gestures"| node_session
node_renderer -->|"uses composed text"| node_compose
node_renderer -->|"renders spreads"| node_docmodel
node_color -.->|"provides colors"| node_docmodel
node_session -.->|"imports and exports"| node_idml
node_session -.->|"exports"| node_pdf
node_session -.->|"exports"| node_epub
node_session -.->|"imports text"| node_textimport
node_agent -->|"sends JSON"| node_control
node_control -.->|"executes commands"| node_session
node_agent -->|"sends MCP"| node_mcp
node_mcp -.->|"dispatches tools"| node_session
node_session -.->|"renders output"| node_renderer

click node_desktop "https://github.com/storytold/designcraft/blob/main/apps/designcraft/src/main.rs"
click node_web "https://github.com/storytold/designcraft/blob/main/apps/designcraft-web/src/main.rs"
click node_webshell "https://github.com/storytold/designcraft/blob/main/apps/designcraft-web/src/web.rs"
click node_cli "https://github.com/storytold/designcraft/blob/main/apps/designcraft-cli/src/main.rs"
click node_ui "https://github.com/storytold/designcraft/blob/main/crates/ui-egui/src/canvas.rs"
click node_properties "https://github.com/storytold/designcraft/blob/main/crates/ui-egui/src/panels/properties.rs"
click node_session "https://github.com/storytold/designcraft/blob/main/crates/engine/src/lib.rs"
click node_commandset "https://github.com/storytold/designcraft/blob/main/crates/engine/src/cmd/object.rs"
click node_docmodel "https://github.com/storytold/designcraft/tree/main/crates/doc"
click node_compose "https://github.com/storytold/designcraft/blob/main/crates/compose/src/lib.rs"
click node_breaker "https://github.com/storytold/designcraft/blob/main/crates/compose/src/breaker.rs"
click node_fonts "https://github.com/storytold/designcraft/blob/main/crates/fonts/src/fontdb.rs"
click node_geometry "https://github.com/storytold/designcraft/blob/main/crates/geom/src/path.rs"
click node_tools "https://github.com/storytold/designcraft/blob/main/crates/tools/src/snap.rs"
click node_renderer "https://github.com/storytold/designcraft/blob/main/crates/render/src/lib.rs"
click node_color "https://github.com/storytold/designcraft/blob/main/crates/color/src/cms/mod.rs"
click node_idml "https://github.com/storytold/designcraft/blob/main/crates/idml/src/import.rs"
click node_pdf "https://github.com/storytold/designcraft/blob/main/crates/pdf/src/export.rs"
click node_epub "https://github.com/storytold/designcraft/blob/main/crates/epub/src/lib.rs"
click node_textimport "https://github.com/storytold/designcraft/blob/main/crates/textimport/src/docx.rs"
click node_control "https://github.com/storytold/designcraft/blob/main/apps/designcraft/src/control_server.rs"
click node_mcp "https://github.com/storytold/designcraft/blob/main/crates/mcp/src/server.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_web,node_webshell,node_cli,node_ui,node_properties,node_agent toneBlue
class node_session,node_commandset,node_docmodel toneAmber
class node_compose,node_breaker,node_fonts,node_geometry,node_tools,node_renderer,node_color toneMint
class node_idml,node_pdf,node_epub,node_textimport toneRose
class node_control,node_mcp,node_designer toneIndigo
```

## Components

### User interfaces

- [Desktop app](https://github.com/storytold/designcraft/blob/main/apps/designcraft/src/main.rs): `apps/designcraft/src/main.rs`
- [Browser app](https://github.com/storytold/designcraft/blob/main/apps/designcraft-web/src/main.rs): `apps/designcraft-web/src/main.rs`
- [Web file shell](https://github.com/storytold/designcraft/blob/main/apps/designcraft-web/src/web.rs): `apps/designcraft-web/src/web.rs`
- [Headless CLI](https://github.com/storytold/designcraft/blob/main/apps/designcraft-cli/src/main.rs): `apps/designcraft-cli/src/main.rs`
- [Editor UI](https://github.com/storytold/designcraft/blob/main/crates/ui-egui/src/canvas.rs): `crates/ui-egui/src/canvas.rs`
- [Properties panel](https://github.com/storytold/designcraft/blob/main/crates/ui-egui/src/panels/properties.rs): `crates/ui-egui/src/panels/properties.rs`

### Document engine

- [Session commands](https://github.com/storytold/designcraft/blob/main/crates/engine/src/lib.rs): `crates/engine/src/lib.rs`
- [Editing commands](https://github.com/storytold/designcraft/blob/main/crates/engine/src/cmd/object.rs): `crates/engine/src/cmd/object.rs`
- [Document model](https://github.com/storytold/designcraft/tree/main/crates/doc): `crates/doc`

### Layout and content

- [Text composition](https://github.com/storytold/designcraft/blob/main/crates/compose/src/lib.rs): `crates/compose/src/lib.rs`
- [Paragraph breaking](https://github.com/storytold/designcraft/blob/main/crates/compose/src/breaker.rs): `crates/compose/src/breaker.rs`
- [Font database](https://github.com/storytold/designcraft/blob/main/crates/fonts/src/fontdb.rs): `crates/fonts/src/fontdb.rs`
- [Geometry](https://github.com/storytold/designcraft/blob/main/crates/geom/src/path.rs): `crates/geom/src/path.rs`
- [Pointer tools](https://github.com/storytold/designcraft/blob/main/crates/tools/src/snap.rs): `crates/tools/src/snap.rs`
- [Spread renderer](https://github.com/storytold/designcraft/blob/main/crates/render/src/lib.rs): `crates/render/src/lib.rs`
- [Color management](https://github.com/storytold/designcraft/blob/main/crates/color/src/cms/mod.rs): `crates/color/src/cms/mod.rs`

### Formats and output

- [IDML exchange](https://github.com/storytold/designcraft/blob/main/crates/idml/src/import.rs): `crates/idml/src/import.rs`
- [PDF export](https://github.com/storytold/designcraft/blob/main/crates/pdf/src/export.rs): `crates/pdf/src/export.rs`
- [EPUB export](https://github.com/storytold/designcraft/blob/main/crates/epub/src/lib.rs): `crates/epub/src/lib.rs`
- [Text import](https://github.com/storytold/designcraft/blob/main/crates/textimport/src/docx.rs): `crates/textimport/src/docx.rs`

### Automation

- [JSON control](https://github.com/storytold/designcraft/blob/main/apps/designcraft/src/control_server.rs): `apps/designcraft/src/control_server.rs`
- [MCP server](https://github.com/storytold/designcraft/blob/main/crates/mcp/src/server.rs): `crates/mcp/src/server.rs`

### Other components

- **Designer**
- **Agent client**

## Connections

- Designer → Desktop app: uses (evidence: `README.md`)
- Designer → Browser app: uses (evidence: `README.md`)
- Designer → Headless CLI: runs (evidence: `apps/designcraft-cli/src/main.rs`)
- Desktop app → Editor UI: hosts (evidence: `apps/designcraft/src/main.rs`)
- Browser app → Editor UI: hosts (evidence: `apps/designcraft-web/src/main.rs`)
- Browser app → Web file shell: starts (evidence: `apps/designcraft-web/src/main.rs`)
- Web file shell → Editor UI: delivers files
- Editor UI → Session commands: executes commands (evidence: `crates/engine/src/lib.rs`)
- Properties panel → Editor UI: renders in (evidence: `crates/ui-egui/src/panels/properties.rs`)
- Headless CLI → Session commands: executes commands (evidence: `apps/designcraft-cli/src/main.rs`)
- Session commands → Editing commands: dispatches (evidence: `crates/engine/src/lib.rs`)
- Session commands → Document model: edits
- Editing commands → Document model: updates
- Session commands → Text composition: composes stories (evidence: `crates/engine/src/lib.rs`)
- Text composition → Paragraph breaking: breaks paragraphs (evidence: `crates/compose/src/lib.rs`)
- Text composition → Font database: shapes text
- Pointer tools → Session commands: reduces gestures (evidence: `crates/engine/src/lib.rs`)
- Spread renderer → Text composition: uses composed text (evidence: `crates/render/src/lib.rs`)
- Spread renderer → Document model: renders spreads (evidence: `crates/render/src/lib.rs`)
- Color management → Document model: provides colors
- Session commands → IDML exchange: imports and exports
- Session commands → PDF export: exports
- Session commands → EPUB export: exports
- Session commands → Text import: imports text
- Agent client → JSON control: sends JSON
- JSON control → Session commands: executes commands
- Agent client → MCP server: sends MCP (evidence: `README.md`)
- MCP server → Session commands: dispatches tools
- Session commands → Spread renderer: renders output
