# nar7407/pdfpaper architecture

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

- Interactive diagram: https://gitdiagram.com/nar7407/pdfpaper
- Repository: https://github.com/nar7407/pdfpaper

## Overview

PDFPaper is an on-device Android PDF reader/editor built around a Kotlin PDF engine. The primary workflow is selecting or receiving a document, opening it in the viewer, rendering and searching its contents, then saving changes. The repository also includes page operations, indexing, speech, safety inspection, signing, office conversion, and related tools. Some README features are marked planned despite corresponding source directories being present. Edges are limited to README statements and relationships visible in the supplied source index or excerpts; unsampled wiring is not inferred.

Main entry points: [`app/src/main/java/com/pdfpaper/app/ui/viewer/ViewerScreen.kt`](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/viewer/ViewerScreen.kt) (PDF viewer), [`engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt`](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt) (PDF document model), [`app/src/main/java/com/pdfpaper/app/MainActivity.kt`](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/MainActivity.kt) (App entry), [`app/src/main/java/com/pdfpaper/app/ui/navigation/AppNav.kt`](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/navigation/AppNav.kt) (App navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNav.kt]"]
  node_viewer["PDF viewer<br/>[ViewerScreen.kt]"]
  node_documentaccess["Document access<br/>[DocumentAccess.kt]"]
  node_pdfengineapp["App PDF adapter<br/>[PdfEngine.kt]"]
  node_renderer["Android rendering<br/>[AndroidRenderer.kt]"]
end

subgraph group_engine["PDF engine"]
  node_engineapi["PDF engine<br/>[PdfEngine.kt]"]
  node_pdfdocument["PDF document model<br/>[PdfDocument.kt]"]
  node_randomsource["Random access input"]
  node_pdfobjects["PDF objects<br/>[PdfObject.kt]"]
  node_security["PDF decryption"]
  node_regex["Regex search<br/>[RegexSearch.kt]"]
end

subgraph group_documents["Document capabilities"]
  node_pageops["Page operations<br/>[PagesViewModel.kt]"]
  node_save["Save changes<br/>[SaveCoordinator.kt]"]
  node_searchindex[("Search index<br/>[IndexRepository.kt]")]
  node_annotations[("Annotation index")]
end

subgraph group_extras["Extended features"]
  node_safety["Safety inspection<br/>[PdfSafety.kt]"]
  node_signing["Digital signing<br/>[SigningEngine.kt]"]
  node_office["Office conversion"]
  node_speech["Read aloud"]
  node_speechcontroller["Speech controls"]
end

node_user(("User"))

node_user -->|"opens app"| node_activity
node_activity -->|"starts navigation"| node_navigation
node_navigation -->|"routes to viewer"| node_viewer
node_user -->|"selects document"| node_documentaccess
node_documentaccess -->|"provides document"| node_pdfengineapp
node_pdfengineapp -->|"uses engine"| node_engineapi
node_engineapi -.->|"opens PDF"| node_pdfdocument
node_pdfdocument -->|"reads bytes"| node_randomsource
node_pdfdocument -->|"resolves objects"| node_pdfobjects
node_pdfdocument -->|"decrypts objects"| node_security
node_viewer -.->|"renders pages"| node_renderer
node_viewer -.->|"searches text"| node_regex
node_user -->|"manages pages"| node_pageops
node_user -->|"saves changes"| node_save
node_user -.->|"searches PDFs"| node_searchindex
node_user -.->|"manages annotations"| node_annotations
node_user -.->|"inspects document"| node_safety
node_user -.->|"signs document"| node_signing
node_user -.->|"converts document"| node_office
node_viewer -.->|"controls reading"| node_speechcontroller
node_speechcontroller -.->|"starts playback"| node_speech

