# mohamedrashad102/flutter-mentors-r3 architecture

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

- Interactive diagram: https://gitdiagram.com/mohamedrashad102/flutter-mentors-r3
- Repository: https://github.com/mohamedrashad102/flutter-mentors-r3

## Overview

##### Project type and purpose
- This repo is a collection of Flutter mentorship assignments. Each branch (week1, week2, …) contains a standalone Flutter mobile app. The main branch only holds the README – the actual code lives in those weekly branches.

##### File structure
- Although the main branch only shows README.md, expect each week-branch to follow the standard Flutter project layout:
- android/ & ios/ (platform folders)
- lib/ (Dart source files)
- test/ (unit/widget tests)
- pubspec.yaml (dependencies)
- Within lib/, look for subfolders like screens (UI), widgets (reusable UI), models (data structures), services or repositories (data access), and state management (Blocs, Providers, Controllers).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Project Root
    ProjectRoot["Project: Flutter Mentorship Assignments"]
    README["README.md"]:::external
    
    ProjectRoot --> README

    %% Application Architecture
    subgraph "Flutter App Architecture"
        direction TB

        subgraph "Presentation Layer" 
            direction TB
            Screens["Screens (UI)"]:::ui
            Widgets["Widgets (UI)"]:::ui
        end

        subgraph "State Management Layer"
            direction TB
            BlocProvider["BLoC / Provider / Riverpod"]:::state
        end

        subgraph "Domain Layer"
            direction TB
            UseCases["Use Case / Controllers"]:::state
        end

        subgraph "Data Layer"
            direction TB
            Repository["Repositories"]:::data
            LocalDataSource["Local Data Source\n(shared_preferences, sqflite)"]:::data
            RemoteDataSource["Remote Data Source\n(HTTP, Dio)"]:::data
        end

        subgraph "External Services"
            direction TB
            Firebase["Firebase / Third-Party APIs"]:::external
        end
    end

    %% Data flow
    Screens -->|"user events"| BlocProvider
    Widgets -->|"widget events"| BlocProvider
    BlocProvider -->|"invokes"| UseCases
    UseCases -->|"calls"| Repository
    Repository -->|"reads/writes"| LocalDataSource
    Repository -->|"fetches"| RemoteDataSource
    RemoteDataSource -->|"API calls"| Firebase

    %% Click Events
    click README "https://github.com/mohamedrashad102/flutter-mentors-r3/blob/main/README.md"

    %% Styles
    classDef ui fill:#cce5ff,stroke:#00529B,color:#00529B;
    classDef state fill:#d4edda,stroke:#4F8A10,color:#4F8A10;
    classDef data fill:#fff4e5,stroke:#9F6000,color:#9F6000;
    classDef external fill:#f8d7da,stroke:#D8000C,color:#D8000C;
```
