# kauri-off/kiroku architecture

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

- Interactive diagram: https://gitdiagram.com/kauri-off/kiroku
- Repository: https://github.com/kauri-off/kiroku

## Overview

Kiroku is an early-stage Android MyAnimeList client. Its main user workflow is browsing or searching for anime, opening title information, then viewing and updating a personal list; sign-in enables account-backed actions. The code separates Compose screens and navigation, domain models and engines, and data adapters for MAL, AniList, and local storage. The README also documents profile/public-list and airing-notification goals. Several feature implementations and wiring files are present in the tree but were not sampled, so their internal call relationships are left unverified.

Main entry points: [`app/src/main/kotlin/io/github/kauri_off/kiroku/shell`](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/shell) (Navigation shell), [`app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchState.kt`](https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchState.kt) (Search and browse), [`core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt`](https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt) (Domain repositories), [`app/src/main/kotlin/io/github/kauri_off/kiroku/title`](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/title) (Title pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["Navigation shell"]
  node_search["Search and browse<br/>[SearchState.kt]"]
  node_title["Title pages"]
  node_subpages["Related and details<br/>[SubScreenRoutes.kt]"]
  node_list["Anime list"]
  node_profile["Profiles"]
  node_signin["Sign-in flow"]
  node_design["Compose design system"]
end

subgraph group_domain["Domain logic"]
  node_models["Anime and list models<br/>[Anime.kt]"]
  node_listengine["List engine<br/>[ListEngine.kt]"]
  node_airingengine["Airing engine<br/>[AiringEngine.kt]"]
  node_repositories["Domain repositories<br/>[Repositories.kt]"]
end

subgraph group_data["Data and services"]
  node_maldata["MAL title data"]
  node_network["MAL HTTP client<br/>[MalHttp.kt]"]
  node_session["Session and tokens<br/>[MalSession.kt]"]
  node_database[("Room database<br/>[KirokuDatabase.kt]")]
  node_airingdata["Airing data<br/>[AniListSchedule.kt]"]
end

subgraph group_debug["Demo tooling"]
  node_debugdemo["Debug demo sources<br/>[DataSource.kt]"]
  node_debugmenu["Debug menu"]
end

node_user(("App user"))
node_malservice{{"MyAnimeList API"}}
node_anilist{{"AniList API"}}

node_user -->|"opens app"| node_activity
node_activity -->|"starts navigation"| node_navigation
node_user -.->|"searches titles"| node_search
node_user -.->|"updates episodes"| node_list
node_navigation -.->|"routes to"| node_search
node_navigation -.->|"routes to"| node_title
node_navigation -.->|"routes to"| node_list
node_navigation -.->|"routes to"| node_signin
node_title -->|"opens related pages"| node_subpages
node_search -->|"renders with"| node_design
node_search -.->|"loads results"| node_repositories
node_title -.->|"loads title data"| node_repositories
node_list -.->|"updates through"| node_listengine
node_listengine -->|"uses models"| node_models
node_airingengine -->|"uses models"| node_models
node_repositories -->|"exposes models"| node_models
node_repositories -->|"implemented by"| node_maldata
node_maldata -->|"reads and writes"| node_database
node_maldata -.->|"fetches titles"| node_malservice
node_network -->|"sends requests"| node_malservice
node_session -->|"uses HTTP"| node_network
node_session -.->|"authorizes account"| node_malservice
node_airingengine -.->|"requests schedules"| node_airingdata
node_airingdata -->|"fetches airing times"| node_anilist
node_user -.->|"views statistics"| node_profile
node_user -.->|"opens debug tools"| node_debugmenu
node_debugmenu -.->|"selects demo source"| node_debugdemo

click node_activity "https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/MainActivity.kt"
click node_navigation "https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/shell"
click node_search "https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchState.kt"
click node_title "https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/title"
click node_subpages "https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/titlesub/SubScreenRoutes.kt"
click node_list "https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/list"
click node_profile "https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/profile"
click node_signin "https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/signin"
click node_design "https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/design"
click node_models "https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/model/Anime.kt"
click node_listengine "https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/list/ListEngine.kt"
click node_airingengine "https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/airing/AiringEngine.kt"
click node_repositories "https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt"
click node_maldata "https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt"
click node_network "https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/network/MalHttp.kt"
click node_session "https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/session/MalSession.kt"
click node_database "https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/db/KirokuDatabase.kt"
click node_airingdata "https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/anilist/AniListSchedule.kt"
click node_debugdemo "https://github.com/kauri-off/kiroku/blob/main/app/src/debug/kotlin/io/github/kauri_off/kiroku/source/DataSource.kt"
click node_debugmenu "https://github.com/kauri-off/kiroku/blob/main/app/src/debug/kotlin/io/github/kauri_off/kiroku/debugmenu/DebugMenuActivity.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_navigation,node_search,node_title,node_subpages,node_list,node_profile,node_signin,node_design,node_user toneBlue
class node_models,node_listengine,node_airingengine,node_repositories toneAmber
class node_maldata,node_network,node_session,node_database,node_airingdata,node_malservice,node_anilist toneMint
class node_debugdemo,node_debugmenu toneRose
```

## Components

### App experience

- [App entry](https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/MainActivity.kt): `app/src/main/kotlin/io/github/kauri_off/kiroku/MainActivity.kt`
- [Navigation shell](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/shell): `app/src/main/kotlin/io/github/kauri_off/kiroku/shell`
- [Search and browse](https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchState.kt): `app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchState.kt`
- [Title pages](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/title): `app/src/main/kotlin/io/github/kauri_off/kiroku/title`
- [Related and details](https://github.com/kauri-off/kiroku/blob/main/app/src/main/kotlin/io/github/kauri_off/kiroku/titlesub/SubScreenRoutes.kt): `app/src/main/kotlin/io/github/kauri_off/kiroku/titlesub/SubScreenRoutes.kt`
- [Anime list](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/list): `app/src/main/kotlin/io/github/kauri_off/kiroku/list`
- [Profiles](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/profile): `app/src/main/kotlin/io/github/kauri_off/kiroku/profile`
- [Sign-in flow](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/signin): `app/src/main/kotlin/io/github/kauri_off/kiroku/signin`
- [Compose design system](https://github.com/kauri-off/kiroku/tree/main/app/src/main/kotlin/io/github/kauri_off/kiroku/design): `app/src/main/kotlin/io/github/kauri_off/kiroku/design`

### Domain logic

- [Anime and list models](https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/model/Anime.kt): `core/src/main/kotlin/io/github/kauri_off/kiroku/core/model/Anime.kt`
- [List engine](https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/list/ListEngine.kt): `core/src/main/kotlin/io/github/kauri_off/kiroku/core/list/ListEngine.kt`
- [Airing engine](https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/airing/AiringEngine.kt): `core/src/main/kotlin/io/github/kauri_off/kiroku/core/airing/AiringEngine.kt`
- [Domain repositories](https://github.com/kauri-off/kiroku/blob/main/core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt): `core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt`

### Data and services

- [MAL title data](https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt): `data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt`
- [MAL HTTP client](https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/network/MalHttp.kt): `data/src/main/kotlin/io/github/kauri_off/kiroku/data/network/MalHttp.kt`
- [Session and tokens](https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/session/MalSession.kt): `data/src/main/kotlin/io/github/kauri_off/kiroku/data/session/MalSession.kt`
- [Room database](https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/db/KirokuDatabase.kt): `data/src/main/kotlin/io/github/kauri_off/kiroku/data/db/KirokuDatabase.kt`
- [Airing data](https://github.com/kauri-off/kiroku/blob/main/data/src/main/kotlin/io/github/kauri_off/kiroku/data/anilist/AniListSchedule.kt): `data/src/main/kotlin/io/github/kauri_off/kiroku/data/anilist/AniListSchedule.kt`

### Demo tooling

- [Debug demo sources](https://github.com/kauri-off/kiroku/blob/main/app/src/debug/kotlin/io/github/kauri_off/kiroku/source/DataSource.kt): `app/src/debug/kotlin/io/github/kauri_off/kiroku/source/DataSource.kt`
- [Debug menu](https://github.com/kauri-off/kiroku/blob/main/app/src/debug/kotlin/io/github/kauri_off/kiroku/debugmenu/DebugMenuActivity.kt): `app/src/debug/kotlin/io/github/kauri_off/kiroku/debugmenu/DebugMenuActivity.kt`

### Other components

- **App user**
- **MyAnimeList API**
- **AniList API**

## Connections

- App user → App entry: opens app (evidence: `README.md`)
- App entry → Navigation shell: starts navigation (evidence: `app/src/main/kotlin/io/github/kauri_off/kiroku/MainActivity.kt`)
- App user → Search and browse: searches titles
- App user → Anime list: updates episodes
- Navigation shell → Search and browse: routes to
- Navigation shell → Title pages: routes to
- Navigation shell → Anime list: routes to
- Navigation shell → Sign-in flow: routes to
- Title pages → Related and details: opens related pages (evidence: `app/src/main/kotlin/io/github/kauri_off/kiroku/titlesub/SubScreenRoutes.kt`)
- Search and browse → Compose design system: renders with (evidence: `app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchScreen.kt`)
- Search and browse → Domain repositories: loads results
- Title pages → Domain repositories: loads title data
- Anime list → List engine: updates through
- List engine → Anime and list models: uses models (evidence: `core/src/main/kotlin/io/github/kauri_off/kiroku/core/list/ListEngine.kt`)
- Airing engine → Anime and list models: uses models (evidence: `core/src/main/kotlin/io/github/kauri_off/kiroku/core/airing/AiringEngine.kt`)
- Domain repositories → Anime and list models: exposes models (evidence: `core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt`)
- Domain repositories → MAL title data: implemented by (evidence: `data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt`)
- MAL title data → Room database: reads and writes (evidence: `data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt`)
- MAL title data → MyAnimeList API: fetches titles
- MAL HTTP client → MyAnimeList API: sends requests (evidence: `README.md`)
- Session and tokens → MAL HTTP client: uses HTTP (evidence: `data/src/main/kotlin/io/github/kauri_off/kiroku/data/session/SessionOverHttp.kt`)
- Session and tokens → MyAnimeList API: authorizes account
- Airing engine → Airing data: requests schedules
- Airing data → AniList API: fetches airing times (evidence: `README.md`)
- App user → Profiles: views statistics
- App user → Debug menu: opens debug tools
- Debug menu → Debug demo sources: selects demo source
