# riadhaidar/animeapp architecture

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

- Interactive diagram: https://gitdiagram.com/riadhaidar/animeapp
- Repository: https://github.com/riadhaidar/animeapp

## Overview

##### Project Type & Purpose
- It’s a cross-platform mobile/desktop/web Flutter application scaffolded with a Clean Architecture.
- The README indicates it’s a starter app; the code under lib/features/shows and lib/features/subscription implements two feature modules (“Shows” and “Subscription”) using layered architecture.

##### File Structure Analysis
- Top-level platform folders (android, ios, linux, macos, windows, web) contain the platform integration and Flutter engine hooks.
- The lib directory is organized by layers:
- core/—dependency injection, theming, error handling, shared widgets
- features/—each feature subdivided into data, domain, presentation
- main.dart bootstraps the app and invokes core/di dependency setup.

##### Key Architectural Patterns
- Clean Architecture (Presentation → Domain → Data)
- Dependency Inversion via a DI container (likely GetIt in core/di)
- Feature-based modularization
- MVC/MVVM isn’t explicit; presentation widgets call domain use-cases directly.

##### Main Components & Interactions
a. Platform Runners
- AndroidRunner, iOSRunner, etc. host the Flutter engine.
b. Flutter Core
- Flutter Engine / Dart VM
- main.dart
c. Core Module
- DependencyInjection: registers UseCases, Repositories, DataSources
- Theming & Shared Widgets
- Error handling
d. Presentation Layer (per feature)
- Screens (e.g. ShowsListScreen, ShowDetailsScreen, SubscriptionsScreen)
- Widgets (ActionButton, CategoryChip, PlanCard…)
- Depends on Domain layer via injected UseCases
e. Domain Layer
- Entities (CharacterEntity, ShowResponseEntity)
- Repository interfaces (ShowsRepository)
- UseCases (GetShowsUseCase)
f. Data Layer
- Repository implementations (ShowsRepositoryImplementation)
- DataSources (MockDataSource; could be replaced by NetworkDataSource)
- Models (character.dart, shows_response_model.dart)
g. External Services
- Currently a mock data source; swap-in external HTTP / local DB in the Data layer.

