How aniraku/aniraku-app works
Aniraku is an Expo/React Native anime companion. The main user journey is discovery through AniList-backed browsing and search, selecting a title and episode, then resolving a stream for playback; the app also supports offline downloads and persistent watch/library data. Separate branches cover account access, comments and ratings, airing alerts, and AniList/MAL sync. Edges rely on README claims and the supplied source index/excerpts; unsampled implementation details are represented cautiously.
Main entry points: anilist.ts Anime metadata · anime/[id].tsx Anime details · watch/[id].tsx Playback · index.tsx Home
Components 23
Discovery
- Home
app/(tabs)/index.tsx - Catalog
app/(tabs)/catalog.tsx - Search
app/search.tsx - Anime details
app/anime/[id].tsx - Anime metadata
lib/anilist.ts - Airing schedule
components/airing-schedule.tsx - Episode alerts
hooks/use-airing-reminders.ts
Watching
- Episode list
app/episode/[id].tsx - Episode resolution
lib/episode-fallbacks.ts - Playback
app/watch/[id].tsx - Watch engine
lib/watch-engine.ts - Downloads
lib/downloads.ts - Native downloads
modules/aniraku-downloads/android/src/main/java/expo/modules/anirakudownloads/AnirakuDownloadsService.kt
Personal library
- Library and history
hooks/use-watch-history.ts - Bookmarks
hooks/use-bookmarks.ts
Accounts and community
- Authentication
providers/auth-provider.tsx - Comments and ratings
components/anime-comments.tsx - AniList/MAL sync
lib/provider-sync.ts
App platform
- Design system
components/nothing-ui.tsx
Other components
- Viewer
- Aniraku backend
- AniList service
- Supabase
Connections 33
- Viewer → Home: opens
README.md - Viewer → Catalog: browses
README.md - Viewer → Search: searches
app/search.tsx - Home → Anime metadata: loads titles
app/(tabs)/index.tsx - Catalog → Anime metadata: loads catalog
- Search → Anime metadata: queries titles
app/search.tsx - Viewer → Anime details: selects title
README.md - Anime details → Anime metadata: loads details
app/anime/[id].tsx - Anime details → Episode list: opens episodes
app/anime/[id].tsx - Episode list → Aniraku backend: requests episodes
app/episode/[id].tsx - Episode list → Episode resolution: resolves sources
app/episode/[id].tsx - Viewer → Playback: watches episode
README.md - Playback → Aniraku backend: requests streams
app/watch/[id].tsx - Playback → Watch engine: selects sources
app/watch/[id].tsx - Watch engine → Aniraku backend: checks sources
lib/watch-engine.ts - Playback → Downloads: starts downloads
app/watch/[id].tsx - Downloads → Native downloads: uses native service
- Viewer → Library and history: tracks viewing
README.md - Library and history → Supabase: syncs history
hooks/use-watch-history.ts - Viewer → Bookmarks: saves titles
README.md - Bookmarks → Supabase: syncs bookmarks
hooks/use-bookmarks.ts - Viewer → Authentication: signs in
- Authentication → Supabase: authenticates
providers/auth-provider.tsx - Anime details → Comments and ratings: shows discussion
app/anime/[id].tsx - Comments and ratings → Authentication: uses account
components/anime-comments.tsx - Comments and ratings → Supabase: stores comments
- Viewer → AniList/MAL sync: connects provider
README.md - AniList/MAL sync → AniList service: syncs progress
README.md - Viewer → Airing schedule: checks airing
README.md - Airing schedule → Anime metadata: loads schedule
- Viewer → Episode alerts: sets reminders
README.md - Episode alerts → Aniraku backend: checks episodes
- Home → Design system: renders with
app/(tabs)/index.tsx