# 76eren/mangly architecture

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

## Overview

Mangly is an Android manga/comic reader whose content comes from separately built, imported extensions. The main user workflow is to choose an extension, search for a title, open its chapters, and read pages; the app also supports a local library, reading history, and queued chapter downloads. The graph preserves those major product areas plus backup and persistent state. Evidence is limited to the README, the supplied excerpts, and SOURCE INDEX references; unsampled implementation details are represented only where paths are supported.

Main entry points: [`composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt) (Reader), [`composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt`](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt) (App database), [`composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt`](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt) (File manager), [`composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt`](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt) (Extension runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_reader["Reader"]
end

subgraph group_content["Extensions and discovery"]
  node_extensions_ui["Extensions UI<br/>[Extensions.kt]"]
  node_extension_details["Extension details"]
  node_search_ui["Search screen"]
  node_search_query["Source search"]
  node_extension_runtime["Extension runtime"]
  node_source_api["Source API<br/>[Source.kt]"]
  node_extension_metadata["Extension metadata"]
end

subgraph group_reading["Reading experience"]
  node_chapters["Chapter list"]
  node_read_screen["Read screen<br/>[Read.kt]"]
  node_reader_modes["Reader modes"]
end

subgraph group_library["Library and downloads"]
  node_home["Home library"]
  node_history_ui["History"]
  node_downloads_ui["Downloads UI"]
  node_download_manager["Download manager<br/>[DownloadManager.kt]"]
  node_download_worker["Download worker"]
  node_download_request["Worker request"]
end

subgraph group_storage["Persistence and backup"]
  node_file_manager["File manager<br/>[FileManager.kt]"]
  node_database[("App database<br/>[AppDatabase.kt]")]
  node_data_models["Room entities"]
  node_downloads_dao["Downloads DAO<br/>[DownloadsDao.kt]"]
  node_favorites_dao["Favorites DAO<br/>[FavoritesDao.kt]"]
  node_history_dao["History DAO<br/>[HistoryDao.kt]"]
  node_backup_export["Backup export"]
  node_backup_import["Backup import"]
end

node_user(("Reader"))

node_user -->|"uses"| node_reader
node_reader -->|"routes to"| node_home
node_reader -->|"routes to"| node_extensions_ui
node_reader -->|"routes to"| node_extension_details
node_reader -->|"routes to"| node_search_ui
node_reader -->|"routes to"| node_chapters
node_reader -->|"routes to"| node_read_screen
node_search_query -->|"queries via"| node_source_api
node_extension_runtime -->|"extracts"| node_extension_metadata
node_extension_runtime -->|"loads"| node_source_api
node_extension_details -->|"manages"| node_extension_runtime
node_download_manager -->|"saves files"| node_file_manager
node_download_manager -->|"updates records"| node_downloads_dao
node_download_manager -->|"fetches chapter images"| node_source_api
node_download_manager -->|"reads source metadata"| node_extension_metadata
node_download_worker -->|"reads request"| node_download_request
node_download_worker -->|"loads extension"| node_extension_runtime
node_download_worker -->|"extracts metadata"| node_extension_metadata
node_file_manager -->|"extracts metadata"| node_extension_runtime
node_file_manager -->|"reads records"| node_downloads_dao
node_file_manager -->|"reads records"| node_favorites_dao
node_file_manager -->|"deletes records"| node_history_dao
node_database -->|"registers entities"| node_data_models
node_database -->|"exposes"| node_downloads_dao
node_database -->|"exposes"| node_favorites_dao
node_database -->|"exposes"| node_history_dao
node_backup_export -->|"exports state"| node_database
node_backup_import -->|"imports state"| node_database

click node_reader "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt"
click node_home "https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/home"
click node_extensions_ui "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/Extensions.kt"
click node_extension_details "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/ExtensionDetails.kt"
click node_search_ui "https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/search"
click node_search_query "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/search/SearchSourceQuery.kt"
click node_extension_runtime "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt"
click node_source_api "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/manglyextension/plugins/Source.kt"
click node_extension_metadata "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/manglyextension/plugins/ExtensionMetadata.kt"
click node_chapters "https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/chapterslist"
click node_read_screen "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/read/Read.kt"
click node_reader_modes "https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/readviewer"
click node_history_ui "https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/history"
click node_downloads_ui "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadQueuePanel.kt"
click node_download_manager "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt"
click node_download_worker "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/workers/ChapterDownloadWorker.kt"
click node_download_request "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/models/DownloadWorkerRequest.kt"
click node_file_manager "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt"
click node_database "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt"
click node_data_models "https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/entities"
click node_downloads_dao "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/DownloadsDao.kt"
click node_favorites_dao "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/FavoritesDao.kt"
click node_history_dao "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/HistoryDao.kt"
click node_backup_export "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupExportManager.kt"
click node_backup_import "https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupImportManager.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_reader toneBlue
class node_extensions_ui,node_extension_details,node_search_ui,node_search_query,node_extension_runtime,node_source_api,node_extension_metadata toneAmber
class node_chapters,node_read_screen,node_reader_modes toneMint
class node_home,node_history_ui,node_downloads_ui,node_download_manager,node_download_worker,node_download_request toneRose
class node_file_manager,node_database,node_data_models,node_downloads_dao,node_favorites_dao,node_history_dao,node_backup_export,node_backup_import,node_user toneIndigo
```

## Components

### App navigation

- [Reader](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`

### Extensions and discovery

- [Extensions UI](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/Extensions.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/Extensions.kt`
- [Extension details](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/ExtensionDetails.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/ExtensionDetails.kt`
- [Search screen](https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/search): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/search`
- [Source search](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/search/SearchSourceQuery.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/search/SearchSourceQuery.kt`
- [Extension runtime](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt`
- [Source API](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/manglyextension/plugins/Source.kt): `composeApp/src/androidMain/kotlin/com/eren76/manglyextension/plugins/Source.kt`
- [Extension metadata](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/manglyextension/plugins/ExtensionMetadata.kt): `composeApp/src/androidMain/kotlin/com/eren76/manglyextension/plugins/ExtensionMetadata.kt`

### Reading experience

- [Chapter list](https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/chapterslist): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/chapterslist`
- [Read screen](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/read/Read.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/read/Read.kt`
- [Reader modes](https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/readviewer): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/readviewer`

### Library and downloads

- [Home library](https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/home): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/home`
- [History](https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/history): `composeApp/src/androidMain/kotlin/com/eren76/mangly/composables/screens/history`
- [Downloads UI](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadQueuePanel.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadQueuePanel.kt`
- [Download manager](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt`
- [Download worker](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/workers/ChapterDownloadWorker.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/workers/ChapterDownloadWorker.kt`
- [Worker request](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/models/DownloadWorkerRequest.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/models/DownloadWorkerRequest.kt`

### Persistence and backup

- [File manager](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt`
- [App database](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt`
- [Room entities](https://github.com/76eren/mangly/tree/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/entities): `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/entities`
- [Downloads DAO](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/DownloadsDao.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/DownloadsDao.kt`
- [Favorites DAO](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/FavoritesDao.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/FavoritesDao.kt`
- [History DAO](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/HistoryDao.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/dao/HistoryDao.kt`
- [Backup export](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupExportManager.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupExportManager.kt`
- [Backup import](https://github.com/76eren/mangly/blob/main/composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupImportManager.kt): `composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupImportManager.kt`

### Other components

- **Reader**

## Connections

- Reader → Reader: uses (evidence: `README.md`)
- Reader → Home library: routes to (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`)
- Reader → Extensions UI: routes to (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`)
- Reader → Extension details: routes to (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`)
- Reader → Search screen: routes to (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`)
- Reader → Chapter list: routes to (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`)
- Reader → Read screen: routes to (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/navigation/NavHostController.kt`)
- Source search → Source API: queries via (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/search/SearchSourceQuery.kt`)
- Extension runtime → Extension metadata: extracts (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt`)
- Extension runtime → Source API: loads (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt`)
- Extension details → Extension runtime: manages (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/ExtensionManager.kt`)
- Download manager → File manager: saves files (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt`)
- Download manager → Downloads DAO: updates records (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt`)
- Download manager → Source API: fetches chapter images (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt`)
- Download manager → Extension metadata: reads source metadata (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/downloads/DownloadManager.kt`)
- Download worker → Worker request: reads request (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/workers/ChapterDownloadWorker.kt`)
- Download worker → Extension runtime: loads extension (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/workers/ChapterDownloadWorker.kt`)
- Download worker → Extension metadata: extracts metadata (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/workers/ChapterDownloadWorker.kt`)
- File manager → Extension runtime: extracts metadata (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt`)
- File manager → Downloads DAO: reads records (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt`)
- File manager → Favorites DAO: reads records (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt`)
- File manager → History DAO: deletes records (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/FileManager.kt`)
- App database → Room entities: registers entities (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt`)
- App database → Downloads DAO: exposes (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt`)
- App database → Favorites DAO: exposes (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt`)
- App database → History DAO: exposes (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/rooms/database/AppDatabase.kt`)
- Backup export → App database: exports state (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupExportManager.kt`)
- Backup import → App database: imports state (evidence: `composeApp/src/androidMain/kotlin/com/eren76/mangly/BackupImportManager.kt`)
