# zainulabdn/learning architecture

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

- Interactive diagram: https://gitdiagram.com/zainulabdn/learning
- Repository: https://github.com/zainulabdn/learning

## Overview

##### Project type and purpose
- This repo is not an application codebase but a **learning roadmap** for Flutter & Dart developers.
- It’s organized as a sequence of **practicals** grouped by topic (Material UI, Navigation, Networking, State Management, Local Storage, Streams, Firestore, SOLID Principles).
- Its purpose is to guide a learner through progressively advanced Flutter concepts via hands-on exercises.

##### File structure
- There is only one top-level file: **README.md**, which contains the entire curriculum.
- No source code or subdirectories exist; the structure is purely conceptual.
- All “components” of the system are the **thematic modules** and their dependencies on one another.

##### README for additional insights
- The table of contents lists **29 practical modules** grouped under major topics.
- Each topic introduces a set of exercises that build on core Flutter/Dart concepts and external services (APIs, Firebase).
- Repeated reference to architectural patterns (MVVM, Provider, Riverpod, BLoC, DI) and technologies.

##### Main components
a. **Curriculum Shell** – the root “system.”
b. **Topic Modules** – Material Components, Navigation & Routing, Networking, State Management, Local Storage, Streams, Firestore Database, SOLID Principles.
c. **Practicals** – numbered exercises under each module.
d. **Technologies & Patterns** – Flutter UI (Material 3), Dart, MVVM, Provider, Riverpod, flutter_bloc, injectable/getIt, HTTP/dio, SQLite, Firebase Auth/Firestore, Streams.
e. **External Services & APIs** – JSONPlaceholder, Yummly, TheCocktailDB, NewsAPI, Firebase, dummyjson, dictionary API, funtranslations API.
f. **Learner** – the end-consumer interacting with exercises.

##### Relationships and interactions
- **Curriculum Shell** → contains **Topic Modules**.
- Each **Topic Module** → links to a set of **Practicals**.
- **Practicals** → depend on specific **Technologies & Patterns** and often call **External Services & APIs**.
- **State Management** and **Dependency Injection** patterns cross-cut multiple modules (Networking, Local Storage, Firestore).

##### Architectural patterns & design principles
- **Layered Approach**:
- UI (Flutter widgets)
- State Management (ViewModel classes via Provider/Riverpod/BLoC)
- Data Layer:
– Remote (HTTP/dio → APIs)
– Local (SQLite, Firestore)
- Dependency Injection (injectable/getIt)
- **MVVM** is the recommended presentation architecture.
- **SOLID** principles emphasized at the end.

##### Elements
- **Clear labels**: name each module, practical, technology, and external service.
- Learner’s path from module to module.
- Dependencies from practicals to technologies and APIs.

