How cineva-stream/cineva works
Cineva is a Flutter streaming app for discovering movies and series, viewing details, selecting a stream, and watching through an adaptive player; it also offers live TV and local-first personalization. The graph preserves README-documented capabilities and major feature areas visible in the tree. Most Dart implementation files were not sampled, so feature-to-feature links are limited to documented workflow relationships; native Android update-check links are supported by the excerpts.
Main entry points: main_shell.dart Navigation shell · player_screen.dart Media player · home_screen.dart Home discovery · tmdb_remote_datasource.dart TMDB catalog
Components 28
App shell
- Flutter app
lib/main.dart - Navigation shell
lib/shared/widgets/main_shell.dart - Network client
lib/core/network/dio_client.dart - Android update worker
android/app/src/main/kotlin/com/primadev/cineva/UpdateCheckWorker.kt - Update alarm receiver
android/app/src/main/kotlin/com/primadev/cineva/UpdateAlarmReceiver.kt
Discovery and catalog
- Home discovery
lib/features/home/presentation/screens/home_screen.dart - Search
lib/features/search/presentation/screens/search_screen.dart - TMDB catalog
lib/features/home/data/datasources/tmdb_remote_datasource.dart - Media details
lib/features/detail/presentation/screens/movie_detail_screen.dart - Airing calendar
lib/features/calendar/presentation/screens/airing_calendar_screen.dart - Collections
lib/features/collection/presentation/screens/collection_detail_screen.dart - People details
lib/features/person/presentation/screens/person_detail_screen.dart - TV universes
lib/features/tv_universe/presentation/screens/tv_universe_screen.dart - Live TV
lib/features/live_tv/presentation/screens/live_tv_screen.dart
Playback and streams
- Media player
lib/features/player/presentation/screens/player_screen.dart - Stream providers
lib/features/player/data/services/provider_loader_service.dart - Subtitle service
lib/features/player/data/services/subtitle_service.dart - Offline downloads
lib/features/download/data/services/video_download_service.dart
Personal features
- Watch history
lib/features/history/data/repositories/watch_history_repository.dart - Watchlist
lib/features/watchlist/data/watchlist_repository.dart - Profiles
lib/features/profile/data/profile_service.dart - Backup and sync
lib/features/backup/data/backup_restore_service.dart - Watch party
lib/features/watch_party/data/services/watch_party_service.dart - Device handoff
lib/features/sync/data/services/device_handoff_service.dart
Other components
- Viewer
- TMDB service
- OpenSubtitles
- GitHub releases
Connections 27
- Viewer → Flutter app: opens
README.md - Flutter app → Navigation shell: presents
README.md - Navigation shell → Home discovery: browses
README.md - Navigation shell → Search: searches
README.md - Home discovery → TMDB catalog: loads catalog
- Search → TMDB catalog: searches catalog
- TMDB catalog → TMDB service: requests metadata
README.md - Home discovery → Media details: opens media
- Navigation shell → Airing calendar: views schedule
README.md - Home discovery → Collections: browses collections
- Media details → People details: opens credits
- Home discovery → TV universes: explores universes
- Navigation shell → Live TV: watches channels
README.md - Media details → Media player: starts playback
- Media player → Stream providers: loads streams
- Media player → Subtitle service: loads subtitles
README.md - Subtitle service → OpenSubtitles: discovers subtitles
README.md - Media player → Watch history: saves progress
README.md - Navigation shell → Watchlist: manages favorites
README.md - Media player → Offline downloads: saves offline
README.md - Navigation shell → Profiles: edits profile
- Profiles → Backup and sync: backs up data
- Media player → Watch party: watches together
- Media player → Device handoff: hands off playback
- TMDB catalog → Network client: uses client
- Android update worker → GitHub releases: checks releases
android/app/src/main/kotlin/com/primadev/cineva/UpdateCheckWorker.kt - Update alarm receiver → Android update worker: schedules checks
android/app/src/main/kotlin/com/primadev/cineva/UpdateAlarmReceiver.kt