# lugovskoy-maxim/tomilo-lib-android architecture

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

- Interactive diagram: https://gitdiagram.com/lugovskoy-maxim/tomilo-lib-android
- Repository: https://github.com/lugovskoy-maxim/tomilo-lib-android

## Overview

TOMILO LIB is an Android manga/manhwa reader and community app. Its user-facing journey spans discovery and title selection, chapter reading, and optional offline downloads; the README also highlights library, social, games, premium, and update capabilities. The sampled code shows application setup, API construction, offline download handling, and notification delivery. Several screen and repository connections are documented only at product level or are unsampled, so the graph avoids asserting those internal call paths.

Main entry points: [`app/src/main/java/ru/tomilo/lib/mobile/data/api/TomiloApi.kt`](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/api/TomiloApi.kt) (API contract), [`app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt`](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt) (Offline repository), [`app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadManager.kt`](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadManager.kt) (Download manager), [`app/src/main/java/ru/tomilo/lib/mobile/push/NotificationHelper.kt`](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/NotificationHelper.kt) (Notification helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_main["Main activity<br/>[MainActivity.kt]"]
  node_appstart["App initialization<br/>[TomiloApp.kt]"]
  node_container["Dependency container<br/>[AppContainer.kt]"]
  node_nav["Navigation host<br/>[TomiloNavHost.kt]"]
end

subgraph group_reading["Discovery and reading"]
  node_reader["Reader<br/>[ReaderScreen.kt]"]
  node_home["Home feed<br/>[HomeScreen.kt]"]
  node_catalog["Catalog<br/>[CatalogScreen.kt]"]
  node_title["Title details<br/>[TitleScreen.kt]"]
  node_search["Search<br/>[SearchScreen.kt]"]
  node_library["Library<br/>[LibraryScreen.kt]"]
  node_offlineui["Offline library"]
end

subgraph group_community["Community and games"]
  node_profile["Profile<br/>[ProfileScreen.kt]"]
  node_social["Social screens"]
  node_games["Games"]
  node_match_engine["Match-three engine"]
end

subgraph group_data["Data and offline"]
  node_authrepo["Authentication<br/>[AuthRepository.kt]"]
  node_api["API contract<br/>[TomiloApi.kt]"]
  node_network["Network client<br/>[NetworkModule.kt]"]
  node_offline["Offline repository"]
  node_downloads["Download manager<br/>[DownloadManager.kt]"]
  node_offline_db[("Offline database<br/>[OfflineDatabase.kt]")]
  node_download_service["Download service"]
end

subgraph group_services["Engagement services"]
  node_ads["Ad managers"]
  node_ad_sdk["Yandex ads SDK<br/>[YandexAdsSdk.kt]"]
  node_push["Push services"]
  node_poll["Notification polling"]
  node_notify["Notification helper"]
  node_premium["Premium rules<br/>[Premium.kt]"]
end

node_user(("Reader"))
node_backend(("TOMILO service"))

node_user -->|"opens feed"| node_home
node_user -->|"reads chapters"| node_reader
node_user -->|"manages downloads"| node_offlineui
node_user -->|"uses community"| node_social
node_main -->|"hosts navigation"| node_nav
node_appstart -->|"creates container"| node_container
node_network -->|"configures client"| node_api
node_authrepo -->|"calls endpoints"| node_api
node_offline -->|"fetches chapter data"| node_api
node_offline -->|"reads and writes"| node_offline_db
node_downloads -->|"delegates downloads"| node_offline
node_download_service -->|"runs queued work"| node_downloads
node_push -->|"displays messages"| node_notify
node_poll -->|"displays updates"| node_notify
node_ads -->|"uses SDK"| node_ad_sdk
node_user -->|"browses titles"| node_catalog
node_user -.->|"plays games"| node_games
node_user -->|"manages account"| node_profile
node_backend -.->|"serves API"| node_api

click node_reader "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/reader/ReaderScreen.kt"
click node_home "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/home/HomeScreen.kt"
click node_catalog "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/catalog/CatalogScreen.kt"
click node_title "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/title/TitleScreen.kt"
click node_search "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/search/SearchScreen.kt"
click node_library "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/library/LibraryScreen.kt"
click node_offlineui "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/offline/OfflineLibraryScreen.kt"
click node_main "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/MainActivity.kt"
click node_appstart "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/TomiloApp.kt"
click node_container "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/AppContainer.kt"
click node_nav "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/navigation/TomiloNavHost.kt"
click node_profile "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/profile/ProfileScreen.kt"
click node_social "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/chats/ChatThreadScreen.kt"
click node_games "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/games/MatchThreeScreen.kt"
click node_authrepo "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/repo/AuthRepository.kt"
click node_api "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/api/TomiloApi.kt"
click node_network "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/api/NetworkModule.kt"
click node_offline "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt"
click node_downloads "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadManager.kt"
click node_offline_db "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/local/OfflineDatabase.kt"
click node_download_service "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadForegroundService.kt"
click node_ads "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ads/RewardedAdManager.kt"
click node_ad_sdk "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ads/YandexAdsSdk.kt"
click node_push "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/RuStorePushService.kt"
click node_poll "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/NotificationsPollWorker.kt"
click node_notify "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/NotificationHelper.kt"
click node_match_engine "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/core/MatchThreeEngine.kt"
click node_premium "https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/core/Premium.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_main,node_appstart,node_container,node_nav toneBlue
class node_reader,node_home,node_catalog,node_title,node_search,node_library,node_offlineui toneAmber
class node_profile,node_social,node_games,node_match_engine toneMint
class node_authrepo,node_api,node_network,node_offline,node_downloads,node_offline_db,node_download_service toneRose
class node_ads,node_ad_sdk,node_push,node_poll,node_notify,node_premium,node_user,node_backend toneIndigo
```

## Components

### App and navigation

- [Main activity](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/MainActivity.kt): `app/src/main/java/ru/tomilo/lib/mobile/MainActivity.kt`
- [App initialization](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/TomiloApp.kt): `app/src/main/java/ru/tomilo/lib/mobile/TomiloApp.kt`
- [Dependency container](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/AppContainer.kt): `app/src/main/java/ru/tomilo/lib/mobile/AppContainer.kt`
- [Navigation host](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/navigation/TomiloNavHost.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/navigation/TomiloNavHost.kt`

### Discovery and reading

- [Reader](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/reader/ReaderScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/reader/ReaderScreen.kt`
- [Home feed](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/home/HomeScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/home/HomeScreen.kt`
- [Catalog](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/catalog/CatalogScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/catalog/CatalogScreen.kt`
- [Title details](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/title/TitleScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/title/TitleScreen.kt`
- [Search](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/search/SearchScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/search/SearchScreen.kt`
- [Library](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/library/LibraryScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/library/LibraryScreen.kt`
- [Offline library](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/offline/OfflineLibraryScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/offline/OfflineLibraryScreen.kt`

### Community and games

- [Profile](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/profile/ProfileScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/profile/ProfileScreen.kt`
- [Social screens](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/chats/ChatThreadScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/chats/ChatThreadScreen.kt`
- [Games](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ui/screens/games/MatchThreeScreen.kt): `app/src/main/java/ru/tomilo/lib/mobile/ui/screens/games/MatchThreeScreen.kt`
- [Match-three engine](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/core/MatchThreeEngine.kt): `app/src/main/java/ru/tomilo/lib/mobile/core/MatchThreeEngine.kt`

### Data and offline

- [Authentication](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/repo/AuthRepository.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/repo/AuthRepository.kt`
- [API contract](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/api/TomiloApi.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/api/TomiloApi.kt`
- [Network client](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/api/NetworkModule.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/api/NetworkModule.kt`
- [Offline repository](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt`
- [Download manager](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadManager.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadManager.kt`
- [Offline database](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/local/OfflineDatabase.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/local/OfflineDatabase.kt`
- [Download service](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadForegroundService.kt): `app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadForegroundService.kt`

### Engagement services

- [Ad managers](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ads/RewardedAdManager.kt): `app/src/main/java/ru/tomilo/lib/mobile/ads/RewardedAdManager.kt`
- [Yandex ads SDK](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/ads/YandexAdsSdk.kt): `app/src/main/java/ru/tomilo/lib/mobile/ads/YandexAdsSdk.kt`
- [Push services](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/RuStorePushService.kt): `app/src/main/java/ru/tomilo/lib/mobile/push/RuStorePushService.kt`
- [Notification polling](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/NotificationsPollWorker.kt): `app/src/main/java/ru/tomilo/lib/mobile/push/NotificationsPollWorker.kt`
- [Notification helper](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/push/NotificationHelper.kt): `app/src/main/java/ru/tomilo/lib/mobile/push/NotificationHelper.kt`
- [Premium rules](https://github.com/lugovskoy-maxim/tomilo-lib-android/blob/main/app/src/main/java/ru/tomilo/lib/mobile/core/Premium.kt): `app/src/main/java/ru/tomilo/lib/mobile/core/Premium.kt`

### Other components

- **Reader**
- **TOMILO service**

## Connections

- Reader → Home feed: opens feed (evidence: `README.md`)
- Reader → Reader: reads chapters (evidence: `README.md`)
- Reader → Offline library: manages downloads (evidence: `README.md`)
- Reader → Social screens: uses community (evidence: `README.md`)
- Main activity → Navigation host: hosts navigation (evidence: `app/src/main/java/ru/tomilo/lib/mobile/MainActivity.kt`)
- App initialization → Dependency container: creates container (evidence: `app/src/main/java/ru/tomilo/lib/mobile/TomiloApp.kt`)
- Network client → API contract: configures client (evidence: `app/src/main/java/ru/tomilo/lib/mobile/data/api/NetworkModule.kt`)
- Authentication → API contract: calls endpoints (evidence: `app/src/main/java/ru/tomilo/lib/mobile/data/repo/AuthRepository.kt`)
- Offline repository → API contract: fetches chapter data (evidence: `app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt`)
- Offline repository → Offline database: reads and writes (evidence: `app/src/main/java/ru/tomilo/lib/mobile/data/repo/OfflineRepository.kt`)
- Download manager → Offline repository: delegates downloads (evidence: `app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadManager.kt`)
- Download service → Download manager: runs queued work (evidence: `app/src/main/java/ru/tomilo/lib/mobile/data/download/DownloadForegroundService.kt`)
- Push services → Notification helper: displays messages (evidence: `app/src/main/java/ru/tomilo/lib/mobile/push/RuStorePushService.kt`)
- Notification polling → Notification helper: displays updates (evidence: `app/src/main/java/ru/tomilo/lib/mobile/push/NotificationsPollWorker.kt`)
- Ad managers → Yandex ads SDK: uses SDK (evidence: `app/src/main/java/ru/tomilo/lib/mobile/ads/RewardedAdManager.kt`)
- Reader → Catalog: browses titles (evidence: `README.md`)
- Reader → Games: plays games
- Reader → Profile: manages account (evidence: `README.md`)
- TOMILO service → API contract: serves API
