# shahzaneer/mvvm-architecture-provider-in-flutter architecture

> Architecture diagram of the GitHub repository shahzaneer/mvvm-architecture-provider-in-flutter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shahzaneer/mvvm-architecture-provider-in-flutter
- Repository: https://github.com/shahzaneer/mvvm-architecture-provider-in-flutter

## Overview

##### Project Overview
This is a Flutter mobile application that implements the MVVM architectural pattern. The project structure clearly shows a well-organized separation of concerns, focusing on maintainability, scalability, and testability.

##### Main Components

- View Layer (Top)
- ViewModel Layer
- Repository Layer
- Data Layer (Bottom)

- Utils
- Resources
- Network Services
- Response Handlers

##### View Layer (UI)
- SplashScreen
- LoginScreen
- SignupScreen
- HomeScreen

##### ViewModel Layer
- AuthViewModel
- HomeViewModel
- UserViewModel
- SplashService

##### Repository Layer
- AuthRepository
- HomeRepository

##### Data Layer
- NetworkApiServices
- BaseApiServices
- Models (UserModel, MoviesModel)

##### Supporting Components (Right Side)
- Routes
- Utils
- AppUrls
- Widgets

##### Additional Elements
- A title "Flutter MVVM Architecture"
- Notes about key architectural decisions

Key Relationships to Highlight:
- Views observe ViewModels
- ViewModels communicate with Repositories
- Repositories handle data operations through Network Services
- Utils and Resources are accessible by all layers

Special Considerations:
##### How Routes manage navigation between views

Level of Detail:
- Keep the main architectural components visible at a glance
- Brief descriptions of each layer's responsibility

Remember to:
- Clear labels and annotations
- Version information
- External dependencies or services

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "View Layer"
        SplashScreen["SplashScreen"]:::view
        LoginScreen["LoginScreen"]:::view
        SignupScreen["SignupScreen"]:::view
        HomeScreen["HomeScreen"]:::view
    end

    subgraph "ViewModel Layer"
        AuthViewModel["AuthViewModel"]:::viewmodel
        HomeViewModel["HomeViewModel"]:::viewmodel
        UserViewModel["UserViewModel"]:::viewmodel
        SplashService["SplashService"]:::viewmodel
    end

    subgraph "Repository Layer"
        AuthRepo["AuthRepository"]:::repo
        HomeRepo["HomeRepository"]:::repo
    end

    subgraph "Data Layer"
        NetworkApi["NetworkApiServices"]:::data
        BaseApi["BaseApiServices"]:::data
        AppExceptions["AppExceptions"]:::data
        ApiResponse["ApiResponse"]:::data
        Status["Status"]:::data
        
        subgraph "Models"
            UserModel["UserModel"]:::model
            MoviesModel["MoviesModel"]:::model
        end
    end

    subgraph "Supporting Components"
        subgraph "Utils"
            Routes["Routes"]:::util
            RouteNames["RouteNames"]:::util
            Utils["Utils"]:::util
        end
        
        subgraph "Resources"
            AppUrls["AppUrls"]:::resource
            Colors["Colors"]:::resource
            RoundButton["RoundButton Widget"]:::resource
        end
    end

    %% Relationships
    SplashScreen <--> SplashService
    LoginScreen <--> AuthViewModel
    SignupScreen <--> AuthViewModel
    HomeScreen <--> HomeViewModel
    
    AuthViewModel --> AuthRepo
    HomeViewModel --> HomeRepo
    UserViewModel --> AuthRepo
    
    AuthRepo --> NetworkApi
    HomeRepo --> NetworkApi
    NetworkApi --> BaseApi
    
    NetworkApi --> AppExceptions
    NetworkApi --> ApiResponse
    ApiResponse --> Status
    
    AuthRepo --> UserModel
    HomeRepo --> MoviesModel

    %% Click Events
    click SplashScreen "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/view/splash_screen.dart"
    click LoginScreen "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/view/login_screen.dart"
    click SignupScreen "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/view/signup_screen.dart"
    click HomeScreen "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/view/home_screen.dart"
    click AuthViewModel "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/viewModel/auth_viewmodel.dart"
    click HomeViewModel "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/viewModel/home_view_model.dart"
    click UserViewModel "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/viewModel/user_view_model.dart"
    click SplashService "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/viewModel/splash_service.dart"
    click AuthRepo "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/repository/auth_repository.dart"
    click HomeRepo "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/repository/home_repository.dart"
    click NetworkApi "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/data/network/network_api_services.dart"
    click BaseApi "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/data/network/base_api_services.dart"
    click AppExceptions "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/data/app_exceptions.dart"
    click ApiResponse "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/data/response/api_response.dart"
    click Status "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/data/response/status.dart"
    click UserModel "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/models/user_model.dart"
    click MoviesModel "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/models/movies_model.dart"
    click Routes "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/utils/routes/routes.dart"
    click RouteNames "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/utils/routes/routes_names.dart"
    click Utils "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/utils/utils.dart"
    click AppUrls "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/res/widgets/app_urls.dart"
    click Colors "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/res/widgets/coloors.dart"
    click RoundButton "https://github.com/shahzaneer/MVVM-Architecture-Provider-in-Flutter/blob/main/lib/res/widgets/round_button.dart"

    %% Styling
    classDef view fill:#e1f5fe,stroke:#01579b
    classDef viewmodel fill:#ffe0b2,stroke:#e65100
    classDef repo fill:#c8e6c9,stroke:#1b5e20
    classDef data fill:#e1bee7,stroke:#4a148c
    classDef model fill:#f8bbd0,stroke:#880e4f
    classDef util fill:#fff3e0,stroke:#ff6f00
    classDef resource fill:#f5f5f5,stroke:#212121

    %% Legend
    subgraph Legend
        L1[View]:::view
        L2[ViewModel]:::viewmodel
        L3[Repository]:::repo
        L4[Data Services]:::data
        L5[Models]:::model
        L6[Utils]:::util
        L7[Resources]:::resource
    end
```
