# devendroid/trainiings_app architecture

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

- Interactive diagram: https://gitdiagram.com/devendroid/trainiings_app
- Repository: https://github.com/devendroid/trainiings_app

## Overview

##### Project Type and Purpose
- This is a cross-platform mobile application built with Flutter. It follows a layered architecture (presentation, domain, data) and demonstrates the BLoC pattern, dependency injection via get_it, theming, routing, and mock data repositories. Its purpose is to display “trainings” with lists, highlights, filters, and details using Flutter widgets on both Android and iOS.

##### File Structure Analysis
- Top-level mobile targets:
- android/ – Gradle build, manifests, Kotlin MainActivity, resources
- ios/ – Xcode project, Swift/AppDelegate, storyboards, asset catalogs
- Shared Dart code under lib/:
- main.dart – app entry point, DI setup, MaterialApp/router
- routing/ – route_name.dart, router.dart (navigation management)
- core/ – datasource (mock), di (service locator), theme, utils
- features/
– shared/ – reusable widgets and modal classes
– trainings/ – domain (usecases, repository interface), data (mock datasource, repository impl), presentation (bloc/cubit, UI screens, widgets)
- Configuration and metadata: pubspec.yaml, analysis_options.yaml, assets/, media/, test/

##### Insights from README
- Explicit description of the three-layered structure:
- data: “Mock API or training repository”
- domain: “Usecases containing business logic”
- presentation: “BLoC logic for state management” + Flutter UI
- Lists external dependencies: flutter_bloc, equatable, get_it, carousel_slider, modal_bottom_sheet

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Platform Shells
    subgraph "Platform Shells"
        style PS fill:#f3f3f3,stroke:#999
        AndroidHost["Android Host"]:::platform
        iOSHost["iOS Host"]:::platform
    end

    %% Flutter Engine and App Entry
    FlutterEngine["Flutter Engine"]:::core
    MainApp["App Entry Point\n(main.dart)"]:::core

    %% Core Utilities
    subgraph "Core Utilities"
        DI["Dependency Injection\n(dependencies.dart)"]:::core
        Theme["Theming & Styling\n(app_theme.dart,\nfont_family.dart)"]:::core
        APIState["API Response State\n(api_resp_state.dart)"]:::core
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        style PL fill:#cce5ff,stroke:#339
        subgraph Routing
            Router["Router\n(router.dart)"]:::presentation
            RouteName["Route Names\n(route_name.dart)"]:::presentation
        end
        subgraph StateMgmt
            Bloc["TrainingBloc\n(training_bloc.dart)"]:::presentation
            Cubit["TrainingCubit\n(training_cubit.dart)"]:::presentation
        end
        subgraph Screens
            Home["Home Screen\n(home_screen.dart)"]:::presentation
            Detail["Training Detail Screen\n(training_detail_screen.dart)"]:::presentation
        end
        subgraph Widgets
            FilterBtn["Filter Button\n(filter_button.dart)"]:::presentation
            FilterModal["Filter Modal\n(filter_modal.dart)"]:::presentation
            Carousel["Highlight Carousel\n(highlight_carousel.dart)"]:::presentation
            Card["Training Card\n(training_card.dart)"]:::presentation
            ListW["Training List\n(training_list.dart)"]:::presentation
            SharedWidget["Vertical Dashed Line\n(vertical_dashed_line.dart)"]:::presentation
        end
    end

    %% Domain Layer
    subgraph "Domain Layer"
        style DL fill:#e6f7ff,stroke:#66b2ff
        UList["Get Training List\n(get_training_list.dart)"]:::domain
        UFilter["Get Filtered List\n(get_filtered_list.dart)"]:::domain
        UHighlights["Get Highlights\n(get_highlights.dart)"]:::domain
        UAggregate["TrainingUseCase Interface\n(training_usecase.dart)"]:::domain
        RepoInt["TrainingRepository Interface\n(training_repository.dart)"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        style DataL fill:#e0ffff,stroke:#00b3b3
        RepoImpl["TrainingRepositoryImpl\n(training_repository_impl.dart)"]:::data
        Datasource["Mock Trainings Datasource\n(mock_trainings.dart)"]:::data
    end

    %% External Packages
    subgraph "External Packages"
        style EP fill:#ffe6cc,stroke:#ff9933
        pkg1["flutter_bloc"]:::external
        pkg2["equatable"]:::external
        pkg3["get_it"]:::external
        pkg4["carousel_slider"]:::external
        pkg5["modal_bottom_sheet"]:::external
    end

    %% Relationships
    AndroidHost --> FlutterEngine
    iOSHost --> FlutterEngine
    FlutterEngine --> MainApp
    MainApp --> DI
    MainApp --> Theme
    MainApp --> Router
    MainApp --> RouteName

    Home -->|navigates via| Router
    Detail -->|navigates via| Router

    Home --> Bloc
    Home --> Cubit
    FilterBtn --> Bloc
    FilterModal --> Bloc
    Carousel --> Bloc
    Card --> Bloc
    ListW --> Bloc
    SharedWidget --> Home
    SharedWidget --> Detail

    Bloc --> UList
    Bloc --> UFilter
    Bloc --> UHighlights
    Cubit --> UList
    Cubit --> UFilter
    Cubit --> UHighlights

    UList --> RepoInt
    UFilter --> RepoInt
    UHighlights --> RepoInt
    UAggregate --> RepoInt

    RepoInt --> RepoImpl
    RepoImpl --> Datasource

    Datasource --> RepoImpl
    RepoImpl --> RepoInt
    RepoInt --> UList
    UList --> Bloc
    Bloc --> Home

    %% Core Utilities usage
    Bloc --> DI
    Cubit --> DI
    Router --> DI

    %% External Packages usage
    Bloc --> pkg1
    Bloc --> pkg2
    Cubit --> pkg1
    pkg3 --> DI
    Carousel --> pkg4
    FilterModal --> pkg5

    %% Click Events
    click AndroidHost "https://github.com/devendroid/trainiings_app/tree/main/android/"
    click iOSHost "https://github.com/devendroid/trainiings_app/tree/main/ios/"
    click MainApp "https://github.com/devendroid/trainiings_app/blob/main/lib/main.dart"
    click Router "https://github.com/devendroid/trainiings_app/blob/main/lib/routing/router.dart"
    click RouteName "https://github.com/devendroid/trainiings_app/blob/main/lib/routing/route_name.dart"
    click Home "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/home_screen.dart"
    click Detail "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/training_detail_screen.dart"
    click Bloc "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/bloc/training_bloc.dart"
    click Cubit "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/bloc/training_cubit.dart"
    click FilterBtn "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/widgets/filter_button.dart"
    click FilterModal "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/widgets/filter_modal.dart"
    click Carousel "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/widgets/highlight_carousel.dart"
    click Card "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/widgets/training_card.dart"
    click ListW "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/presentation/widgets/training_list.dart"
    click SharedWidget "https://github.com/devendroid/trainiings_app/blob/main/lib/features/shared/widgets/vertical_dashed_line.dart"
    click UList "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/domain/usecase/get_training_list.dart"
    click UFilter "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/domain/usecase/get_filtered_list.dart"
    click UHighlights "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/domain/usecase/get_highlights.dart"
    click UAggregate "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/domain/usecase/training_usecase.dart"
    click RepoInt "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/domain/repository/training_repository.dart"
    click RepoImpl "https://github.com/devendroid/trainiings_app/blob/main/lib/features/trainings/data/repository/training_repository_impl.dart"
    click Datasource "https://github.com/devendroid/trainiings_app/blob/main/lib/core/datasource/mock_trainings.dart"
    click DI "https://github.com/devendroid/trainiings_app/blob/main/lib/core/di/dependencies.dart"
    click Theme "https://github.com/devendroid/trainiings_app/blob/main/lib/core/theme/app_theme.dart"
    click Theme "https://github.com/devendroid/trainiings_app/blob/main/lib/core/theme/font_family.dart"
    click APIState "https://github.com/devendroid/trainiings_app/blob/main/lib/features/shared/modal/api_resp_state.dart"

    %% Styles
    classDef platform fill:#f3f3f3,stroke:#666,stroke-width:1px
    classDef core fill:#d9ead3,stroke:#6aa84f,stroke-width:1px
    classDef presentation fill:#cce5ff,stroke:#339,stroke-width:1px
    classDef domain fill:#e6f7ff,stroke:#66b2ff,stroke-width:1px
    classDef data fill:#e0ffff,stroke:#00b3b3,stroke-width:1px
    classDef external fill:#ffe6cc,stroke:#ff9933,stroke-width:1px
```
