How kauri-off/kiroku works
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: shell Navigation shell · SearchState.kt Search and browse · Repositories.kt Domain repositories · title Title pages
Components 23
App experience
- App entry
app/src/main/kotlin/io/github/kauri_off/kiroku/MainActivity.kt - Navigation shell
app/src/main/kotlin/io/github/kauri_off/kiroku/shell - Search and browse
app/src/main/kotlin/io/github/kauri_off/kiroku/search/SearchState.kt - Title pages
app/src/main/kotlin/io/github/kauri_off/kiroku/title - Related and details
app/src/main/kotlin/io/github/kauri_off/kiroku/titlesub/SubScreenRoutes.kt - Anime list
app/src/main/kotlin/io/github/kauri_off/kiroku/list - Profiles
app/src/main/kotlin/io/github/kauri_off/kiroku/profile - Sign-in flow
app/src/main/kotlin/io/github/kauri_off/kiroku/signin - Compose design system
app/src/main/kotlin/io/github/kauri_off/kiroku/design
Domain logic
- Anime and list models
core/src/main/kotlin/io/github/kauri_off/kiroku/core/model/Anime.kt - List engine
core/src/main/kotlin/io/github/kauri_off/kiroku/core/list/ListEngine.kt - Airing engine
core/src/main/kotlin/io/github/kauri_off/kiroku/core/airing/AiringEngine.kt - Domain repositories
core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt
Data and services
- MAL title data
data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt - MAL HTTP client
data/src/main/kotlin/io/github/kauri_off/kiroku/data/network/MalHttp.kt - Session and tokens
data/src/main/kotlin/io/github/kauri_off/kiroku/data/session/MalSession.kt - Room database
data/src/main/kotlin/io/github/kauri_off/kiroku/data/db/KirokuDatabase.kt - Airing data
data/src/main/kotlin/io/github/kauri_off/kiroku/data/anilist/AniListSchedule.kt
Demo tooling
- Debug demo sources
app/src/debug/kotlin/io/github/kauri_off/kiroku/source/DataSource.kt - Debug menu
app/src/debug/kotlin/io/github/kauri_off/kiroku/debugmenu/DebugMenuActivity.kt
Other components
- App user
- MyAnimeList API
- AniList API
Connections 27
- App user → App entry: opens app
README.md - App entry → Navigation shell: starts navigation
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
app/src/main/kotlin/io/github/kauri_off/kiroku/titlesub/SubScreenRoutes.kt - Search and browse → Compose design system: renders with
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
core/src/main/kotlin/io/github/kauri_off/kiroku/core/list/ListEngine.kt - Airing engine → Anime and list models: uses models
core/src/main/kotlin/io/github/kauri_off/kiroku/core/airing/AiringEngine.kt - Domain repositories → Anime and list models: exposes models
core/src/main/kotlin/io/github/kauri_off/kiroku/core/repository/Repositories.kt - Domain repositories → MAL title data: implemented by
data/src/main/kotlin/io/github/kauri_off/kiroku/data/anime/MalAnimeRepository.kt - MAL title data → Room database: reads and writes
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
README.md - Session and tokens → MAL HTTP client: uses HTTP
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
README.md - App user → Profiles: views statistics
- App user → Debug menu: opens debug tools
- Debug menu → Debug demo sources: selects demo source