# nokkum/ranobe architecture

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

- Interactive diagram: https://gitdiagram.com/nokkum/ranobe
- Repository: https://github.com/nokkum/ranobe

## Overview

Ranobe is an extensible Android light-novel reader. Readers browse multilingual sources or search by keyword, open novel details and chapter lists, then read chapters with configurable presentation; library, offline downloads, and reading history support return visits. Source adapters and a repository mediate catalog and chapter requests, while Room stores library and reading state. The README documents capabilities beyond the sampled implementation. Some UI, persistence, and background-worker wiring is unsampled, so those connections are omitted rather than inferred.

Main entry points: [`app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java`](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java) (Reader view), [`app/src/main/java/org/ranobe/ranobe/database/RanobeDatabase.java`](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/database/RanobeDatabase.java) (Room database), [`app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java`](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java) (Source repository), [`app/src/main/java/org/ranobe/ranobe/ui/browse/Browse.java`](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/browse/Browse.java) (Browse)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery"]
  node_browse["Browse<br/>[Browse.java]"]
  node_search["Keyword search<br/>[Search.java]"]
  node_filters["Search filters<br/>[SearchFilters.java]"]
  node_source_selection["Source selection<br/>[Explore.java]"]
end

subgraph group_sources["Sources and retrieval"]
  node_repository["Source repository<br/>[Repository.java]"]
  node_source_manager["Source registry<br/>[SourceManager.java]"]
  node_source_contract["Source contract<br/>[Source.java]"]
  node_source_adapters["Source adapters"]
  node_wtrlab["WTR-LAB adapter<br/>[WtrLab.java]"]
  node_http["HTTP client<br/>[HttpClient.java]"]
end

subgraph group_reading["Reading"]
  node_details["Novel details<br/>[Details.java]"]
  node_chapters["Chapter list<br/>[Chapters.java]"]
  node_reader_ui["Reader view"]
  node_reader_pages["Reader pages<br/>[PageAdapter.java]"]
  node_reader_customization["Reader customization"]
end

subgraph group_state["Library and state"]
  node_download_service["Offline downloads"]
  node_library["Library<br/>[Library.java]"]
  node_history["Reading history<br/>[History.java]"]
  node_database[("Room database")]
end

subgraph group_operations["Settings and updates"]
  node_main["App startup<br/>[App.java]"]
  node_settings["Preferences<br/>[Ranobe.java]"]
  node_updates["Chapter updates"]
end

node_reader(("Reader"))
node_novel_sites["Novel websites"]

node_reader -->|"browses"| node_browse
node_reader -->|"searches"| node_search
node_reader -->|"selects sources"| node_source_selection
node_browse -->|"opens novels"| node_details
node_search -->|"uses filters"| node_filters
node_details -->|"views chapters"| node_chapters
node_chapters -->|"opens chapter"| node_reader_ui
node_reader_ui -->|"renders pages"| node_reader_pages
node_reader_ui -->|"opens settings"| node_reader_customization
node_source_manager -->|"registers sources"| node_source_adapters
node_source_adapters -->|"implement contract"| node_source_contract
node_repository -->|"selects source"| node_source_manager
node_repository -->|"requests catalog"| node_source_contract
node_wtrlab -->|"sends requests"| node_http
node_http -.->|"fetches content"| node_novel_sites
node_reader -->|"saves novels"| node_library
node_reader -->|"downloads chapters"| node_download_service
node_reader -->|"tracks reading"| node_history
node_library -->|"persists library"| node_database
node_history -->|"persists history"| node_database
node_download_service -->|"stores chapters"| node_database
node_reader -->|"customizes reading"| node_settings
node_main -->|"schedules checks"| node_updates

