# tracedraw/tracedraw architecture

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

- Interactive diagram: https://gitdiagram.com/tracedraw/tracedraw
- Repository: https://github.com/tracedraw/tracedraw

## Overview

TraceDraw is a cross-platform vector illustration, page-layout, and print editor. A user opens or creates a drawing, edits it through the workspace and tools, then saves, exports, or prints it; the same command engine also supports CLI, JavaScript, and MCP automation. The graph preserves documented format, text, effects, and TraceCut capabilities. Relationships are limited to README statements and the engine excerpt; several domain modules are represented by their exact implementation paths, but their internal call wiring was not sampled.

Main entry points: [`apps/tracedraw/src/app.rs`](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/app.rs) (Application), [`crates/core/src/document.rs`](https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/document.rs) (Document model), [`crates/core/src/engine.rs`](https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/engine.rs) (Command history), [`apps/tracedraw/src/ui/mod.rs`](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/mod.rs) (Workspace UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Editing workspace"]
  node_app["Application<br/>[app.rs]"]
  node_ui["Workspace UI<br/>[mod.rs]"]
  node_bars["Toolbars<br/>[bars.rs]"]
  node_dialogs["Dialogs<br/>[dialogs.rs]"]
  node_canvas["Canvas<br/>[canvas.rs]"]
  node_tools["Drawing tools<br/>[tools.rs]"]
  node_settings[("Preferences<br/>[settings.rs]")]
  node_theme["Themes<br/>[theme.rs]"]
  node_i18n["Localization<br/>[i18n.rs]"]
end

subgraph group_model["Document engine"]
  node_engine["Command history<br/>[engine.rs]"]
  node_document["Document model<br/>[document.rs]"]
  node_geometry["Geometry<br/>[geometry.rs]"]
  node_renderer["Rendering<br/>[lib.rs]"]
end

subgraph group_formats["Files and output"]
  node_files["File handling<br/>[files.rs]"]
  node_io["Import and export<br/>[lib.rs]"]
  node_cdr["CDR reader<br/>[parse.rs]"]
  node_cdrwrite["CDR writer<br/>[write.rs]"]
  node_imposition["Print imposition<br/>[imposition.rs]"]
end

subgraph group_creative["Creative capabilities"]
  node_text["Text layout<br/>[lib.rs]"]
  node_effects["Live effects<br/>[effects.rs]"]
  node_bitmap["Bitmap effects<br/>[bitmap_fx.rs]"]
  node_tracecut["TraceCut<br/>[lib.rs]"]
end

subgraph group_automation["Automation and platforms"]
  node_web["Browser app<br/>[web.rs]"]
  node_cli["Command line<br/>[main.rs]"]
  node_scripting["JavaScript automation<br/>[scripting.rs]"]
  node_mcp["MCP server<br/>[mcp.rs]"]
end

node_user(("Artist"))

node_user -->|"edits drawings"| node_app
node_app -->|"presents workspace"| node_ui
node_ui -->|"shows drawing"| node_canvas
node_ui -->|"composes toolbars"| node_bars
node_ui -->|"opens dialogs"| node_dialogs
node_app -->|"runs commands"| node_engine
node_engine -->|"owns drawing"| node_document
node_tools -->|"edits by command"| node_engine
node_files -->|"handles formats"| node_io
node_io -->|"reads CDR"| node_cdr
node_io -->|"writes CDR"| node_cdrwrite
node_document -->|"uses geometry"| node_geometry
node_document -->|"renders artwork"| node_renderer
node_document -->|"lays out text"| node_text
node_document -->|"keeps effects editable"| node_effects
node_document -->|"applies bitmap effects"| node_bitmap
node_app -.->|"prepares print"| node_imposition
node_app -.->|"supports cutting"| node_tracecut
node_app -->|"uses preferences"| node_settings
node_settings -->|"selects theme"| node_theme
node_ui -->|"localizes interface"| node_i18n
node_user -->|"automates edits"| node_cli
node_cli -->|"uses same engine"| node_engine
node_user -->|"automates edits"| node_scripting
node_scripting -->|"uses same engine"| node_engine
node_user -->|"sends agent tasks"| node_mcp
node_mcp -->|"uses same engine"| node_engine
node_user -->|"opens browser editor"| node_web

click node_app "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/app.rs"
click node_ui "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/mod.rs"
click node_bars "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/bars.rs"
click node_dialogs "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/dialogs.rs"
click node_canvas "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/canvas.rs"
click node_tools "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/tools.rs"
click node_engine "https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/engine.rs"
click node_document "https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/document.rs"
click node_geometry "https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/geometry.rs"
click node_renderer "https://github.com/tracedraw/tracedraw/blob/main/crates/render/src/lib.rs"
click node_files "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/files.rs"
click node_io "https://github.com/tracedraw/tracedraw/blob/main/crates/io/src/lib.rs"
click node_cdr "https://github.com/tracedraw/tracedraw/blob/main/crates/cdr/src/parse.rs"
click node_cdrwrite "https://github.com/tracedraw/tracedraw/blob/main/crates/cdr/src/write.rs"
click node_imposition "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/imposition.rs"
click node_text "https://github.com/tracedraw/tracedraw/blob/main/crates/text/src/lib.rs"
click node_effects "https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/effects.rs"
click node_bitmap "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/bitmap_fx.rs"
click node_tracecut "https://github.com/tracedraw/tracedraw/blob/main/crates/tracecut/src/lib.rs"
click node_settings "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/settings.rs"
click node_theme "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/theme.rs"
click node_i18n "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/i18n.rs"
click node_web "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/web.rs"
click node_cli "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw-cli/src/main.rs"
click node_scripting "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/scripting.rs"
click node_mcp "https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/mcp.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_app,node_ui,node_bars,node_dialogs,node_canvas,node_tools,node_settings,node_theme,node_i18n toneBlue
class node_engine,node_document,node_geometry,node_renderer toneAmber
class node_files,node_io,node_cdr,node_cdrwrite,node_imposition toneMint
class node_text,node_effects,node_bitmap,node_tracecut toneRose
class node_web,node_cli,node_scripting,node_mcp,node_user toneIndigo
```

## Components

### Editing workspace

- [Application](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/app.rs): `apps/tracedraw/src/app.rs`
- [Workspace UI](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/mod.rs): `apps/tracedraw/src/ui/mod.rs`
- [Toolbars](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/bars.rs): `apps/tracedraw/src/ui/bars.rs`
- [Dialogs](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/ui/dialogs.rs): `apps/tracedraw/src/ui/dialogs.rs`
- [Canvas](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/canvas.rs): `apps/tracedraw/src/canvas.rs`
- [Drawing tools](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/tools.rs): `apps/tracedraw/src/tools.rs`
- [Preferences](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/settings.rs): `apps/tracedraw/src/settings.rs`
- [Themes](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/theme.rs): `apps/tracedraw/src/theme.rs`
- [Localization](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/i18n.rs): `apps/tracedraw/src/i18n.rs`

### Document engine

- [Command history](https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/engine.rs): `crates/core/src/engine.rs`
- [Document model](https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/document.rs): `crates/core/src/document.rs`
- [Geometry](https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/geometry.rs): `crates/core/src/geometry.rs`
- [Rendering](https://github.com/tracedraw/tracedraw/blob/main/crates/render/src/lib.rs): `crates/render/src/lib.rs`

### Files and output

- [File handling](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/files.rs): `apps/tracedraw/src/files.rs`
- [Import and export](https://github.com/tracedraw/tracedraw/blob/main/crates/io/src/lib.rs): `crates/io/src/lib.rs`
- [CDR reader](https://github.com/tracedraw/tracedraw/blob/main/crates/cdr/src/parse.rs): `crates/cdr/src/parse.rs`
- [CDR writer](https://github.com/tracedraw/tracedraw/blob/main/crates/cdr/src/write.rs): `crates/cdr/src/write.rs`
- [Print imposition](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/imposition.rs): `apps/tracedraw/src/imposition.rs`

### Creative capabilities

- [Text layout](https://github.com/tracedraw/tracedraw/blob/main/crates/text/src/lib.rs): `crates/text/src/lib.rs`
- [Live effects](https://github.com/tracedraw/tracedraw/blob/main/crates/core/src/effects.rs): `crates/core/src/effects.rs`
- [Bitmap effects](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/bitmap_fx.rs): `apps/tracedraw/src/bitmap_fx.rs`
- [TraceCut](https://github.com/tracedraw/tracedraw/blob/main/crates/tracecut/src/lib.rs): `crates/tracecut/src/lib.rs`

### Automation and platforms

- [Browser app](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/web.rs): `apps/tracedraw/src/web.rs`
- [Command line](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw-cli/src/main.rs): `apps/tracedraw-cli/src/main.rs`
- [JavaScript automation](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/scripting.rs): `apps/tracedraw/src/scripting.rs`
- [MCP server](https://github.com/tracedraw/tracedraw/blob/main/apps/tracedraw/src/mcp.rs): `apps/tracedraw/src/mcp.rs`

### Other components

- **Artist**

## Connections

- Artist → Application: edits drawings
- Application → Workspace UI: presents workspace (evidence: `apps/tracedraw/src/ui/mod.rs`)
- Workspace UI → Canvas: shows drawing (evidence: `apps/tracedraw/src/ui/mod.rs`)
- Workspace UI → Toolbars: composes toolbars (evidence: `apps/tracedraw/src/ui/mod.rs`)
- Workspace UI → Dialogs: opens dialogs (evidence: `apps/tracedraw/src/ui/mod.rs`)
- Application → Command history: runs commands
- Command history → Document model: owns drawing (evidence: `crates/core/src/engine.rs`)
- Drawing tools → Command history: edits by command
- File handling → Import and export: handles formats
- Import and export → CDR reader: reads CDR
- Import and export → CDR writer: writes CDR
- Document model → Geometry: uses geometry (evidence: `crates/core/src/document.rs`)
- Document model → Rendering: renders artwork
- Document model → Text layout: lays out text
- Document model → Live effects: keeps effects editable (evidence: `crates/core/src/document.rs`)
- Document model → Bitmap effects: applies bitmap effects
- Application → Print imposition: prepares print
- Application → TraceCut: supports cutting
- Application → Preferences: uses preferences (evidence: `apps/tracedraw/src/settings.rs`)
- Preferences → Themes: selects theme (evidence: `apps/tracedraw/src/settings.rs`)
- Workspace UI → Localization: localizes interface (evidence: `apps/tracedraw/src/i18n.rs`)
- Artist → Command line: automates edits
- Command line → Command history: uses same engine
- Artist → JavaScript automation: automates edits
- JavaScript automation → Command history: uses same engine
- Artist → MCP server: sends agent tasks
- MCP server → Command history: uses same engine
- Artist → Browser app: opens browser editor
