How developerrahnuma/flutter-mvvm-clean-setup works
This is a Flutter MVVM sample organized around an album feature: users can view an album list and album details, with data obtained through an API-facing data layer. The documented architecture separates views, view models, use cases, and repositories; shared modules provide app setup, networking, and navigation. The README describes these layer relationships, but the sampled source contains no Dart implementation excerpts, so feature-specific connections are shown as unverified rather than asserted.
Main entry points: router.dart App router · app_module.dart App dependencies · album_list_view_model.dart List view model · album_details_view_model.dart Details view model
Components 23
App setup
- App entry
lib/main.dart - App dependencies
lib/shared/di/app_module.dart
Album presentation
- Album list screen
lib/features/album/ui/album_list_screen.dart - Album details screen
lib/features/album/ui/album_details_screen.dart - List view model
lib/features/album/presentation/album_list_view_model.dart - Details view model
lib/features/album/presentation/album_details_view_model.dart
Album domain
- List use case
lib/features/album/domain/usecase/get_album_list_use_case.dart - Details use case
lib/features/album/domain/usecase/get_album_details_use_case.dart - Album repository
lib/features/album/domain/repository/album_repo.dart - Album entity
lib/features/album/entity/album.dart
Album data
- Repository implementation
lib/features/album/data/repository/album_repo_imp.dart - Remote data contract
lib/features/album/data/repository/album_remote.dart - Remote data source
lib/features/album/data/network/album_remote_imp.dart - Album API
lib/features/album/data/network/service/album_apis.dart - Album response model
lib/features/album/data/network/model/album_model.dart
Shared services
- Base view model
lib/shared/presentation/base_view_model.dart - Base use case
lib/shared/domain/usecase/base_use_case.dart - Network setup
lib/shared/data/network/di/network_module.dart - App router
lib/shared/router/router.dart - Router setup
lib/shared/router/router_module.dart - Navigation service
lib/shared/service/navigation_service.dart
Other components
- App user
- Album API service
Connections 26
- App user → App entry: opens app
- App entry → App dependencies: initializes
- App user → Album list screen: views albums
- Album list screen → List view model: observes
README.md - List view model → List use case: requests list
README.md - List use case → Album repository: retrieves data
README.md - Album repository → Repository implementation: implemented by
- Repository implementation → Remote data contract: uses source
- Remote data source → Album API: calls API
- Album API → Album API service: requests albums
- Remote data source → Album response model: maps response
- Repository implementation → Album entity: returns albums
- App user → Album details screen: opens details
- Album details screen → Details view model: observes
README.md - Details view model → Details use case: requests details
README.md - Details use case → Album repository: retrieves data
README.md - List view model → Base view model: extends
- Details view model → Base view model: extends
- List use case → Base use case: uses base
- Details use case → Base use case: uses base
- App dependencies → Network setup: configures
- App dependencies → Router setup: configures
- Router setup → App router: configures
- App router → Album list screen: routes to
- App router → Album details screen: routes to
- Navigation service → App router: navigates through