##### Final advice
- Every major topic as its own component.
- How each practical exercise pulls in specific technologies and services.
- Keep the learner’s journey visible, from Material UI basics through advanced Streams and Firestore.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Curriculum Shell
    Curriculum["Flutter & Dart Developer Roadmap"]:::shell

    %% Topic Modules in sequence
    subgraph "Material UI (Pracs 1-5)" 
        direction TB
        MUI["Practical 1-5"]:::practical
    end
    subgraph "Navigation & Routing (Pracs 6-9)"
        direction TB
        NAV["Practical 6-9"]:::practical
    end
    subgraph "Networking (Pracs 10-13)"
        direction TB
        NET["Practical 10-13"]:::practical
    end
    subgraph "State Management (Pracs 14-18)"
        direction TB
        SM["Practical 14-18"]:::practical
    end
    subgraph "Local Storage (Pracs 19-21)"
        direction TB
        LS["Practical 19-21"]:::practical
    end
    subgraph "Streams (Pracs 22-24)"
        direction TB
        STRM["Practical 22-24"]:::practical
    end
    subgraph "Firestore Database (Pracs 25-27)"
        direction TB
        FS["Practical 25-27"]:::practical
    end
    subgraph "SOLID Principles (Pracs 28-29)"
        direction TB
        SOLID["Practical 28-29"]:::practical
    end

    %% Technologies & Patterns
    subgraph "Technologies & Patterns"
        direction TB
        UI["Flutter UI (Material3)"]:::tech
        Dart["Dart"]:::tech
        MVVM["MVVM"]:::tech
        Prov["Provider/Riverpod"]:::tech
        BLoC["flutter_bloc"]:::tech
        DI["injectable/getIt"]:::tech
        HTTP["HTTP/dio"]:::tech
        SQLite["SQLite"]:::tech
        FireAuth["Firebase Auth/Firestore SDK"]:::tech
        StreamsTech["Streams"]:::tech
    end

    %% External Services & APIs
    subgraph "External Services & APIs"
        direction TB
        JSONP["JSONPlaceholder"]:::cloud
        Yummly["Yummly API"]:::cloud
        Cocktail["TheCocktailDB"]:::cloud
        News["NewsAPI"]:::cloud
        FirebaseExt["Firebase"]:::cloud
        Dummy["dummyjson"]:::cloud
        Dict["Dictionary API"]:::cloud
        FunTrans["Funtranslations API"]:::cloud
    end

    %% Learner
    Learner([Learner Persona]):::learner

    %% Flow
    Learner --> Curriculum
    Curriculum --> MUI --> NAV --> NET --> SM --> LS --> STRM --> FS --> SOLID

    %% Dependencies from Networking to External
    NET --> JSONP
    NET --> Yummly
    NET --> Cocktail
    NET --> News
    NET --> Dummy
    NET --> Dict
    NET --> FunTrans

    %% Firestore uses Firebase
    FS --> FirebaseExt

    %% Cross-cutting: dashed arrows from modules to technologies
    MUI -.-> UI
    NAV -.-> UI
    NAV -.-> MVVM
    NET -.-> HTTP
    NET -.-> Dart
    SM -.-> Prov
    SM -.-> BLoC
    SM -.-> DI
    LS -.-> SQLite
    LS -.-> DI
    STRM -.-> StreamsTech
    FS -.-> FireAuth
    SM -.-> MVVM

    %% Legend grouping DI and Patterns
    SM -.-> DI
    FS -.-> DI

    %% Click Events
    click Curriculum "https://github.com/zainulabdn/learning/blob/main/README.md"
    click MUI "https://github.com/zainulabdn/learning/blob/main/README.md"
    click NAV "https://github.com/zainulabdn/learning/blob/main/README.md"
    click NET "https://github.com/zainulabdn/learning/blob/main/README.md"
    click SM "https://github.com/zainulabdn/learning/blob/main/README.md"
    click LS "https://github.com/zainulabdn/learning/blob/main/README.md"
    click STRM "https://github.com/zainulabdn/learning/blob/main/README.md"
    click FS "https://github.com/zainulabdn/learning/blob/main/README.md"
    click SOLID "https://github.com/zainulabdn/learning/blob/main/README.md"
    click UI "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Dart "https://github.com/zainulabdn/learning/blob/main/README.md"
    click MVVM "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Prov "https://github.com/zainulabdn/learning/blob/main/README.md"
    click BLoC "https://github.com/zainulabdn/learning/blob/main/README.md"
    click DI "https://github.com/zainulabdn/learning/blob/main/README.md"
    click HTTP "https://github.com/zainulabdn/learning/blob/main/README.md"
    click SQLite "https://github.com/zainulabdn/learning/blob/main/README.md"
    click FireAuth "https://github.com/zainulabdn/learning/blob/main/README.md"
    click StreamsTech "https://github.com/zainulabdn/learning/blob/main/README.md"
    click JSONP "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Yummly "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Cocktail "https://github.com/zainulabdn/learning/blob/main/README.md"
    click News "https://github.com/zainulabdn/learning/blob/main/README.md"
    click FirebaseExt "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Dummy "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Dict "https://github.com/zainulabdn/learning/blob/main/README.md"
    click FunTrans "https://github.com/zainulabdn/learning/blob/main/README.md"
    click Learner "https://github.com/zainulabdn/learning/blob/main/README.md"

    %% Styles
    classDef shell fill:#ffd966,stroke:#333,stroke-width:2px
    classDef practical fill:#d9d9d9,stroke:#555,stroke-width:1px,rounded
    classDef tech fill:#c9daf8,stroke:#255e91,stroke-width:1px,shape:ellipse
    classDef cloud fill:#b4a7d6,stroke:#6c3483,stroke-width:1px,shape:cloud
    classDef learner fill:#f4cccc,stroke:#a6192e,stroke-width:2px,shape:hexagon
```
