# redbrickmedia/shift-pdf-v2 architecture

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

- Interactive diagram: https://gitdiagram.com/redbrickmedia/shift-pdf-v2
- Repository: https://github.com/redbrickmedia/shift-pdf-v2

## Overview

BentoPDF is a privacy-first, browser-based PDF toolkit. Users choose a tool, provide files from their device or saved library, process them in the browser, and view or download results. Its major branches include PDF organization and editing, conversions, security and optimization, comparison, and visual workflow authoring. The graph combines sampled call relationships with documented product capabilities; unsampled tool implementations are represented at their source-directory level, and their internal calls are not inferred.

Main entry points: [`src/js/main.ts`](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/main.ts) (App bootstrap), [`src/js/logic/add-more-files.ts`](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/add-more-files.ts) (Add library files), [`src/js/logic`](https://github.com/redbrickmedia/shift-pdf-v2/tree/main/src/js/logic) (PDF tool operations), [`src/js/logic/compare-pdfs-page.ts`](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/compare-pdfs-page.ts) (Comparison interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_app["App bootstrap<br/>[main.ts]"]
  node_catalog["Tool catalog<br/>[tools.ts]"]
  node_interface["PDF interface<br/>[ui.ts]"]
  node_render["Page rendering<br/>[render-utils.ts]"]
end

subgraph group_files["Files and workspace"]
  node_intake["File handling<br/>[fileHandler.ts]"]
  node_workspace[("Workspace and library<br/>[workspace-files.ts]")]
  node_filepicker["Add library files<br/>[add-more-files.ts]"]
  node_toolseed["Tool file seeding"]
end

subgraph group_pdf["PDF tools"]
  node_tools["PDF tool operations"]
  node_helpers["PDF utilities<br/>[helpers.ts]"]
  node_workers["PDF processing workers"]
end

subgraph group_compare["PDF comparison"]
  node_compareui["Comparison interface"]
  node_comparemodel["Comparison models"]
  node_compareapi["Comparison worker API<br/>[worker-api.ts]"]
  node_compareworker["Comparison worker<br/>[compare.worker.ts]"]
  node_diff["Text diff<br/>[diff-text-runs.ts]"]
  node_pair["Page pairing<br/>[pair-pages.ts]"]
end

subgraph group_workflow["Visual workflows"]
  node_workfloweditor["Workflow editor<br/>[editor.ts]"]
  node_workflowengine["Workflow engine<br/>[engine.ts]"]
  node_workflownodes["Workflow nodes"]
end

node_user(("User"))
node_wasm(("WASM CDN"))

node_user -.->|"opens"| node_app
node_app -->|"loads tools"| node_catalog
node_user -.->|"provides files"| node_intake
node_intake -->|"renders PDF"| node_interface
node_interface -->|"renders pages"| node_render
node_app -->|"initializes picker"| node_filepicker
node_filepicker -->|"reads files"| node_workspace
node_filepicker -->|"applies files"| node_toolseed
node_workspace -.->|"stores PDFs"| node_user
node_user -.->|"selects operation"| node_tools
node_tools -.->|"uses utilities"| node_helpers
node_tools -.->|"offloads processing"| node_workers
node_helpers -.->|"loads modules"| node_wasm
node_user -.->|"compares PDFs"| node_compareui
node_compareui -.->|"extracts models"| node_comparemodel
node_compareui -.->|"requests comparison"| node_compareapi
node_compareapi -->|"posts work"| node_compareworker
node_compareworker -->|"computes diff"| node_diff
node_compareworker -->|"pairs pages"| node_pair
node_user -.->|"authors workflow"| node_workfloweditor
node_workfloweditor -.->|"executes workflow"| node_workflowengine
node_workflowengine -.->|"uses node types"| node_workflownodes
node_workflowengine -->|"updates display"| node_workfloweditor

click node_app "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/main.ts"
click node_catalog "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/config/tools.ts"
click node_interface "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/ui.ts"
click node_render "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/utils/render-utils.ts"
click node_intake "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/handlers/fileHandler.ts"
click node_workspace "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/workspace-files.ts"
click node_filepicker "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/add-more-files.ts"
click node_toolseed "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/seed-tool-open-file.ts"
click node_tools "https://github.com/redbrickmedia/shift-pdf-v2/tree/main/src/js/logic"
click node_helpers "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/utils/helpers.ts"
click node_workers "https://github.com/redbrickmedia/shift-pdf-v2/tree/main/public/workers"
click node_compareui "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/compare-pdfs-page.ts"
click node_comparemodel "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/extract-page-model.ts"
click node_compareapi "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/worker-api.ts"
click node_compareworker "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/compare.worker.ts"
click node_diff "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/diff-text-runs.ts"
click node_pair "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/pair-pages.ts"
click node_workfloweditor "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/workflow/editor.ts"
click node_workflowengine "https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/workflow/engine.ts"
click node_workflownodes "https://github.com/redbrickmedia/shift-pdf-v2/tree/main/src/js/workflow/nodes"

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_catalog,node_interface,node_render,node_user toneBlue
class node_intake,node_workspace,node_filepicker,node_toolseed toneAmber
class node_tools,node_helpers,node_workers toneMint
class node_compareui,node_comparemodel,node_compareapi,node_compareworker,node_diff,node_pair toneRose
class node_workfloweditor,node_workflowengine,node_workflownodes,node_wasm toneIndigo
```

## Components

### App and UI

- [App bootstrap](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/main.ts): `src/js/main.ts`
- [Tool catalog](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/config/tools.ts): `src/js/config/tools.ts`
- [PDF interface](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/ui.ts): `src/js/ui.ts`
- [Page rendering](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/utils/render-utils.ts): `src/js/utils/render-utils.ts`

### Files and workspace

- [File handling](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/handlers/fileHandler.ts): `src/js/handlers/fileHandler.ts`
- [Workspace and library](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/workspace-files.ts): `src/js/logic/workspace-files.ts`
- [Add library files](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/add-more-files.ts): `src/js/logic/add-more-files.ts`
- [Tool file seeding](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/seed-tool-open-file.ts): `src/js/logic/seed-tool-open-file.ts`

### PDF tools

- [PDF tool operations](https://github.com/redbrickmedia/shift-pdf-v2/tree/main/src/js/logic): `src/js/logic`
- [PDF utilities](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/utils/helpers.ts): `src/js/utils/helpers.ts`
- [PDF processing workers](https://github.com/redbrickmedia/shift-pdf-v2/tree/main/public/workers): `public/workers`

### PDF comparison

- [Comparison interface](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/logic/compare-pdfs-page.ts): `src/js/logic/compare-pdfs-page.ts`
- [Comparison models](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/extract-page-model.ts): `src/js/compare/engine/extract-page-model.ts`
- [Comparison worker API](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/worker-api.ts): `src/js/compare/worker-api.ts`
- [Comparison worker](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/compare.worker.ts): `src/js/compare/engine/compare.worker.ts`
- [Text diff](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/diff-text-runs.ts): `src/js/compare/engine/diff-text-runs.ts`
- [Page pairing](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/compare/engine/pair-pages.ts): `src/js/compare/engine/pair-pages.ts`

### Visual workflows

- [Workflow editor](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/workflow/editor.ts): `src/js/workflow/editor.ts`
- [Workflow engine](https://github.com/redbrickmedia/shift-pdf-v2/blob/main/src/js/workflow/engine.ts): `src/js/workflow/engine.ts`
- [Workflow nodes](https://github.com/redbrickmedia/shift-pdf-v2/tree/main/src/js/workflow/nodes): `src/js/workflow/nodes`

### Other components

- **User**
- **WASM CDN**

## Connections

- User → App bootstrap: opens
- App bootstrap → Tool catalog: loads tools (evidence: `src/js/main.ts`)
- User → File handling: provides files
- File handling → PDF interface: renders PDF (evidence: `src/js/handlers/fileHandler.ts`)
- PDF interface → Page rendering: renders pages (evidence: `src/js/ui.ts`)
- App bootstrap → Add library files: initializes picker (evidence: `src/js/main.ts`)
- Add library files → Workspace and library: reads files (evidence: `src/js/logic/add-more-files.ts`)
- Add library files → Tool file seeding: applies files (evidence: `src/js/logic/add-more-files.ts`)
- Workspace and library → User: stores PDFs
- User → PDF tool operations: selects operation
- PDF tool operations → PDF utilities: uses utilities (evidence: `src/js/logic/workspace-files.ts`)
- PDF tool operations → PDF processing workers: offloads processing
- PDF utilities → WASM CDN: loads modules
- User → Comparison interface: compares PDFs
- Comparison interface → Comparison models: extracts models
- Comparison interface → Comparison worker API: requests comparison
- Comparison worker API → Comparison worker: posts work (evidence: `src/js/compare/worker-api.ts`)
- Comparison worker → Text diff: computes diff (evidence: `src/js/compare/engine/compare.worker.ts`)
- Comparison worker → Page pairing: pairs pages (evidence: `src/js/compare/engine/compare.worker.ts`)
- User → Workflow editor: authors workflow
- Workflow editor → Workflow engine: executes workflow (evidence: `src/js/workflow/engine.ts`)
- Workflow engine → Workflow nodes: uses node types (evidence: `src/js/workflow/engine.ts`)
- Workflow engine → Workflow editor: updates display (evidence: `src/js/workflow/engine.ts`)