- Outermost: Platform Runners & Flutter Engine
- Core Module (DI container)
- Presentation Layer
- Domain Layer
- Data Layer
- External Services / Data Sources
- main.dart → Core/DI (initialization)
- Presentation → Domain (UseCase invocation)
- Domain → Data (Repository interface calls)
- Data → DataSource / External API (data fetch)
- DI container → provides dependencies at each boundary
- Core (blue)
- Presentation (green)
- Domain (orange)
- Data (purple)
5. Callouts for:
- core/di/dependency_injection.dart (DI registration)
- main.dart (application entry point)
- key use-case GetShowsUseCase
- mock_data_source (placeholder for real API)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Platform Runners
    subgraph "Platform Runners"
        direction TB
        AndroidRunner["AndroidRunner"]:::platform
        iOSRunner["iOSRunner"]:::platform
        macOSRunner["macOSRunner"]:::platform
        LinuxRunner["LinuxRunner"]:::platform
        WindowsRunner["WindowsRunner"]:::platform
        WebEntry["Web Entry"]:::platform
    end

    %% Flutter Core
    FlutterEngine["Flutter Engine / Dart VM"]:::core
    Main["main.dart"]:::core

    %% Core Module
    subgraph "Core Module"
        direction TB
        DI["dependency_injection.dart"]:::core
        ErrorHandling["failures.dart"]:::core
        subgraph "Theming"
            AppColors["app_colors.dart"]:::core
            FontWeight["font_weight_helper.dart"]:::core
            TextStyles["text_styles.dart"]:::core
        end
        subgraph "Shared Widgets"
            Background1["background_container.dart"]:::core
            Background2["background_container_with_star.dart"]:::core
        end
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        subgraph "Shows"
            ShowList["ShowsListScreen"]:::pres
            ShowDetails["show_details_screen.dart"]:::pres
            ActionButton["action_button.dart"]:::pres
            CategoryChip["category_chip.dart"]:::pres
            ShowWidgets["show_widgets.dart"]:::pres
            StatRow["stat_row.dart"]:::pres
            Transparent["transparent_container.dart"]:::pres
        end
        subgraph "Subscription"
            SubScreen["subscriptions_screen.dart"]:::pres
            PlanCard["plan_card.dart"]:::pres
        end
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        CharacterEntity["character_entity.dart"]:::domain
        ShowResponseEntity["show_response_entity.dart"]:::domain
        ShowsRepoIntf["shows_repository.dart"]:::domain
        GetShowsUseCase["get_shows_use_case.dart"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        CharacterModel["character.dart"]:::data
        ShowsResponseModel["shows_response_model.dart"]:::data
        MockDataSource["mock_data_source.dart"]:::data
        RepoImpl["shows_repository_implementation.dart"]:::data
    end

    %% External Services
    External["External API / DB"]:::external

    %% Relationships
    AndroidRunner -->|hosts| FlutterEngine
    iOSRunner -->|hosts| FlutterEngine
    macOSRunner -->|hosts| FlutterEngine
    LinuxRunner -->|hosts| FlutterEngine
    WindowsRunner -->|hosts| FlutterEngine
    WebEntry -->|loads| FlutterEngine

    FlutterEngine -->|boots| Main
    Main -->|initializes| DI

    DI -->|injects into| ShowList
    DI -->|injects into| ShowDetails
    DI -->|injects into| ActionButton
    DI -->|injects into| SubScreen
    DI -->|injects into| GetShowsUseCase
    DI -->|injects into| RepoImpl

    ShowList -->|"execute()"| GetShowsUseCase
    ShowDetails -->|"execute()"| GetShowsUseCase
    SubScreen -->|"no domain usecase"| GetShowsUseCase

    GetShowsUseCase -->|"fetchShows()"| ShowsRepoIntf
    ShowsRepoIntf -->|"implemented by"| RepoImpl
    RepoImpl -->|"getShows()"| MockDataSource
    MockDataSource -->|"returns data"| External

    %% Click Events
    click AndroidRunner "https://github.com/riadhaidar/animeapp/blob/main/android/app/src/main/kotlin/com/example/cleanarch/MainActivity.kt"
    click iOSRunner "https://github.com/riadhaidar/animeapp/blob/main/ios/Runner/AppDelegate.swift"
    click macOSRunner "https://github.com/riadhaidar/animeapp/blob/main/macos/Runner/AppDelegate.swift"
    click LinuxRunner "https://github.com/riadhaidar/animeapp/blob/main/linux/runner/main.cc"
    click WindowsRunner "https://github.com/riadhaidar/animeapp/blob/main/windows/runner/main.cpp"
    click WebEntry "https://github.com/riadhaidar/animeapp/blob/main/web/index.html"
    click Main "https://github.com/riadhaidar/animeapp/blob/main/lib/main.dart"
    click DI "https://github.com/riadhaidar/animeapp/blob/main/lib/core/di/dependency_injection.dart"
    click ErrorHandling "https://github.com/riadhaidar/animeapp/blob/main/lib/core/error/failures.dart"
    click AppColors "https://github.com/riadhaidar/animeapp/blob/main/lib/core/theming/app_colors.dart"
    click FontWeight "https://github.com/riadhaidar/animeapp/blob/main/lib/core/theming/font_weight_helper.dart"
    click TextStyles "https://github.com/riadhaidar/animeapp/blob/main/lib/core/theming/text_styles.dart"
    click Background1 "https://github.com/riadhaidar/animeapp/blob/main/lib/core/widgets/background_container.dart"
    click Background2 "https://github.com/riadhaidar/animeapp/blob/main/lib/core/widgets/background_container_with_star.dart"
    click ShowDetails "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/presentation/screen/show_details_screen.dart"
    click ActionButton "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/presentation/widgets/action_button.dart"
    click CategoryChip "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/presentation/widgets/category_chip.dart"
    click ShowWidgets "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/presentation/widgets/show_widgets.dart"
    click StatRow "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/presentation/widgets/stat_row.dart"
    click Transparent "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/presentation/widgets/transparent_container.dart"
    click SubScreen "https://github.com/riadhaidar/animeapp/blob/main/lib/features/subscription/screens/subscriptions_screen.dart"
    click PlanCard "https://github.com/riadhaidar/animeapp/blob/main/lib/features/subscription/widgets/plan_card.dart"
    click CharacterEntity "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/domain/entities/character_entity.dart"
    click ShowResponseEntity "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/domain/entities/show_response_entity.dart"
    click ShowsRepoIntf "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/domain/repo/shows_repository.dart"
    click GetShowsUseCase "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/domain/use_cases/get_shows_use_case.dart"
    click CharacterModel "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/data/models/character.dart"
    click ShowsResponseModel "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/data/models/shows_response_model.dart"
    click MockDataSource "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/data/data_sources/mock_data_source.dart"
    click RepoImpl "https://github.com/riadhaidar/animeapp/blob/main/lib/features/shows/data/repositories/shows_repository_implemntation.dart"

    %% Styles
    classDef platform fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef core fill:#cfe2f3,stroke:#333,stroke-width:1px
    classDef pres fill:#d9ead3,stroke:#333,stroke-width:1px
    classDef domain fill:#fce5cd,stroke:#333,stroke-width:1px
    classDef data fill:#ead1dc,stroke:#333,stroke-width:1px
    classDef external stroke-dasharray: 5 5,stroke:#333,fill:none
```
