# touqeerulhussnain/web_portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/touqeerulhussnain/web_portfolio
- Repository: https://github.com/touqeerulhussnain/web_portfolio

## Overview

##### Project type and purpose
- This is a cross-platform Flutter application that functions as a personal portfolio and CV (“Nimbus”).
- It targets three “platforms”: Android, iOS and Web, all sharing a single Dart/Flutter codebase.
- No backend or database—content is static (values/data.dart, assets/screenshots, images).

##### File structure
Top-level directories:
- android — native Android wrapper/build config
- ios — native iOS wrapper/build config
- web — web entrypoint and static manifest
- lib — Dart/Flutter source, divided into:
– main.dart & app_theme.dart
– presentation: routes, pages, layout utilities, widgets
– utils: helper functions
- assets — images, screenshots
- test — widget tests
- .github/workflows — CI/CD pipeline (cd.yml)
- pubspec.yaml / lock — package dependencies

##### Key architectural insights from README
- Single-page, static content, client-only Flutter app.
- Deployed to GitHub Pages for web.
- Inspired by a design mockup; emphasis on adaptive layout (mobile vs web).

##### Detail
- Adaptive layout branch splitting (mobile vs web widget variants)
- Router layer and code-generated artifacts
- Flow of static data (values/data.dart) into the UI components

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Development & CI/CD
    subgraph "Development & CI/CD"
        direction TB
        Dev["Developer"]:::external
        Repo["GitHub Repo"]:::external
        CI["GitHub Actions Workflow"]:::ci
        Dev -->|"push code"| Repo
        Repo -->|"trigger"| CI
    end

    %% Build & Deployment
    subgraph "Build & Deployment"
        direction TB
        FLTool["Flutter Toolchain"]:::build
        CI -->|"runs cd.yml"| FLTool
        FLTool -->|"build apk/ipa/web"| APK["Android APK"]:::deploy
        FLTool -->|"build ipa"| IPA["iOS IPA"]:::deploy
        FLTool -->|"build web"| WEBBuild["Web Artifacts"]:::deploy
        APK -->|"deploy"| PlayStore["Play Store"]:::deploy
        IPA -->|"deploy"| AppStore["App Store"]:::deploy
        WEBBuild -->|"deploy"| GHPages["GitHub Pages"]:::deploy
    end

    %% Runtime Platforms
    subgraph "Runtime Platforms"
        direction TB
        AND["Android Device\n(ART + Flutter Engine)"]:::platform
        IOS["iOS Device\n(Flutter Engine + UIKit)"]:::platform
        WEB["Web Browser\n(JS/CSS/HTML)"]:::platform
    end

    %% Flutter Core & UI Layers
    subgraph "Flutter Core & UI Layers"
        direction TB
        Entry["lib/main.dart\n(Entrypoint)"]:::core
        Theme["lib/app_theme.dart\n(Theme & Config)"]:::core
        Values["lib/values/data.dart\n(Static Values & Data)"]:::data
        RouterSrc["lib/presentation/routes/router.dart"]:::core
        RouterGen["lib/presentation/routes/router.gr.dart"]:::core
        Layout["lib/presentation/layout/adaptive.dart"]:::ui
        Utils["lib/utils/functions.dart"]:::core

        subgraph "Presentation"
            direction TB
            Pages["lib/presentation/pages/home/home_page.dart\n(Home Page)"]:::ui
            subgraph "Home Sections"
                direction TB
                About["about_me_section.dart"]:::ui
                Awards["awards_section.dart"]:::ui
                Blog["blog_section.dart"]:::ui
                Brand["brand_section.dart"]:::ui
                Footer["footer_section.dart"]:::ui
                Header["header_section"]:::ui
                HeaderMob["header_section_mobile.dart"]:::ui
                HeaderWeb["header_section_web.dart"]:::ui
                NavMob["nav_section_mobile.dart"]:::ui
                NavWeb["nav_section_web.dart"]:::ui
                Projects["projects_section.dart"]:::ui
                Skills["skills_section.dart"]:::ui
                Stats["statistics_section.dart"]:::ui
                Testimonials["testimonials_section.dart"]:::ui
            end
            Widgets["lib/presentation/widgets"]:::ui
        end
        Assets["assets/images/\nand assets/screenshots/"]:::assets
    end

    %% Connections
    Repo --> CI
    CI --> FLTool
    AND --> Entry
    IOS --> Entry
    WEB --> Entry

    Entry --> Theme
    Theme --> RouterSrc
    RouterSrc --> RouterGen
    RouterGen --> Pages
    Pages --> Layout
    Layout --> Widgets
    Widgets --> Assets
    Values --> Pages
    Utils --> Layout

    %% Click Events
    click CI "https://github.com/touqeerulhussnain/web_portfolio/blob/main/.github/workflows/cd.yml"
    click AND "https://github.com/touqeerulhussnain/web_portfolio/blob/main/android/app/src/main/AndroidManifest.xml"
    click AND "https://github.com/touqeerulhussnain/web_portfolio/blob/main/android/app/build.gradle"
    click IOS "https://github.com/touqeerulhussnain/web_portfolio/blob/main/ios/Runner.xcodeproj/project.pbxproj"
    click IOS "https://github.com/touqeerulhussnain/web_portfolio/blob/main/ios/Runner/Info.plist"
    click WEB "https://github.com/touqeerulhussnain/web_portfolio/blob/main/web/index.html"
    click WEB "https://github.com/touqeerulhussnain/web_portfolio/blob/main/web/manifest.json"
    click Entry "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/main.dart"
    click Theme "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/app_theme.dart"
    click Values "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/values/data.dart"
    click RouterSrc "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/routes/router.dart"
    click RouterGen "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/routes/router.gr.dart"
    click Layout "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/layout/adaptive.dart"
    click Pages "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/home_page.dart"
    click About "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/about_me_section.dart"
    click Awards "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/awards_section.dart"
    click Blog "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/blog_section.dart"
    click Brand "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/brand_section.dart"
    click Footer "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/footer_section.dart"
    click Header "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/header_section/header_section.dart"
    click HeaderMob "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/header_section/header_section_mobile.dart"
    click HeaderWeb "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/header_section/header_section_web.dart"
    click NavMob "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/nav_section/nav_section_mobile.dart"
    click NavWeb "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/nav_section/nav_section_web.dart"
    click Projects "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/projects_section.dart"
    click Skills "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/skills_section.dart"
    click Stats "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/statistics_section.dart"
    click Testimonials "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/presentation/pages/home/sections/testimonials_section.dart"
    click Widgets "https://github.com/touqeerulhussnain/web_portfolio/tree/main/lib/presentation/widgets/"
    click Utils "https://github.com/touqeerulhussnain/web_portfolio/blob/main/lib/utils/functions.dart"
    click Assets "https://github.com/touqeerulhussnain/web_portfolio/tree/main/assets/images/"
    click Assets "https://github.com/touqeerulhussnain/web_portfolio/tree/main/assets/screenshots/"
    click PKG["pubspec.yaml"] "pubspec.yaml"
    click PKGLock["pubspec.lock"] "pubspec.lock"
    click Test["test/widget_test.dart"] "test/widget_test.dart"

    %% Styles
    classDef external fill:#D0E8FF,stroke:#0066CC,color:#003366
    classDef ci fill:#B3E5FC,stroke:#0288D1,color:#01579B
    classDef build fill:#C8E6C9,stroke:#2E7D32,color:#1B5E20
    classDef deploy fill:#A5D6A7,stroke:#388E3C,color:#1B5E20
    classDef platform fill:#E1BEE7,stroke:#8E24AA,color:#4A148C
    classDef core fill:#FFE0B2,stroke:#FB8C00,color:#E65100
    classDef ui fill:#FFF9C4,stroke:#FBC02D,color:#F57F17
    classDef data fill:#CFD8DC,stroke:#455A64,color:#263238
    classDef assets fill:#F5F5F5,stroke:#9E9E9E,color:#424242
```
