# prempoddar/oaf architecture

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

## Overview

OAF is an offline-first Android file manager, viewer, and editor. Users open files through the in-app browser, Android’s Open With flow, the document picker, or network storage; OAF detects the actual format, dispatches to a native viewer/editor, and saves supported changes locally. Its major branches include document and spreadsheet editing, media playback, image editing, archives, slides and EPUB, and network/file-management tools. The sampled sources establish app routing, detection, engine dispatch, and selected service behavior; README-described capabilities with unsampled implementations are shown without speculative internal call edges.

Main entry points: [`app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/engine/Engines.kt) (Engine registry), [`app/src/main/java/com/prempoddar/oaf/save/SaveAsActivity.kt`](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/save/SaveAsActivity.kt) (Save and export), [`app/src/main/java/com/prempoddar/oaf/MainActivity.kt`](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/MainActivity.kt) (App navigation), [`app/src/main/java/com/prempoddar/oaf/ui/browser/FilesHome.kt`](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/browser/FilesHome.kt) (File browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and files"]
  node_activity["App navigation<br/>[MainActivity.kt]"]
  node_browser["File browser<br/>[FilesHome.kt]"]
  node_storage["Local storage<br/>[Storage.kt]"]
  node_picker["Document picker<br/>[OafDocuments.kt]"]
end

subgraph group_routing["Open and dispatch"]
  node_source["Document source<br/>[DocSource.kt]"]
  node_detector["Format detection<br/>[Detector.kt]"]
  node_kind["File kinds<br/>[FileKind.kt]"]
  node_engines["Engine registry<br/>[Engines.kt]"]
  node_webengine["Web engines<br/>[WebEngine.kt]"]
end

subgraph group_formats["View and edit"]
  node_docview["Word documents<br/>[DocScreen.kt]"]
  node_pdf["PDF tools<br/>[PdfScreen.kt]"]
  node_sheets["Spreadsheets<br/>[Workbook.kt]"]
  node_slides["Slides and EPUB<br/>[Slides.kt]"]
  node_text["Text and code<br/>[Highlighter.kt]"]
  node_images["Image tools<br/>[ImageOps.kt]"]
  node_media["Media playback<br/>[MediaViewer.kt]"]
  node_archives["Archive tools<br/>[Archives.kt]"]
end

subgraph group_services["File services"]
  node_playback["Playback service<br/>[PlaybackService.kt]"]
  node_network["Network drives"]
  node_ftp["FTP sharing<br/>[FtpService.kt]"]
  node_search["Document search<br/>[ContentSearch.kt]"]
  node_scanner["Paper scanning<br/>[Scanner.kt]"]
  node_save["Save and export<br/>[SaveAsActivity.kt]"]
  node_print["Print to PDF<br/>[Printing.kt]"]
end

node_user(("User or external app"))

node_user -->|"opens file"| node_activity
node_user -->|"browses files"| node_browser
node_browser -->|"reads files"| node_storage
node_user -->|"picks file"| node_picker
node_activity -->|"opens source"| node_source
node_source -->|"detects format"| node_detector
node_detector -->|"returns kind"| node_kind
node_activity -->|"routes viewer"| node_engines
node_engines -->|"dispatches by kind"| node_kind
node_engines -.->|"supports plugins"| node_webengine
node_engines -->|"selects viewer"| node_docview
node_engines -->|"selects viewer"| node_pdf
node_engines -->|"selects viewer"| node_media
node_user -->|"opens drive"| node_network
node_browser -->|"browses remote files"| node_network
node_media -.->|"plays media"| node_playback
node_user -->|"shares over Wi-Fi"| node_ftp
node_user -->|"searches contents"| node_search
node_user -->|"scans paper"| node_scanner
node_docview -->|"saves edits"| node_save
node_pdf -->|"saves edits"| node_save
node_sheets -->|"saves edits"| node_save
node_images -->|"exports images"| node_save
node_user -->|"prints document"| node_print

click node_activity "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/MainActivity.kt"
click node_browser "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/browser/FilesHome.kt"
click node_storage "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/browser/Storage.kt"
click node_picker "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/pick/OafDocuments.kt"
click node_source "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/io/DocSource.kt"
click node_detector "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/format/Detector.kt"
click node_kind "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/format/FileKind.kt"
click node_engines "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/engine/Engines.kt"
click node_webengine "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/engine/WebEngine.kt"
click node_docview "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/viewers/DocScreen.kt"
click node_pdf "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/viewers/pdf/PdfScreen.kt"
click node_sheets "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/sheet/Workbook.kt"
click node_slides "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/slides/Slides.kt"
click node_text "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/text/Highlighter.kt"
click node_images "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/edit/ImageOps.kt"
click node_media "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/viewers/MediaViewer.kt"
click node_playback "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/media/PlaybackService.kt"
click node_archives "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/archive/Archives.kt"
click node_network "https://github.com/prempoddar/oaf/tree/main/app/src/main/java/com/prempoddar/oaf/files/remote"
click node_ftp "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/files/FtpService.kt"
click node_search "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/files/ContentSearch.kt"
click node_scanner "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/scan/Scanner.kt"
click node_save "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/save/SaveAsActivity.kt"
click node_print "https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/export/Printing.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_browser,node_storage,node_picker,node_user toneBlue
class node_source,node_detector,node_kind,node_engines,node_webengine toneAmber
class node_docview,node_pdf,node_sheets,node_slides,node_text,node_images,node_media,node_archives toneMint
class node_playback,node_network,node_ftp,node_search,node_scanner,node_save,node_print toneRose
```

## Components

### App entry and files

- [App navigation](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/MainActivity.kt): `app/src/main/java/com/prempoddar/oaf/MainActivity.kt`
- [File browser](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/browser/FilesHome.kt): `app/src/main/java/com/prempoddar/oaf/ui/browser/FilesHome.kt`
- [Local storage](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/browser/Storage.kt): `app/src/main/java/com/prempoddar/oaf/ui/browser/Storage.kt`
- [Document picker](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/pick/OafDocuments.kt): `app/src/main/java/com/prempoddar/oaf/pick/OafDocuments.kt`

### Open and dispatch

- [Document source](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/io/DocSource.kt): `app/src/main/java/com/prempoddar/oaf/io/DocSource.kt`
- [Format detection](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/format/Detector.kt): `app/src/main/java/com/prempoddar/oaf/format/Detector.kt`
- [File kinds](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/format/FileKind.kt): `app/src/main/java/com/prempoddar/oaf/format/FileKind.kt`
- [Engine registry](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/engine/Engines.kt): `app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`
- [Web engines](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/engine/WebEngine.kt): `app/src/main/java/com/prempoddar/oaf/engine/WebEngine.kt`

### View and edit

- [Word documents](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/viewers/DocScreen.kt): `app/src/main/java/com/prempoddar/oaf/ui/viewers/DocScreen.kt`
- [PDF tools](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/viewers/pdf/PdfScreen.kt): `app/src/main/java/com/prempoddar/oaf/ui/viewers/pdf/PdfScreen.kt`
- [Spreadsheets](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/sheet/Workbook.kt): `app/src/main/java/com/prempoddar/oaf/sheet/Workbook.kt`
- [Slides and EPUB](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/slides/Slides.kt): `app/src/main/java/com/prempoddar/oaf/slides/Slides.kt`
- [Text and code](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/text/Highlighter.kt): `app/src/main/java/com/prempoddar/oaf/text/Highlighter.kt`
- [Image tools](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/edit/ImageOps.kt): `app/src/main/java/com/prempoddar/oaf/edit/ImageOps.kt`
- [Media playback](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/ui/viewers/MediaViewer.kt): `app/src/main/java/com/prempoddar/oaf/ui/viewers/MediaViewer.kt`
- [Archive tools](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/archive/Archives.kt): `app/src/main/java/com/prempoddar/oaf/archive/Archives.kt`

### File services

- [Playback service](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/media/PlaybackService.kt): `app/src/main/java/com/prempoddar/oaf/media/PlaybackService.kt`
- [Network drives](https://github.com/prempoddar/oaf/tree/main/app/src/main/java/com/prempoddar/oaf/files/remote): `app/src/main/java/com/prempoddar/oaf/files/remote`
- [FTP sharing](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/files/FtpService.kt): `app/src/main/java/com/prempoddar/oaf/files/FtpService.kt`
- [Document search](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/files/ContentSearch.kt): `app/src/main/java/com/prempoddar/oaf/files/ContentSearch.kt`
- [Paper scanning](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/scan/Scanner.kt): `app/src/main/java/com/prempoddar/oaf/scan/Scanner.kt`
- [Save and export](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/save/SaveAsActivity.kt): `app/src/main/java/com/prempoddar/oaf/save/SaveAsActivity.kt`
- [Print to PDF](https://github.com/prempoddar/oaf/blob/main/app/src/main/java/com/prempoddar/oaf/export/Printing.kt): `app/src/main/java/com/prempoddar/oaf/export/Printing.kt`

### Other components

- **User or external app**

## Connections

- User or external app → App navigation: opens file
- User or external app → File browser: browses files
- File browser → Local storage: reads files
- User or external app → Document picker: picks file
- App navigation → Document source: opens source (evidence: `app/src/main/java/com/prempoddar/oaf/MainActivity.kt`)
- Document source → Format detection: detects format (evidence: `app/src/main/java/com/prempoddar/oaf/io/DocSource.kt`)
- Format detection → File kinds: returns kind (evidence: `app/src/main/java/com/prempoddar/oaf/format/Detector.kt`)
- App navigation → Engine registry: routes viewer
- Engine registry → File kinds: dispatches by kind (evidence: `app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`)
- Engine registry → Web engines: supports plugins (evidence: `app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`)
- Engine registry → Word documents: selects viewer (evidence: `app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`)
- Engine registry → PDF tools: selects viewer (evidence: `app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`)
- Engine registry → Media playback: selects viewer (evidence: `app/src/main/java/com/prempoddar/oaf/engine/Engines.kt`)
- User or external app → Network drives: opens drive
- File browser → Network drives: browses remote files
- Media playback → Playback service: plays media
- User or external app → FTP sharing: shares over Wi-Fi
- User or external app → Document search: searches contents
- User or external app → Paper scanning: scans paper
- Word documents → Save and export: saves edits
- PDF tools → Save and export: saves edits
- Spreadsheets → Save and export: saves edits
- Image tools → Save and export: exports images
- User or external app → Print to PDF: prints document
