# venkataphanindravutla/abhiyanth-flutter architecture

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

- Interactive diagram: https://gitdiagram.com/venkataphanindravutla/abhiyanth-flutter
- Repository: https://github.com/venkataphanindravutla/abhiyanth-flutter

## Overview

##### Main Components

a. Client-Side (Mobile Application)
- Flutter UI Layer
- State Management Layer (ViewModels)
- Services Layer
- Models Layer
- Firebase Integration

b. Backend Services
- Firebase Services (indicated by firebase_options.dart and google-services.json)

##### Widget Layer
- Custom UI Components (gradient_text, gradient_icon, etc.)
- Feature Widgets (event_card_widget, map_widget, etc.)

##### ViewModel Layer (State Management)
- Authentication (loginview_model, signupview_model)
- Feature-specific (auditions_provider, culturals_provider)
- Event Management (event_viewmodel, event_state_provider)

##### Services Layer
- Navigation Service
- Event Service
- User Service
- Cultural Service
- Auditions Service

##### Models Layer
- Data models (user_model)

##### External Services
- Firebase Integration
- Any other external APIs

B. Cross-Cutting Concerns:
- Constants and Themes
- Utilities
- Navigation/Routing System

##### Specific Elements to Highlight

a. MVVM Architecture Pattern:
- Clear separation between Views, ViewModels, and Models
- Data binding between Views and ViewModels

b. Service Locator Pattern:
- Locator.dart's role in dependency injection
- Service registration and resolution flow

c. Navigation System:
- Routing system (routes.dart, routesname.dart)
- Navigation flow between screens

d. Firebase Integration:
- Firebase services connection
- Authentication flow
- Data persistence flow

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Presentation Layer"
        direction TB
        AuthViews["Authentication Views"]:::ui
        MainViews["Main Content Views"]:::ui
        FeatureViews["Feature Views"]:::ui
        
        subgraph "Widgets Layer"
            direction TB
            CustomUI["Custom UI Components"]:::ui
            FeatureWidgets["Feature Widgets"]:::ui
        end
    end

    subgraph "State Management Layer"
        direction TB
        AuthVM["Authentication ViewModels"]:::viewmodel
        EventVM["Event ViewModels"]:::viewmodel
        FeatureVM["Feature ViewModels"]:::viewmodel
    end

    subgraph "Services Layer"
        direction TB
        NavService["Navigation Service"]:::service
        EventService["Event Service"]:::service
        UserService["User Service"]:::service
        CulturalService["Cultural Service"]:::service
        AuditionService["Auditions Service"]:::service
    end

    subgraph "Models Layer"
        direction TB
        UserModel["User Model"]:::model
    end

    subgraph "External Services"
        direction TB
        Firebase["Firebase"]:::external
    end

    subgraph "Cross-Cutting Concerns"
        direction TB
        ServiceLocator["Service Locator"]:::utility
        Constants["Constants & Themes"]:::utility
        Utils["Utilities"]:::utility
    end

    %% Connections
    AuthViews --> AuthVM
    MainViews --> EventVM
    FeatureViews --> FeatureVM
    
    AuthVM --> UserService
    EventVM --> EventService
    FeatureVM --> CulturalService
    FeatureVM --> AuditionService
    
    UserService --> Firebase
    EventService --> Firebase
    CulturalService --> Firebase
    AuditionService --> Firebase
    
    ServiceLocator --> NavService
    ServiceLocator --> EventService
    ServiceLocator --> UserService
    ServiceLocator --> CulturalService
    ServiceLocator --> AuditionService

    %% Click Events
    click AuthViews "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/views/"
    click MainViews "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/views/"
    click CustomUI "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/widgets/"
    click FeatureWidgets "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/widgets/"
    click AuthVM "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/viewmodels/"
    click EventVM "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/viewmodels/"
    click FeatureVM "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/tree/main/lib/viewmodels/"
    click NavService "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/services/Routes/navigation_service.dart"
    click EventService "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/services/event_service.dart"
    click UserService "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/services/user_service.dart"
    click CulturalService "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/services/culturals_service.dart"
    click AuditionService "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/services/auditions_service.dart"
    click UserModel "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/models/user_model.dart"
    click Firebase "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/firebase_options.dart"
    click ServiceLocator "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/locator.dart"
    click Constants "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/constants/custom_theme.dart"
    click Utils "https://github.com/venkataPhanindraVutla/abhiyanth-flutter/blob/main/lib/utilities/gradient_background.dart"

    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef viewmodel fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#f1c40f,stroke:#f39c12,color:black
    classDef model fill:#9b59b6,stroke:#8e44ad,color:white
    classDef external fill:#e74c3c,stroke:#c0392b,color:white
    classDef utility fill:#95a5a6,stroke:#7f8c8d,color:white

    %% Legend
    subgraph Legend
        UI["UI Components"]:::ui
        VM["ViewModels"]:::viewmodel
        SVC["Services"]:::service
        MDL["Models"]:::model
        EXT["External Services"]:::external
        UTL["Utilities"]:::utility
    end
```
