# storytold/printcraft architecture

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

## Overview

PrintCraft is a Rust PDF workbench delivered as a native app, web app, and CLI. The principal workflow is opening a PDF, viewing and searching it, applying document or page changes through the engine, then saving, exporting, or printing. The README also describes combining and splitting, comments, forms, redaction, signing, accessibility, and agent tools; these remain represented as product branches. Edges are limited to the excerpted source references and explicit README descriptions; unsampled subsystem links are dashed where their wiring is not shown.

Main entry points: [`crates/engine/src/lib.rs`](https://github.com/storytold/printcraft/blob/main/crates/engine/src/lib.rs) (Document engine), [`crates/automation/src/tools.rs`](https://github.com/storytold/printcraft/blob/main/crates/automation/src/tools.rs) (Agent tools), [`crates/ui-egui/src/canvas.rs`](https://github.com/storytold/printcraft/blob/main/crates/ui-egui/src/canvas.rs) (Workbench UI), [`apps/printcraft/src/main.rs`](https://github.com/storytold/printcraft/blob/main/apps/printcraft/src/main.rs) (Desktop app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["Product frontends"]
  node_desktop["Desktop app<br/>[main.rs]"]
  node_web["Web app<br/>[main.rs]"]
  node_cli["CLI<br/>[main.rs]"]
  node_ui["Workbench UI<br/>[canvas.rs]"]
end

subgraph group_engine["Document engine"]
  node_enginecore["Document engine<br/>[lib.rs]"]
  node_cos["PDF object model<br/>[parser.rs]"]
end

subgraph group_pdf["PDF capabilities"]
  node_render["Page rendering<br/>[raster.rs]"]
  node_organize["Page organization<br/>[import.rs]"]
  node_edit["Content editing<br/>[text.rs]"]
  node_annot["Comments and links<br/>[appearance.rs]"]
  node_forms["Forms<br/>[author.rs]"]
  node_redact["Redaction<br/>[interp.rs]"]
  node_a11y["Accessibility<br/>[structure.rs]"]
  node_sign["Digital signing<br/>[pdf.rs]"]
  node_compare["Document comparison<br/>[lib.rs]"]
  node_ocr["OCR<br/>[lib.rs]"]
  node_export["Export and combine<br/>[lib.rs]"]
  node_print["Printing<br/>[lib.rs]"]
end

subgraph group_automation["Automation"]
  node_automationlib["Agent tools<br/>[tools.rs]"]
  node_mcp["MCP server<br/>[mcp.rs]"]
end

node_person(("PDF user"))

node_person -->|"opens PDFs"| node_desktop
node_person -->|"uses"| node_web
node_person -->|"runs commands"| node_cli
node_desktop -.->|"starts UI"| node_ui
node_web -.->|"starts UI"| node_ui
node_cli -->|"runs tools"| node_automationlib
node_ui -.->|"controls documents"| node_enginecore
node_enginecore -->|"edits object graph"| node_cos
node_enginecore -.->|"renders pages"| node_render
node_enginecore -.->|"organizes pages"| node_organize
node_enginecore -.->|"edits content"| node_edit
node_enginecore -.->|"manages comments"| node_annot
node_enginecore -->|"edits fields"| node_forms
node_enginecore -.->|"applies redactions"| node_redact
node_enginecore -.->|"audits accessibility"| node_a11y
node_enginecore -.->|"signs documents"| node_sign
node_enginecore -.->|"compares documents"| node_compare
node_enginecore -.->|"extracts text"| node_ocr
node_enginecore -.->|"exports documents"| node_export
node_enginecore -.->|"prints documents"| node_print
node_automationlib -->|"controls session"| node_enginecore
node_automationlib -.->|"serves tools"| node_mcp
node_automationlib -.->|"returns results"| node_person

click node_desktop "https://github.com/storytold/printcraft/blob/main/apps/printcraft/src/main.rs"
click node_web "https://github.com/storytold/printcraft/blob/main/apps/printcraft-web/src/main.rs"
click node_cli "https://github.com/storytold/printcraft/blob/main/apps/printcraft-cli/src/main.rs"
click node_ui "https://github.com/storytold/printcraft/blob/main/crates/ui-egui/src/canvas.rs"
click node_enginecore "https://github.com/storytold/printcraft/blob/main/crates/engine/src/lib.rs"
click node_cos "https://github.com/storytold/printcraft/blob/main/crates/cos/src/parser.rs"
click node_render "https://github.com/storytold/printcraft/blob/main/crates/render/src/raster.rs"
click node_organize "https://github.com/storytold/printcraft/blob/main/crates/organize/src/import.rs"
click node_edit "https://github.com/storytold/printcraft/blob/main/crates/edit/src/text.rs"
click node_annot "https://github.com/storytold/printcraft/blob/main/crates/annot/src/appearance.rs"
click node_forms "https://github.com/storytold/printcraft/blob/main/crates/forms/src/author.rs"
click node_redact "https://github.com/storytold/printcraft/blob/main/crates/redact/src/interp.rs"
click node_a11y "https://github.com/storytold/printcraft/blob/main/crates/a11y/src/structure.rs"
click node_sign "https://github.com/storytold/printcraft/blob/main/crates/sign/src/pdf.rs"
click node_compare "https://github.com/storytold/printcraft/blob/main/crates/compare/src/lib.rs"
click node_ocr "https://github.com/storytold/printcraft/blob/main/crates/ocr/src/lib.rs"
click node_export "https://github.com/storytold/printcraft/blob/main/crates/export/src/lib.rs"
click node_print "https://github.com/storytold/printcraft/blob/main/crates/print/src/lib.rs"
click node_automationlib "https://github.com/storytold/printcraft/blob/main/crates/automation/src/tools.rs"
click node_mcp "https://github.com/storytold/printcraft/blob/main/crates/automation/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_desktop,node_web,node_cli,node_ui,node_person toneBlue
class node_enginecore,node_cos toneAmber
class node_render,node_organize,node_edit,node_annot,node_forms,node_redact,node_a11y,node_sign,node_compare,node_ocr,node_export,node_print toneMint
class node_automationlib,node_mcp toneRose
```

## Components

### Product frontends

- [Desktop app](https://github.com/storytold/printcraft/blob/main/apps/printcraft/src/main.rs): `apps/printcraft/src/main.rs`
- [Web app](https://github.com/storytold/printcraft/blob/main/apps/printcraft-web/src/main.rs): `apps/printcraft-web/src/main.rs`
- [CLI](https://github.com/storytold/printcraft/blob/main/apps/printcraft-cli/src/main.rs): `apps/printcraft-cli/src/main.rs`
- [Workbench UI](https://github.com/storytold/printcraft/blob/main/crates/ui-egui/src/canvas.rs): `crates/ui-egui/src/canvas.rs`

### Document engine

- [Document engine](https://github.com/storytold/printcraft/blob/main/crates/engine/src/lib.rs): `crates/engine/src/lib.rs`
- [PDF object model](https://github.com/storytold/printcraft/blob/main/crates/cos/src/parser.rs): `crates/cos/src/parser.rs`

### PDF capabilities

- [Page rendering](https://github.com/storytold/printcraft/blob/main/crates/render/src/raster.rs): `crates/render/src/raster.rs`
- [Page organization](https://github.com/storytold/printcraft/blob/main/crates/organize/src/import.rs): `crates/organize/src/import.rs`
- [Content editing](https://github.com/storytold/printcraft/blob/main/crates/edit/src/text.rs): `crates/edit/src/text.rs`
- [Comments and links](https://github.com/storytold/printcraft/blob/main/crates/annot/src/appearance.rs): `crates/annot/src/appearance.rs`
- [Forms](https://github.com/storytold/printcraft/blob/main/crates/forms/src/author.rs): `crates/forms/src/author.rs`
- [Redaction](https://github.com/storytold/printcraft/blob/main/crates/redact/src/interp.rs): `crates/redact/src/interp.rs`
- [Accessibility](https://github.com/storytold/printcraft/blob/main/crates/a11y/src/structure.rs): `crates/a11y/src/structure.rs`
- [Digital signing](https://github.com/storytold/printcraft/blob/main/crates/sign/src/pdf.rs): `crates/sign/src/pdf.rs`
- [Document comparison](https://github.com/storytold/printcraft/blob/main/crates/compare/src/lib.rs): `crates/compare/src/lib.rs`
- [OCR](https://github.com/storytold/printcraft/blob/main/crates/ocr/src/lib.rs): `crates/ocr/src/lib.rs`
- [Export and combine](https://github.com/storytold/printcraft/blob/main/crates/export/src/lib.rs): `crates/export/src/lib.rs`
- [Printing](https://github.com/storytold/printcraft/blob/main/crates/print/src/lib.rs): `crates/print/src/lib.rs`

### Automation

- [Agent tools](https://github.com/storytold/printcraft/blob/main/crates/automation/src/tools.rs): `crates/automation/src/tools.rs`
- [MCP server](https://github.com/storytold/printcraft/blob/main/crates/automation/src/mcp.rs): `crates/automation/src/mcp.rs`

### Other components

- **PDF user**

## Connections

- PDF user → Desktop app: opens PDFs (evidence: `README.md`)
- PDF user → Web app: uses (evidence: `README.md`)
- PDF user → CLI: runs commands
- Desktop app → Workbench UI: starts UI
- Web app → Workbench UI: starts UI
- CLI → Agent tools: runs tools
- Workbench UI → Document engine: controls documents
- Document engine → PDF object model: edits object graph (evidence: `crates/engine/src/lib.rs`)
- Document engine → Page rendering: renders pages
- Document engine → Page organization: organizes pages
- Document engine → Content editing: edits content
- Document engine → Comments and links: manages comments
- Document engine → Forms: edits fields (evidence: `crates/engine/src/lib.rs`)
- Document engine → Redaction: applies redactions
- Document engine → Accessibility: audits accessibility
- Document engine → Digital signing: signs documents
- Document engine → Document comparison: compares documents
- Document engine → OCR: extracts text
- Document engine → Export and combine: exports documents
- Document engine → Printing: prints documents
- Agent tools → Document engine: controls session
- Agent tools → MCP server: serves tools
- Agent tools → PDF user: returns results
