# josuebarretogit/manga-tui architecture

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

- Interactive diagram: https://gitdiagram.com/josuebarretogit/manga-tui
- Repository: https://github.com/josuebarretogit/manga-tui

## Overview

Manga-tui is a terminal manga reader and downloader. Users select a provider, search or browse manga, open chapters in the reader, and can download chapters or whole series; reading history is stored locally, with optional AniList tracking. The README also documents provider filters, language selection, multiple download formats, and terminal image rendering. The graph preserves those capabilities, but several connections are dashed where the supplied excerpts and reference index do not establish exact runtime calls.

Main entry points: [`src/view/pages`](https://github.com/josuebarretogit/manga-tui/tree/main/src/view/pages) (App pages), [`src/cli.rs`](https://github.com/josuebarretogit/manga-tui/blob/main/src/cli.rs) (CLI entry), [`src/backend.rs`](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend.rs) (Backend setup), [`src/view/app.rs`](https://github.com/josuebarretogit/manga-tui/blob/main/src/view/app.rs) (App controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Terminal experience"]
  node_entry["CLI entry<br/>[cli.rs]"]
  node_event_loop["TUI event loop<br/>[tui.rs]"]
  node_app["App controller<br/>[app.rs]"]
  node_pages["App pages"]
  node_widgets["View widgets<br/>[widgets.rs]"]
end

subgraph group_catalog["Manga catalog"]
  node_provider_api["Provider interface<br/>[manga_provider.rs]"]
  node_mangadex["MangaDex provider<br/>[mangadex.rs]"]
  node_other_providers["Other providers"]
  node_html_parser["HTML parser<br/>[html_parser.rs]"]
  node_scraper["Scraper adapter<br/>[scraper.rs]"]
end

subgraph group_reading["Reading and tracking"]
  node_database[("History database<br/>[database.rs]")]
  node_downloader["Download coordinator"]
  node_formats["Download formats"]
  node_tracker["Tracking interface<br/>[tracker.rs]"]
  node_anilist["AniList integration<br/>[anilist.rs]"]
end

subgraph group_runtime["Runtime services"]
  node_config["Configuration<br/>[config.rs]"]
  node_backend["Backend setup<br/>[backend.rs]"]
  node_cache["Response cache<br/>[cache.rs]"]
  node_migration["Database migration<br/>[migration.rs]"]
  node_release_notifier["Update notifier"]
end

node_user(("User"))
node_terminal(("Terminal"))
node_provider_services{{"Manga services"}}
node_anilist_service{{"AniList"}}

node_user -->|"runs"| node_entry
node_entry -.->|"starts"| node_event_loop
node_event_loop -->|"runs"| node_app
node_app -->|"creates pages"| node_pages
node_app -.->|"renders"| node_widgets
node_terminal -->|"sends input"| node_event_loop
node_pages -.->|"uses provider"| node_provider_api
node_provider_api -.->|"dispatches to"| node_mangadex
node_provider_api -.->|"dispatches to"| node_other_providers
node_mangadex -.->|"requests data"| node_provider_services
node_other_providers -.->|"requests data"| node_provider_services
node_other_providers -.->|"parses pages"| node_html_parser
node_html_parser -->|"implemented by"| node_scraper
node_pages -.->|"stores reading state"| node_database
node_pages -.->|"requests downloads"| node_downloader
node_downloader -.->|"selects format"| node_formats
node_pages -.->|"updates progress"| node_tracker
node_tracker -->|"implemented by"| node_anilist
node_anilist -.->|"syncs progress"| node_anilist_service
node_entry -.->|"reads options"| node_config
node_backend -->|"initializes"| node_cache
node_backend -.->|"initializes"| node_database
node_backend -.->|"runs migrations"| node_migration
node_entry -.->|"checks updates"| node_release_notifier

click node_entry "https://github.com/josuebarretogit/manga-tui/blob/main/src/cli.rs"
click node_event_loop "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/tui.rs"
click node_app "https://github.com/josuebarretogit/manga-tui/blob/main/src/view/app.rs"
click node_pages "https://github.com/josuebarretogit/manga-tui/tree/main/src/view/pages"
click node_widgets "https://github.com/josuebarretogit/manga-tui/blob/main/src/view/widgets.rs"
click node_provider_api "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/manga_provider.rs"
click node_mangadex "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/manga_provider/mangadex.rs"
click node_other_providers "https://github.com/josuebarretogit/manga-tui/tree/main/src/backend/manga_provider"
click node_html_parser "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/html_parser.rs"
click node_scraper "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/html_parser/scraper.rs"
click node_database "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/database.rs"
click node_downloader "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/manga_downloader.rs"
click node_formats "https://github.com/josuebarretogit/manga-tui/tree/main/src/backend/manga_downloader"
click node_tracker "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/tracker.rs"
click node_anilist "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/tracker/anilist.rs"
click node_config "https://github.com/josuebarretogit/manga-tui/blob/main/src/config.rs"
click node_backend "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend.rs"
click node_cache "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/cache.rs"
click node_migration "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/migration.rs"
click node_release_notifier "https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/release_notifier.rs"

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_entry,node_event_loop,node_app,node_pages,node_widgets,node_user toneBlue
class node_provider_api,node_mangadex,node_other_providers,node_html_parser,node_scraper toneAmber
class node_database,node_downloader,node_formats,node_tracker,node_anilist toneMint
class node_config,node_backend,node_cache,node_migration,node_release_notifier toneRose
class node_terminal,node_provider_services,node_anilist_service toneIndigo
```

## Components

### Terminal experience

- [CLI entry](https://github.com/josuebarretogit/manga-tui/blob/main/src/cli.rs): `src/cli.rs`
- [TUI event loop](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/tui.rs): `src/backend/tui.rs`
- [App controller](https://github.com/josuebarretogit/manga-tui/blob/main/src/view/app.rs): `src/view/app.rs`
- [App pages](https://github.com/josuebarretogit/manga-tui/tree/main/src/view/pages): `src/view/pages`
- [View widgets](https://github.com/josuebarretogit/manga-tui/blob/main/src/view/widgets.rs): `src/view/widgets.rs`

### Manga catalog

- [Provider interface](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/manga_provider.rs): `src/backend/manga_provider.rs`
- [MangaDex provider](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/manga_provider/mangadex.rs): `src/backend/manga_provider/mangadex.rs`
- [Other providers](https://github.com/josuebarretogit/manga-tui/tree/main/src/backend/manga_provider): `src/backend/manga_provider`
- [HTML parser](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/html_parser.rs): `src/backend/html_parser.rs`
- [Scraper adapter](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/html_parser/scraper.rs): `src/backend/html_parser/scraper.rs`

### Reading and tracking

- [History database](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/database.rs): `src/backend/database.rs`
- [Download coordinator](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/manga_downloader.rs): `src/backend/manga_downloader.rs`
- [Download formats](https://github.com/josuebarretogit/manga-tui/tree/main/src/backend/manga_downloader): `src/backend/manga_downloader`
- [Tracking interface](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/tracker.rs): `src/backend/tracker.rs`
- [AniList integration](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/tracker/anilist.rs): `src/backend/tracker/anilist.rs`

### Runtime services

- [Configuration](https://github.com/josuebarretogit/manga-tui/blob/main/src/config.rs): `src/config.rs`
- [Backend setup](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend.rs): `src/backend.rs`
- [Response cache](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/cache.rs): `src/backend/cache.rs`
- [Database migration](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/migration.rs): `src/backend/migration.rs`
- [Update notifier](https://github.com/josuebarretogit/manga-tui/blob/main/src/backend/release_notifier.rs): `src/backend/release_notifier.rs`

### Other components

- **User**
- **Terminal**
- **Manga services**
- **AniList**

## Connections

- User → CLI entry: runs
- CLI entry → TUI event loop: starts
- TUI event loop → App controller: runs (evidence: `src/backend/tui.rs`)
- App controller → App pages: creates pages (evidence: `src/view/app.rs`)
- App controller → View widgets: renders (evidence: `src/view/app.rs`)
- Terminal → TUI event loop: sends input (evidence: `src/backend/tui.rs`)
- App pages → Provider interface: uses provider (evidence: `src/view/pages/search.rs`)
- Provider interface → MangaDex provider: dispatches to (evidence: `src/backend/manga_provider.rs`)
- Provider interface → Other providers: dispatches to (evidence: `src/backend/manga_provider.rs`)
- MangaDex provider → Manga services: requests data
- Other providers → Manga services: requests data
- Other providers → HTML parser: parses pages (evidence: `src/backend/manga_provider/manganato/response.rs`)
- HTML parser → Scraper adapter: implemented by (evidence: `src/backend/html_parser.rs`)
- App pages → History database: stores reading state (evidence: `src/view/pages/search.rs`)
- App pages → Download coordinator: requests downloads
- Download coordinator → Download formats: selects format (evidence: `src/backend/manga_downloader.rs`)
- App pages → Tracking interface: updates progress (evidence: `src/view/pages/search.rs`)
- Tracking interface → AniList integration: implemented by (evidence: `src/backend/tracker.rs`)
- AniList integration → AniList: syncs progress
- CLI entry → Configuration: reads options (evidence: `src/cli.rs`)
- Backend setup → Response cache: initializes (evidence: `src/backend.rs`)
- Backend setup → History database: initializes (evidence: `src/backend.rs`)
- Backend setup → Database migration: runs migrations (evidence: `src/backend.rs`)
- CLI entry → Update notifier: checks updates