click node_main "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/App.java"
click node_browse "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/browse/Browse.java"
click node_search "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/search/Search.java"
click node_filters "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/util/SearchFilters.java"
click node_source_selection "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/explore/Explore.java"
click node_details "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/details/Details.java"
click node_chapters "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/chapters/Chapters.java"
click node_reader_ui "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java"
click node_reader_pages "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/adapter/PageAdapter.java"
click node_reader_customization "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/sheet/CustomizeReader.java"
click node_repository "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java"
click node_source_manager "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/sources/SourceManager.java"
click node_source_contract "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/sources/Source.java"
click node_source_adapters "https://github.com/nokkum/ranobe/tree/main/app/src/main/java/org/ranobe/ranobe/sources"
click node_wtrlab "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/sources/en/WtrLab.java"
click node_http "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/network/HttpClient.java"
click node_download_service "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/service/DownloadService.java"
click node_library "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/library/Library.java"
click node_history "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/history/History.java"
click node_database "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/database/RanobeDatabase.java"
click node_settings "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/config/Ranobe.java"
click node_updates "https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/worker/ChapterUpdateWorker.java"

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_browse,node_search,node_filters,node_source_selection toneBlue
class node_repository,node_source_manager,node_source_contract,node_source_adapters,node_wtrlab,node_http toneAmber
class node_details,node_chapters,node_reader_ui,node_reader_pages,node_reader_customization toneMint
class node_download_service,node_library,node_history,node_database toneRose
class node_main,node_settings,node_updates,node_reader,node_novel_sites toneIndigo
```

## Components

### Discovery

- [Browse](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/browse/Browse.java): `app/src/main/java/org/ranobe/ranobe/ui/browse/Browse.java`
- [Keyword search](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/search/Search.java): `app/src/main/java/org/ranobe/ranobe/ui/search/Search.java`
- [Search filters](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/util/SearchFilters.java): `app/src/main/java/org/ranobe/ranobe/util/SearchFilters.java`
- [Source selection](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/explore/Explore.java): `app/src/main/java/org/ranobe/ranobe/ui/explore/Explore.java`

### Sources and retrieval

- [Source repository](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java): `app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java`
- [Source registry](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/sources/SourceManager.java): `app/src/main/java/org/ranobe/ranobe/sources/SourceManager.java`
- [Source contract](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/sources/Source.java): `app/src/main/java/org/ranobe/ranobe/sources/Source.java`
- [Source adapters](https://github.com/nokkum/ranobe/tree/main/app/src/main/java/org/ranobe/ranobe/sources): `app/src/main/java/org/ranobe/ranobe/sources`
- [WTR-LAB adapter](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/sources/en/WtrLab.java): `app/src/main/java/org/ranobe/ranobe/sources/en/WtrLab.java`
- [HTTP client](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/network/HttpClient.java): `app/src/main/java/org/ranobe/ranobe/network/HttpClient.java`

### Reading

- [Novel details](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/details/Details.java): `app/src/main/java/org/ranobe/ranobe/ui/details/Details.java`
- [Chapter list](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/chapters/Chapters.java): `app/src/main/java/org/ranobe/ranobe/ui/chapters/Chapters.java`
- [Reader view](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java): `app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java`
- [Reader pages](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/adapter/PageAdapter.java): `app/src/main/java/org/ranobe/ranobe/ui/reader/adapter/PageAdapter.java`
- [Reader customization](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/reader/sheet/CustomizeReader.java): `app/src/main/java/org/ranobe/ranobe/ui/reader/sheet/CustomizeReader.java`

### Library and state

- [Offline downloads](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/service/DownloadService.java): `app/src/main/java/org/ranobe/ranobe/service/DownloadService.java`
- [Library](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/library/Library.java): `app/src/main/java/org/ranobe/ranobe/ui/library/Library.java`
- [Reading history](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/ui/history/History.java): `app/src/main/java/org/ranobe/ranobe/ui/history/History.java`
- [Room database](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/database/RanobeDatabase.java): `app/src/main/java/org/ranobe/ranobe/database/RanobeDatabase.java`

### Settings and updates

- [App startup](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/App.java): `app/src/main/java/org/ranobe/ranobe/App.java`
- [Preferences](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/config/Ranobe.java): `app/src/main/java/org/ranobe/ranobe/config/Ranobe.java`
- [Chapter updates](https://github.com/nokkum/ranobe/blob/main/app/src/main/java/org/ranobe/ranobe/worker/ChapterUpdateWorker.java): `app/src/main/java/org/ranobe/ranobe/worker/ChapterUpdateWorker.java`

### Other components

- **Reader**
- **Novel websites**

## Connections

- Reader → Browse: browses (evidence: `README.md`)
- Reader → Keyword search: searches (evidence: `README.md`)
- Reader → Source selection: selects sources (evidence: `README.md`)
- Browse → Novel details: opens novels (evidence: `README.md`)
- Keyword search → Search filters: uses filters (evidence: `app/src/main/java/org/ranobe/ranobe/ui/search/Search.java`)
- Novel details → Chapter list: views chapters (evidence: `README.md`)
- Chapter list → Reader view: opens chapter (evidence: `README.md`)
- Reader view → Reader pages: renders pages (evidence: `app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java`)
- Reader view → Reader customization: opens settings (evidence: `app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java`)
- Source registry → Source adapters: registers sources (evidence: `app/src/main/java/org/ranobe/ranobe/sources/SourceManager.java`)
- Source adapters → Source contract: implement contract (evidence: `app/src/main/java/org/ranobe/ranobe/sources/Source.java`)
- Source repository → Source registry: selects source (evidence: `app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java`)
- Source repository → Source contract: requests catalog (evidence: `app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java`)
- WTR-LAB adapter → HTTP client: sends requests (evidence: `app/src/main/java/org/ranobe/ranobe/sources/en/WtrLab.java`)
- HTTP client → Novel websites: fetches content
- Reader → Library: saves novels (evidence: `README.md`)
- Reader → Offline downloads: downloads chapters (evidence: `README.md`)
- Reader → Reading history: tracks reading (evidence: `README.md`)
- Library → Room database: persists library (evidence: `README.md`)
- Reading history → Room database: persists history (evidence: `README.md`)
- Offline downloads → Room database: stores chapters (evidence: `app/src/main/java/org/ranobe/ranobe/service/DownloadService.java`)
- Reader → Preferences: customizes reading (evidence: `README.md`)
- App startup → Chapter updates: schedules checks (evidence: `app/src/main/java/org/ranobe/ranobe/App.java`)
