# developerrahnuma/flutter-mvvm-clean-setup architecture

> Architecture diagram of the GitHub repository developerrahnuma/flutter-mvvm-clean-setup, 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/developerrahnuma/flutter-mvvm-clean-setup
- Repository: https://github.com/developerrahnuma/flutter-mvvm-clean-setup

## Overview

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: [`lib/shared/router/router.dart`](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/router/router.dart) (App router), [`lib/shared/di/app_module.dart`](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/di/app_module.dart) (App dependencies), [`lib/features/album/presentation/album_list_view_model.dart`](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/presentation/album_list_view_model.dart) (List view model), [`lib/features/album/presentation/album_details_view_model.dart`](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/presentation/album_details_view_model.dart) (Details view model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App setup"]
  node_entry["App entry<br/>[main.dart]"]
  node_app_di["App dependencies<br/>[app_module.dart]"]
end

subgraph group_presentation["Album presentation"]
  node_list_view["Album list screen"]
  node_details_view["Album details screen"]
  node_list_vm["List view model"]
  node_details_vm["Details view model"]
end

subgraph group_domain["Album domain"]
  node_list_usecase["List use case"]
  node_details_usecase["Details use case"]
  node_album_repo["Album repository<br/>[album_repo.dart]"]
  node_album_entity["Album entity<br/>[album.dart]"]
end

subgraph group_data["Album data"]
  node_repo_impl["Repository implementation"]
  node_remote_contract["Remote data contract<br/>[album_remote.dart]"]
  node_remote_impl["Remote data source"]
  node_api["Album API<br/>[album_apis.dart]"]
  node_model["Album response model<br/>[album_model.dart]"]
end

subgraph group_shared["Shared services"]
  node_base_vm["Base view model"]
  node_base_usecase["Base use case<br/>[base_use_case.dart]"]
  node_network_di["Network setup"]
  node_router["App router<br/>[router.dart]"]
  node_router_di["Router setup<br/>[router_module.dart]"]
  node_navigation["Navigation service"]
end

node_user(("App user"))
node_api_service(("Album API service"))

node_user -.->|"opens app"| node_entry
node_entry -.->|"initializes"| node_app_di
node_user -.->|"views albums"| node_list_view
node_list_view -->|"observes"| node_list_vm
node_list_vm -->|"requests list"| node_list_usecase
node_list_usecase -->|"retrieves data"| node_album_repo
node_album_repo -.->|"implemented by"| node_repo_impl
node_repo_impl -.->|"uses source"| node_remote_contract
node_remote_impl -.->|"calls API"| node_api
node_api -.->|"requests albums"| node_api_service
node_remote_impl -.->|"maps response"| node_model
node_repo_impl -.->|"returns albums"| node_album_entity
node_user -.->|"opens details"| node_details_view
node_details_view -->|"observes"| node_details_vm
node_details_vm -->|"requests details"| node_details_usecase
node_details_usecase -->|"retrieves data"| node_album_repo
node_list_vm -.->|"extends"| node_base_vm
node_details_vm -.->|"extends"| node_base_vm
node_list_usecase -.->|"uses base"| node_base_usecase
node_details_usecase -.->|"uses base"| node_base_usecase
node_app_di -.->|"configures"| node_network_di
node_app_di -.->|"configures"| node_router_di
node_router_di -.->|"configures"| node_router
node_router -.->|"routes to"| node_list_view
node_router -.->|"routes to"| node_details_view
node_navigation -.->|"navigates through"| node_router

click node_entry "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/main.dart"
click node_app_di "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/di/app_module.dart"
click node_list_view "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/ui/album_list_screen.dart"
click node_details_view "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/ui/album_details_screen.dart"
click node_list_vm "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/presentation/album_list_view_model.dart"
click node_details_vm "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/presentation/album_details_view_model.dart"
click node_base_vm "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/presentation/base_view_model.dart"
click node_list_usecase "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/domain/usecase/get_album_list_use_case.dart"
click node_details_usecase "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/domain/usecase/get_album_details_use_case.dart"
click node_base_usecase "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/domain/usecase/base_use_case.dart"
click node_album_repo "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/domain/repository/album_repo.dart"
click node_album_entity "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/entity/album.dart"
click node_repo_impl "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/repository/album_repo_imp.dart"
click node_remote_contract "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/repository/album_remote.dart"
click node_remote_impl "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/network/album_remote_imp.dart"
click node_api "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/network/service/album_apis.dart"
click node_model "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/network/model/album_model.dart"
click node_network_di "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/data/network/di/network_module.dart"
click node_router "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/router/router.dart"
click node_router_di "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/router/router_module.dart"
click node_navigation "https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/service/navigation_service.dart"

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_entry,node_app_di,node_user toneBlue
class node_list_view,node_details_view,node_list_vm,node_details_vm toneAmber
class node_list_usecase,node_details_usecase,node_album_repo,node_album_entity,node_api_service toneMint
class node_repo_impl,node_remote_contract,node_remote_impl,node_api,node_model toneRose
class node_base_vm,node_base_usecase,node_network_di,node_router,node_router_di,node_navigation toneIndigo
```

## Components

### App setup

- [App entry](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/main.dart): `lib/main.dart`
- [App dependencies](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/di/app_module.dart): `lib/shared/di/app_module.dart`

### Album presentation

- [Album list screen](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/ui/album_list_screen.dart): `lib/features/album/ui/album_list_screen.dart`
- [Album details screen](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/ui/album_details_screen.dart): `lib/features/album/ui/album_details_screen.dart`
- [List view model](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/presentation/album_list_view_model.dart): `lib/features/album/presentation/album_list_view_model.dart`
- [Details view model](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/presentation/album_details_view_model.dart): `lib/features/album/presentation/album_details_view_model.dart`

### Album domain

- [List use case](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/domain/usecase/get_album_list_use_case.dart): `lib/features/album/domain/usecase/get_album_list_use_case.dart`
- [Details use case](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/domain/usecase/get_album_details_use_case.dart): `lib/features/album/domain/usecase/get_album_details_use_case.dart`
- [Album repository](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/domain/repository/album_repo.dart): `lib/features/album/domain/repository/album_repo.dart`
- [Album entity](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/entity/album.dart): `lib/features/album/entity/album.dart`

### Album data

- [Repository implementation](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/repository/album_repo_imp.dart): `lib/features/album/data/repository/album_repo_imp.dart`
- [Remote data contract](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/repository/album_remote.dart): `lib/features/album/data/repository/album_remote.dart`
- [Remote data source](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/network/album_remote_imp.dart): `lib/features/album/data/network/album_remote_imp.dart`
- [Album API](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/network/service/album_apis.dart): `lib/features/album/data/network/service/album_apis.dart`
- [Album response model](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/features/album/data/network/model/album_model.dart): `lib/features/album/data/network/model/album_model.dart`

### Shared services

- [Base view model](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/presentation/base_view_model.dart): `lib/shared/presentation/base_view_model.dart`
- [Base use case](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/domain/usecase/base_use_case.dart): `lib/shared/domain/usecase/base_use_case.dart`
- [Network setup](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/data/network/di/network_module.dart): `lib/shared/data/network/di/network_module.dart`
- [App router](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/router/router.dart): `lib/shared/router/router.dart`
- [Router setup](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/router/router_module.dart): `lib/shared/router/router_module.dart`
- [Navigation service](https://github.com/developerrahnuma/flutter-mvvm-clean-setup/blob/master/lib/shared/service/navigation_service.dart): `lib/shared/service/navigation_service.dart`

### Other components

- **App user**
- **Album API service**

## Connections

- 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 (evidence: `README.md`)
- List view model → List use case: requests list (evidence: `README.md`)
- List use case → Album repository: retrieves data (evidence: `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 (evidence: `README.md`)
- Details view model → Details use case: requests details (evidence: `README.md`)
- Details use case → Album repository: retrieves data (evidence: `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
