# siddichandu02/privacy-toolkit architecture

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

- Interactive diagram: https://gitdiagram.com/siddichandu02/privacy-toolkit
- Repository: https://github.com/siddichandu02/privacy-toolkit

## Overview

Privacy Toolkit is a browser-only PDF and image tool suite: users choose a tool, provide local files, configure the operation, and receive a result without uploading files. Its domain stages include file intake and preview, tool-specific editing, PDF processing, and result presentation. Web Workers provide an internal execution layer to keep processing off the UI thread. The README documents all six ready tools; sampled source confirms routing and parts of the worker framework, but not every tool-to-worker connection, so those links are omitted or marked unverified.

Main entry points: [`src/routes/ToolPage.tsx`](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/ToolPage.tsx) (Tool dispatch), [`src/App.tsx`](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/App.tsx) (App routes), [`src/components/result/DoneCard.tsx`](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/result/DoneCard.tsx) (Result cards), [`src/routes/Home.tsx`](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/Home.tsx) (Tool discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation and discovery"]
  node_app["App routes<br/>[App.tsx]"]
  node_home["Tool discovery<br/>[Home.tsx]"]
  node_registry["Tool registry<br/>[tools.ts]"]
  node_toolpage["Tool dispatch<br/>[ToolPage.tsx]"]
  node_notfound["Not found<br/>[NotFound.tsx]"]
  node_header["Site header<br/>[Header.tsx]"]
  node_accent["Tool accents<br/>[accent.ts]"]
  node_title["Page title"]
end

subgraph group_workflow["File and tool workflow"]
  node_workbench["File workbench<br/>[ToolWorkbench.tsx]"]
  node_preview["File preview<br/>[preview.ts]"]
  node_queue["File queue<br/>[useFileQueue.ts]"]
  node_merge["Merge PDFs<br/>[MergeTool.tsx]"]
  node_split["Split PDFs<br/>[SplitTool.tsx]"]
  node_rotate["Rotate pages<br/>[RotateTool.tsx]"]
  node_images["Images to PDF<br/>[ImagesTool.tsx]"]
  node_sign["Sign PDF<br/>[SignTool.tsx]"]
  node_compress["Compress PDF<br/>[CompressTool.tsx]"]
  node_results["Result cards<br/>[DoneCard.tsx]"]
  node_pip["Pip companion<br/>[Pip.tsx]"]
  node_motion["Motion preference<br/>[useStillMotion.ts]"]
end

subgraph group_processing["PDF processing"]
  node_pdfops["PDF operations"]
  node_compresslib["PDF compression<br/>[compress.ts]"]
  node_imageslib["Image conversion<br/>[images.ts]"]
  node_rotatepdf["PDF rotation<br/>[rotate.ts]"]
end

subgraph group_execution["Worker execution"]
  node_workerhooks["Worker job hooks<br/>[useWorkerJob.ts]"]
  node_workers["Tool workers"]
  node_failure["Worker failures<br/>[fail.ts]"]
  node_waitprogress["Wait progress<br/>[progress.ts]"]
  node_waitscene["Wait scene<br/>[JarScene.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_toolpage
node_app -->|"routes to"| node_notfound
node_home -->|"reads tools"| node_registry
node_home -.->|"offers navigation"| node_toolpage
node_toolpage -->|"looks up tool"| node_registry
node_toolpage -->|"dispatches merge"| node_merge
node_toolpage -->|"dispatches split"| node_split
node_toolpage -->|"dispatches rotate"| node_rotate
node_toolpage -->|"dispatches images"| node_images
node_toolpage -->|"dispatches signing"| node_sign
node_toolpage -->|"dispatches compression"| node_compress
node_toolpage -->|"fallback dispatch"| node_workbench
node_app -->|"renders"| node_header
node_workbench -->|"uses preview"| node_preview
node_preview -->|"validates files"| node_registry
node_preview -.->|"feeds file queue"| node_queue
node_compress -.->|"runs compression"| node_compresslib
node_images -.->|"creates PDF"| node_imageslib
node_rotate -.->|"rotates pages"| node_rotatepdf
node_workers -->|"processes PDF"| node_compresslib
node_workers -->|"converts images"| node_imageslib
node_workerhooks -->|"uses failure message"| node_failure
node_workerhooks -.->|"starts worker"| node_workers
node_sign -.->|"shows result"| node_results
node_split -.->|"shows result"| node_results
node_compress -.->|"shows result"| node_results
node_images -.->|"shows result"| node_results
node_rotate -.->|"shows result"| node_results
node_home -->|"renders companion"| node_pip
node_toolpage -->|"sets page title"| node_title
node_waitprogress -.->|"provides progress display"| node_waitscene
node_waitscene -.->|"depicts wait story"| node_pip
node_toolpage -->|"styles tool heading"| node_accent
node_pip -->|"respects motion preference"| node_motion

click node_app "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/App.tsx"
click node_home "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/Home.tsx"
click node_registry "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/tools.ts"
click node_toolpage "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/ToolPage.tsx"
click node_notfound "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/NotFound.tsx"
click node_header "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/layout/Header.tsx"
click node_workbench "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/drop/ToolWorkbench.tsx"
click node_preview "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/drop/preview.ts"
click node_queue "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/drop/useFileQueue.ts"
click node_merge "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/merge/MergeTool.tsx"
click node_split "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/split/SplitTool.tsx"
click node_rotate "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/rotate/RotateTool.tsx"
click node_images "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/images/ImagesTool.tsx"
click node_sign "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/sign/SignTool.tsx"
click node_compress "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/compress/CompressTool.tsx"
click node_results "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/result/DoneCard.tsx"
click node_pdfops "https://github.com/siddichandu02/privacy-toolkit/tree/main/src/lib/pdf"
click node_compresslib "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/lib/pdf/compress.ts"
click node_imageslib "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/lib/pdf/images.ts"
click node_rotatepdf "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/lib/pdf/rotate.ts"
click node_workerhooks "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/workers/useWorkerJob.ts"
click node_workers "https://github.com/siddichandu02/privacy-toolkit/tree/main/src/workers"
click node_failure "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/workers/fail.ts"
click node_pip "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/pip/Pip.tsx"
click node_waitprogress "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/wait/progress.ts"
click node_waitscene "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/wait/scenes/JarScene.tsx"
click node_accent "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/ui/accent.ts"
click node_title "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/useDocumentTitle.ts"
click node_motion "https://github.com/siddichandu02/privacy-toolkit/blob/main/src/useStillMotion.ts"

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_home,node_registry,node_toolpage,node_notfound,node_header,node_accent,node_title toneBlue
class node_workbench,node_preview,node_queue,node_merge,node_split,node_rotate,node_images,node_sign,node_compress,node_results,node_pip,node_motion toneAmber
class node_pdfops,node_compresslib,node_imageslib,node_rotatepdf toneMint
class node_workerhooks,node_workers,node_failure,node_waitprogress,node_waitscene toneRose
class node_visitor toneIndigo
```

## Components

### Navigation and discovery

- [App routes](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/App.tsx): `src/App.tsx`
- [Tool discovery](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/Home.tsx): `src/routes/Home.tsx`
- [Tool registry](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/tools.ts): `src/tools.ts`
- [Tool dispatch](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/ToolPage.tsx): `src/routes/ToolPage.tsx`
- [Not found](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/routes/NotFound.tsx): `src/routes/NotFound.tsx`
- [Site header](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/layout/Header.tsx): `src/components/layout/Header.tsx`
- [Tool accents](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/ui/accent.ts): `src/components/ui/accent.ts`
- [Page title](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/useDocumentTitle.ts): `src/useDocumentTitle.ts`

### File and tool workflow

- [File workbench](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/drop/ToolWorkbench.tsx): `src/components/drop/ToolWorkbench.tsx`
- [File preview](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/drop/preview.ts): `src/components/drop/preview.ts`
- [File queue](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/drop/useFileQueue.ts): `src/components/drop/useFileQueue.ts`
- [Merge PDFs](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/merge/MergeTool.tsx): `src/components/merge/MergeTool.tsx`
- [Split PDFs](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/split/SplitTool.tsx): `src/components/split/SplitTool.tsx`
- [Rotate pages](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/rotate/RotateTool.tsx): `src/components/rotate/RotateTool.tsx`
- [Images to PDF](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/images/ImagesTool.tsx): `src/components/images/ImagesTool.tsx`
- [Sign PDF](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/sign/SignTool.tsx): `src/components/sign/SignTool.tsx`
- [Compress PDF](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/compress/CompressTool.tsx): `src/components/compress/CompressTool.tsx`
- [Result cards](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/result/DoneCard.tsx): `src/components/result/DoneCard.tsx`
- [Pip companion](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/pip/Pip.tsx): `src/components/pip/Pip.tsx`
- [Motion preference](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/useStillMotion.ts): `src/useStillMotion.ts`

### PDF processing

- [PDF operations](https://github.com/siddichandu02/privacy-toolkit/tree/main/src/lib/pdf): `src/lib/pdf`
- [PDF compression](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/lib/pdf/compress.ts): `src/lib/pdf/compress.ts`
- [Image conversion](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/lib/pdf/images.ts): `src/lib/pdf/images.ts`
- [PDF rotation](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/lib/pdf/rotate.ts): `src/lib/pdf/rotate.ts`

### Worker execution

- [Worker job hooks](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/workers/useWorkerJob.ts): `src/workers/useWorkerJob.ts`
- [Tool workers](https://github.com/siddichandu02/privacy-toolkit/tree/main/src/workers): `src/workers`
- [Worker failures](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/workers/fail.ts): `src/workers/fail.ts`
- [Wait progress](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/wait/progress.ts): `src/components/wait/progress.ts`
- [Wait scene](https://github.com/siddichandu02/privacy-toolkit/blob/main/src/components/wait/scenes/JarScene.tsx): `src/components/wait/scenes/JarScene.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → App routes: opens
- App routes → Tool discovery: routes to (evidence: `src/App.tsx`)
- App routes → Tool dispatch: routes to (evidence: `src/App.tsx`)
- App routes → Not found: routes to (evidence: `src/App.tsx`)
- Tool discovery → Tool registry: reads tools (evidence: `src/routes/Home.tsx`)
- Tool discovery → Tool dispatch: offers navigation
- Tool dispatch → Tool registry: looks up tool (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → Merge PDFs: dispatches merge (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → Split PDFs: dispatches split (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → Rotate pages: dispatches rotate (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → Images to PDF: dispatches images (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → Sign PDF: dispatches signing (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → Compress PDF: dispatches compression (evidence: `src/routes/ToolPage.tsx`)
- Tool dispatch → File workbench: fallback dispatch (evidence: `src/routes/ToolPage.tsx`)
- App routes → Site header: renders (evidence: `src/App.tsx`)
- File workbench → File preview: uses preview (evidence: `src/components/drop/preview.ts`)
- File preview → Tool registry: validates files (evidence: `src/components/drop/preview.ts`)
- File preview → File queue: feeds file queue
- Compress PDF → PDF compression: runs compression
- Images to PDF → Image conversion: creates PDF
- Rotate pages → PDF rotation: rotates pages
- Tool workers → PDF compression: processes PDF (evidence: `src/workers/compress.worker.ts`)
- Tool workers → Image conversion: converts images (evidence: `src/workers/images.worker.ts`)
- Worker job hooks → Worker failures: uses failure message (evidence: `src/workers/useWorkerJob.ts`)
- Worker job hooks → Tool workers: starts worker (evidence: `src/workers/useWorkerJob.ts`)
- Sign PDF → Result cards: shows result
- Split PDFs → Result cards: shows result
- Compress PDF → Result cards: shows result
- Images to PDF → Result cards: shows result
- Rotate pages → Result cards: shows result
- Tool discovery → Pip companion: renders companion (evidence: `src/routes/Home.tsx`)
- Tool dispatch → Page title: sets page title (evidence: `src/routes/ToolPage.tsx`)
- Wait progress → Wait scene: provides progress display
- Wait scene → Pip companion: depicts wait story
- Tool dispatch → Tool accents: styles tool heading (evidence: `src/routes/ToolPage.tsx`)
- Pip companion → Motion preference: respects motion preference (evidence: `src/components/pip/Pip.tsx`)