click node_activity "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/MainActivity.kt"
click node_navigation "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/navigation/AppNav.kt"
click node_viewer "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/viewer/ViewerScreen.kt"
click node_documentaccess "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/data/DocumentAccess.kt"
click node_pdfengineapp "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/edit/PdfEngine.kt"
click node_engineapi "https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/PdfEngine.kt"
click node_pdfdocument "https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt"
click node_randomsource "https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/io/RandomAccessSource.kt"
click node_pdfobjects "https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/model/PdfObject.kt"
click node_security "https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/security/StandardSecurityHandler.kt"
click node_regex "https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/text/RegexSearch.kt"
click node_renderer "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/render/AndroidRenderer.kt"
click node_pageops "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/pages/PagesViewModel.kt"
click node_save "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/data/save/SaveCoordinator.kt"
click node_searchindex "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/index/IndexRepository.kt"
click node_annotations "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/annot/AnnotationRepository.kt"
click node_safety "https://github.com/nar7407/pdfpaper/blob/main/safety/src/main/java/com/pdfpaper/safety/PdfSafety.kt"
click node_signing "https://github.com/nar7407/pdfpaper/blob/main/signatures/src/main/java/com/pdfpaper/signatures/SigningEngine.kt"
click node_speech "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/speech/ReadAloudService.kt"
click node_speechcontroller "https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/viewer/speech/ReadAloudController.kt"

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_activity,node_navigation,node_viewer,node_documentaccess,node_pdfengineapp,node_renderer,node_user toneBlue
class node_engineapi,node_pdfdocument,node_randomsource,node_pdfobjects,node_security,node_regex toneAmber
class node_pageops,node_save,node_searchindex,node_annotations toneMint
class node_safety,node_signing,node_office,node_speech,node_speechcontroller toneRose
```

## Components

### Android app

- [App entry](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/MainActivity.kt): `app/src/main/java/com/pdfpaper/app/MainActivity.kt`
- [App navigation](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/navigation/AppNav.kt): `app/src/main/java/com/pdfpaper/app/ui/navigation/AppNav.kt`
- [PDF viewer](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/viewer/ViewerScreen.kt): `app/src/main/java/com/pdfpaper/app/ui/viewer/ViewerScreen.kt`
- [Document access](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/data/DocumentAccess.kt): `app/src/main/java/com/pdfpaper/app/data/DocumentAccess.kt`
- [App PDF adapter](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/edit/PdfEngine.kt): `app/src/main/java/com/pdfpaper/app/edit/PdfEngine.kt`
- [Android rendering](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/render/AndroidRenderer.kt): `app/src/main/java/com/pdfpaper/app/render/AndroidRenderer.kt`

### PDF engine

- [PDF engine](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/PdfEngine.kt): `engine/src/main/java/com/pdfpaper/engine/PdfEngine.kt`
- [PDF document model](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt): `engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt`
- [Random access input](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/io/RandomAccessSource.kt): `engine/src/main/java/com/pdfpaper/engine/io/RandomAccessSource.kt`
- [PDF objects](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/model/PdfObject.kt): `engine/src/main/java/com/pdfpaper/engine/model/PdfObject.kt`
- [PDF decryption](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/security/StandardSecurityHandler.kt): `engine/src/main/java/com/pdfpaper/engine/security/StandardSecurityHandler.kt`
- [Regex search](https://github.com/nar7407/pdfpaper/blob/main/engine/src/main/java/com/pdfpaper/engine/text/RegexSearch.kt): `engine/src/main/java/com/pdfpaper/engine/text/RegexSearch.kt`

### Document capabilities

- [Page operations](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/pages/PagesViewModel.kt): `app/src/main/java/com/pdfpaper/app/ui/pages/PagesViewModel.kt`
- [Save changes](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/data/save/SaveCoordinator.kt): `app/src/main/java/com/pdfpaper/app/data/save/SaveCoordinator.kt`
- [Search index](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/index/IndexRepository.kt): `app/src/main/java/com/pdfpaper/app/index/IndexRepository.kt`
- [Annotation index](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/annot/AnnotationRepository.kt): `app/src/main/java/com/pdfpaper/app/annot/AnnotationRepository.kt`

### Extended features

- [Safety inspection](https://github.com/nar7407/pdfpaper/blob/main/safety/src/main/java/com/pdfpaper/safety/PdfSafety.kt): `safety/src/main/java/com/pdfpaper/safety/PdfSafety.kt`
- [Digital signing](https://github.com/nar7407/pdfpaper/blob/main/signatures/src/main/java/com/pdfpaper/signatures/SigningEngine.kt): `signatures/src/main/java/com/pdfpaper/signatures/SigningEngine.kt`
- **Office conversion**
- [Read aloud](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/speech/ReadAloudService.kt): `app/src/main/java/com/pdfpaper/app/speech/ReadAloudService.kt`
- [Speech controls](https://github.com/nar7407/pdfpaper/blob/main/app/src/main/java/com/pdfpaper/app/ui/viewer/speech/ReadAloudController.kt): `app/src/main/java/com/pdfpaper/app/ui/viewer/speech/ReadAloudController.kt`

### Other components

- **User**

## Connections

- User → App entry: opens app (evidence: `README.md`)
- App entry → App navigation: starts navigation (evidence: `app/src/main/java/com/pdfpaper/app/MainActivity.kt`)
- App navigation → PDF viewer: routes to viewer
- User → Document access: selects document (evidence: `README.md`)
- Document access → App PDF adapter: provides document
- App PDF adapter → PDF engine: uses engine (evidence: `README.md`)
- PDF engine → PDF document model: opens PDF
- PDF document model → Random access input: reads bytes (evidence: `engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt`)
- PDF document model → PDF objects: resolves objects (evidence: `engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt`)
- PDF document model → PDF decryption: decrypts objects (evidence: `engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt`)
- PDF viewer → Android rendering: renders pages
- PDF viewer → Regex search: searches text
- User → Page operations: manages pages (evidence: `README.md`)
- User → Save changes: saves changes (evidence: `README.md`)
- User → Search index: searches PDFs
- User → Annotation index: manages annotations
- User → Safety inspection: inspects document
- User → Digital signing: signs document
- User → Office conversion: converts document
- PDF viewer → Speech controls: controls reading
- Speech controls → Read aloud: starts playback
