# abraamehab2005/portfolio-main architecture

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

- Interactive diagram: https://gitdiagram.com/abraamehab2005/portfolio-main
- Repository: https://github.com/abraamehab2005/portfolio-main

## Overview

##### Project type and purpose
- This is a *static, data-driven personal portfolio website* built purely with HTML, CSS, and vanilla JavaScript.
- The goal is to showcase personal information, skills, experience, projects, and contact methods with modern UI patterns (glass morphism, animations, dark/light themes).

##### File structure
- Top-level HTML entry points:
- `index.html` – main portfolio page
- `project-details.html` – project-specific modal/page template
- Static style sheets:
- `style.css` – global styles, variables, layout, theming
- `project-detail.css` – project detail overlay styling
- JavaScript logic:
- `script.js` – core features (theme switch, dynamic JSON loading, modals, cursor/particles, terminal emulator)
- `project-detail.js` – project details page interactions
- Content/configuration:
- `data.json` – all textual & media references (personal info, skills, experience, education, projects)
- `assets/` – images (covers, profile pictures, screenshots), downloadable resume
- Documentation:
- `README.md` – project overview, architecture notes, setup guide
- `data.md` – (likely supplementary content)

##### README for additional insights
- Confirms the site is *data-driven* (JSON) and *fully responsive*.
- Highlights key UI sections: Navigation, Hero, About, Skills, Experience, Education, Projects, Contact, Easter-egg Terminal.
- Describes CSS architecture (variables, Grid, Flexbox, backdrop filters) and JavaScript modules (theme management, dynamic content loading, particle engine, terminal emulator).

##### Detail without over-splitting
- Major UI section as a component.
- Related resources (all CSS in one area, all JS in another).
- How dynamic JSON content flows into UI.
- Don’t omit the Easter-egg terminal and canvas-based particle engine—they’re core to the UX.

## Diagram (Mermaid)

```mermaid
flowchart TD
    HOST["Static Hosting"]:::cloud
    BROWSER["Browser: UI Renderer"]:::browser

    subgraph "Static Resources"
        direction TB
        HTML1["index.html"]:::html
        HTML2["project-details.html"]:::html
        CSS1["style.css"]:::css
        CSS2["project-detail.css"]:::css
        JS1["script.js"]:::js
        JS2["project-detail.js"]:::js
        DB["data.json"]:::db
        ASSETS["assets/"]:::storage
        RESUME["Resume PDF"]:::file
        DOC1["README.md"]:::doc
        DOC2["data.md"]:::doc
    end

    subgraph "Browser Modules"
        direction TB
        subgraph "UI Sections"
            direction TB
            NAV["Navigation"]:::ui
            HERO["Hero"]:::ui
            ABOUT["About"]:::ui
            SKILLS["Skills"]:::ui
            EXP["Experience"]:::ui
            EDU["Education"]:::ui
            PROJ["Projects"]:::ui
            CONTACT["Contact"]:::ui
            TERMUI["Easter-egg Terminal"]:::ui
        end
        subgraph "JS Modules"
            direction TB
            THEME["Theme Switch"]:::js
            LOADER["Dynamic Content Loader"]:::js
            PARTICLE["Particle Engine"]:::js
            TERM["Terminal Emulator"]:::js
            MODAL["Project Modal Handler"]:::js
        end
    end

    LIB1["AOS Library"]:::lib
    LIB2["Tabler Icons"]:::lib

    HOST -->|Serves| HTML1
    HOST -->|Serves| HTML2
    HOST -->|Serves| CSS1
    HOST -->|Serves| CSS2
    HOST -->|Serves| JS1
    HOST -->|Serves| JS2
    HOST -->|Serves| DB
    HOST -->|Serves| ASSETS
    HOST -->|Serves| RESUME
    HOST -->|Serves| DOC1
    HOST -->|Serves| DOC2

    HTML1 -->|Renders UI & Loads Assets| BROWSER
    HTML2 -->|Renders Project Details| BROWSER

    BROWSER -->|Fetches| DB
    BROWSER -->|Loads| LIB1
    BROWSER -->|Loads| LIB2

    BROWSER --> THEME
    BROWSER --> LOADER
    BROWSER --> PARTICLE
    BROWSER --> TERM
    BROWSER --> MODAL

    LOADER -->|Populates| NAV
    LOADER -->|Populates| HERO
    LOADER -->|Populates| ABOUT
    LOADER -->|Populates| SKILLS
    LOADER -->|Populates| EXP
    LOADER -->|Populates| EDU
    LOADER -->|Populates| PROJ

    THEME -->|Updates CSS Variables| ABOUT
    PARTICLE -->|Renders Canvas Animations| TERMUI
    TERM -->|Activates Console Emulator| TERMUI
    MODAL -->|Controls Project Overlay| PROJ

    click HTML1 "https://github.com/abraamehab2005/portfolio-main/blob/main/index.html"
    click HTML2 "https://github.com/abraamehab2005/portfolio-main/blob/main/project-details.html"
    click CSS1 "https://github.com/abraamehab2005/portfolio-main/blob/main/style.css"
    click CSS2 "https://github.com/abraamehab2005/portfolio-main/blob/main/project-detail.css"
    click JS1 "https://github.com/abraamehab2005/portfolio-main/blob/main/script.js"
    click JS2 "https://github.com/abraamehab2005/portfolio-main/blob/main/project-detail.js"
    click DB "https://github.com/abraamehab2005/portfolio-main/blob/main/data.json"
    click ASSETS "https://github.com/abraamehab2005/portfolio-main/tree/main/assets/"
    click RESUME "https://github.com/abraamehab2005/portfolio-main/blob/main/assets/downloads/Ebraam-Ehab-Naeem-FlowCV-Resume-20250913.pdf"
    click DOC1 "https://github.com/abraamehab2005/portfolio-main/blob/main/README.md"
    click DOC2 "https://github.com/abraamehab2005/portfolio-main/blob/main/data.md"

    classDef cloud fill:#E0F7FA,stroke:#006064,color:#006064
    classDef browser fill:#FFF3E0,stroke:#E65100,color:#E65100
    classDef html fill:#E8F5E9,stroke:#2E7D32,color:#2E7D32
    classDef css fill:#E3F2FD,stroke:#1565C0,color:#1565C0
    classDef js fill:#FFFDE7,stroke:#F9A825,color:#F9A825
    classDef db fill:#F3E5F5,stroke:#6A1B9A,color:#6A1B9A
    classDef storage fill:#EFEBE9,stroke:#5D4037,color:#5D4037
    classDef file fill:#FBE9E7,stroke:#BF360C,color:#BF360C
    classDef doc fill:#ECEFF1,stroke:#37474F,color:#37474F
    classDef ui fill:#FFF8E1,stroke:#F57F17,color:#F57F17
    classDef lib fill:#E1F5FE,stroke:#0288D1,color:#0288D1
```
