# storytold/pdfcraft architecture

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

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

## Overview

PdfCraft is a native and web PDF reader/editor, with a headless CLI and an automation tool interface. The user workflow spans opening a PDF, reading and navigating it, applying document operations, and saving or exporting results; major documented capabilities also include organizing/combining, forms and comments, security, accessibility, printing, and OCR. Sampled evidence confirms CLI command dispatch and UI canvas selection. Many capability modules are unsampled, so their connections are shown only as unverified dashed edges or omitted.

Main entry points: [`crates/ui-egui/src/app.rs`](https://github.com/storytold/pdfcraft/blob/main/crates/ui-egui/src/app.rs) (Application UI), [`apps/pdfcraft-cli/src/main.rs`](https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-cli/src/main.rs) (CLI commands), [`apps/pdfcraft/src/main.rs`](https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft/src/main.rs) (Desktop app), [`crates/automation/src/tools.rs`](https://github.com/storytold/pdfcraft/blob/main/crates/automation/src/tools.rs) (Automation tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry points"]
  node_desktop["Desktop app<br/>[main.rs]"]
  node_web["Web app<br/>[main.rs]"]
  node_cli["CLI commands<br/>[main.rs]"]
  node_cli_options["CLI options<br/>[options.rs]"]
end

subgraph group_experience["Reading experience"]
  node_ui["Application UI<br/>[app.rs]"]
  node_canvas["Document canvas<br/>[canvas.rs]"]
  node_render["PDF rendering<br/>[lib.rs]"]
  node_text_search["Text search<br/>[search.rs]"]
end

subgraph group_document["PDF document operations"]
  node_engine["Document engine<br/>[document.rs]"]
  node_organize["Organize and combine<br/>[lib.rs]"]
  node_edit["Content editing<br/>[lib.rs]"]
  node_forms["Forms<br/>[edit.rs]"]
  node_annotations["Comments and annotations<br/>[create.rs]"]
  node_redact["Redaction<br/>[sanitize.rs]"]
  node_sign["Digital signatures<br/>[lib.rs]"]
  node_accessibility["Accessibility<br/>[lib.rs]"]
  node_ocr["OCR<br/>[lib.rs]"]
  node_printing["Printing<br/>[lib.rs]"]
  node_export["Export formats<br/>[lib.rs]"]
end

subgraph group_foundation["PDF foundations"]
  node_pdf_cos["PDF objects and files<br/>[open.rs]"]
end

subgraph group_automation["Automation"]
  node_automation_tools["Automation tools<br/>[tools.rs]"]
  node_mcp["MCP interface<br/>[mcp.rs]"]
end

node_user(("PDF user"))

node_user -.->|"opens and edits"| node_desktop
node_user -.->|"uses"| node_web
node_user -.->|"runs commands"| node_cli
node_cli -->|"validates options"| node_cli_options
node_cli -.->|"drives tool table"| node_automation_tools
node_ui -->|"shows document area"| node_canvas
node_desktop -.->|"starts UI"| node_ui
node_ui -.->|"renders pages"| node_render
node_ui -.->|"searches text"| node_text_search
node_ui -.->|"organizes pages"| node_organize
node_ui -.->|"edits content"| node_edit
node_ui -.->|"edits forms"| node_forms
node_ui -.->|"manages comments"| node_annotations
node_ui -.->|"redacts content"| node_redact
node_ui -.->|"signs documents"| node_sign
node_ui -.->|"checks accessibility"| node_accessibility
node_ui -.->|"recognizes text"| node_ocr
node_ui -.->|"prints documents"| node_printing
node_ui -.->|"exports documents"| node_export
node_automation_tools -.->|"serves tools"| node_mcp
node_engine -.->|"reads and writes"| node_pdf_cos

click node_desktop "https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft/src/main.rs"
click node_web "https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-web/src/main.rs"
click node_cli "https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-cli/src/main.rs"
click node_cli_options "https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-cli/src/options.rs"
click node_ui "https://github.com/storytold/pdfcraft/blob/main/crates/ui-egui/src/app.rs"
click node_canvas "https://github.com/storytold/pdfcraft/blob/main/crates/ui-egui/src/canvas.rs"
click node_render "https://github.com/storytold/pdfcraft/blob/main/crates/render/src/lib.rs"
click node_text_search "https://github.com/storytold/pdfcraft/blob/main/crates/render/src/text/search.rs"
click node_engine "https://github.com/storytold/pdfcraft/blob/main/crates/engine/src/document.rs"
click node_organize "https://github.com/storytold/pdfcraft/blob/main/crates/organize/src/lib.rs"
click node_edit "https://github.com/storytold/pdfcraft/blob/main/crates/edit/src/lib.rs"
click node_forms "https://github.com/storytold/pdfcraft/blob/main/crates/forms/src/author/edit.rs"
click node_annotations "https://github.com/storytold/pdfcraft/blob/main/crates/annot/src/create.rs"
click node_redact "https://github.com/storytold/pdfcraft/blob/main/crates/redact/src/sanitize.rs"
click node_sign "https://github.com/storytold/pdfcraft/blob/main/crates/sign/src/lib.rs"
click node_accessibility "https://github.com/storytold/pdfcraft/blob/main/crates/a11y/src/lib.rs"
click node_ocr "https://github.com/storytold/pdfcraft/blob/main/crates/ocr/src/lib.rs"
click node_printing "https://github.com/storytold/pdfcraft/blob/main/crates/print/src/lib.rs"
click node_export "https://github.com/storytold/pdfcraft/blob/main/crates/export/src/lib.rs"
click node_pdf_cos "https://github.com/storytold/pdfcraft/blob/main/crates/cos/src/document/open.rs"
click node_automation_tools "https://github.com/storytold/pdfcraft/blob/main/crates/automation/src/tools.rs"
click node_mcp "https://github.com/storytold/pdfcraft/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_cli_options,node_user toneBlue
class node_ui,node_canvas,node_render,node_text_search toneAmber
class node_engine,node_organize,node_edit,node_forms,node_annotations,node_redact,node_sign,node_accessibility,node_ocr,node_printing,node_export toneMint
class node_pdf_cos toneRose
class node_automation_tools,node_mcp toneIndigo
```

## Components

### App entry points

- [Desktop app](https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft/src/main.rs): `apps/pdfcraft/src/main.rs`
- [Web app](https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-web/src/main.rs): `apps/pdfcraft-web/src/main.rs`
- [CLI commands](https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-cli/src/main.rs): `apps/pdfcraft-cli/src/main.rs`
- [CLI options](https://github.com/storytold/pdfcraft/blob/main/apps/pdfcraft-cli/src/options.rs): `apps/pdfcraft-cli/src/options.rs`

### Reading experience

- [Application UI](https://github.com/storytold/pdfcraft/blob/main/crates/ui-egui/src/app.rs): `crates/ui-egui/src/app.rs`
- [Document canvas](https://github.com/storytold/pdfcraft/blob/main/crates/ui-egui/src/canvas.rs): `crates/ui-egui/src/canvas.rs`
- [PDF rendering](https://github.com/storytold/pdfcraft/blob/main/crates/render/src/lib.rs): `crates/render/src/lib.rs`
- [Text search](https://github.com/storytold/pdfcraft/blob/main/crates/render/src/text/search.rs): `crates/render/src/text/search.rs`

### PDF document operations

- [Document engine](https://github.com/storytold/pdfcraft/blob/main/crates/engine/src/document.rs): `crates/engine/src/document.rs`
- [Organize and combine](https://github.com/storytold/pdfcraft/blob/main/crates/organize/src/lib.rs): `crates/organize/src/lib.rs`
- [Content editing](https://github.com/storytold/pdfcraft/blob/main/crates/edit/src/lib.rs): `crates/edit/src/lib.rs`
- [Forms](https://github.com/storytold/pdfcraft/blob/main/crates/forms/src/author/edit.rs): `crates/forms/src/author/edit.rs`
- [Comments and annotations](https://github.com/storytold/pdfcraft/blob/main/crates/annot/src/create.rs): `crates/annot/src/create.rs`
- [Redaction](https://github.com/storytold/pdfcraft/blob/main/crates/redact/src/sanitize.rs): `crates/redact/src/sanitize.rs`
- [Digital signatures](https://github.com/storytold/pdfcraft/blob/main/crates/sign/src/lib.rs): `crates/sign/src/lib.rs`
- [Accessibility](https://github.com/storytold/pdfcraft/blob/main/crates/a11y/src/lib.rs): `crates/a11y/src/lib.rs`
- [OCR](https://github.com/storytold/pdfcraft/blob/main/crates/ocr/src/lib.rs): `crates/ocr/src/lib.rs`
- [Printing](https://github.com/storytold/pdfcraft/blob/main/crates/print/src/lib.rs): `crates/print/src/lib.rs`
- [Export formats](https://github.com/storytold/pdfcraft/blob/main/crates/export/src/lib.rs): `crates/export/src/lib.rs`

### PDF foundations

- [PDF objects and files](https://github.com/storytold/pdfcraft/blob/main/crates/cos/src/document/open.rs): `crates/cos/src/document/open.rs`

### Automation

- [Automation tools](https://github.com/storytold/pdfcraft/blob/main/crates/automation/src/tools.rs): `crates/automation/src/tools.rs`
- [MCP interface](https://github.com/storytold/pdfcraft/blob/main/crates/automation/src/mcp.rs): `crates/automation/src/mcp.rs`

### Other components

- **PDF user**

## Connections

- PDF user → Desktop app: opens and edits
- PDF user → Web app: uses
- PDF user → CLI commands: runs commands
- CLI commands → CLI options: validates options (evidence: `apps/pdfcraft-cli/src/main.rs`)
- CLI commands → Automation tools: drives tool table
- Application UI → Document canvas: shows document area (evidence: `crates/ui-egui/src/app.rs`)
- Desktop app → Application UI: starts UI
- Application UI → PDF rendering: renders pages
- Application UI → Text search: searches text
- Application UI → Organize and combine: organizes pages
- Application UI → Content editing: edits content
- Application UI → Forms: edits forms
- Application UI → Comments and annotations: manages comments
- Application UI → Redaction: redacts content
- Application UI → Digital signatures: signs documents
- Application UI → Accessibility: checks accessibility
- Application UI → OCR: recognizes text
- Application UI → Printing: prints documents
- Application UI → Export formats: exports documents
- Automation tools → MCP interface: serves tools
- Document engine → PDF objects and files: reads and writes
