# mokraniamine/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a single-page, static portfolio website built with React and Vite, styled using Tailwind CSS, and deployed via GitHub Pages.
- Purpose: Showcase personal projects, skills, and contact information with smooth animations and responsive design.

##### File structure
- Top-level files:
- package.json / vite.config.js: project metadata and build configuration.
- index.html + public/: static entry point and assets (animations JSON, fonts, images, style.css).
- src/: React source code with a component-per-section breakdown (header, hero, main, contact, footer).
- dist/: production build output (static HTML, JS, CSS, assets).
- Components follow a clear numeric order (1-header … 5-footer), reflecting the page’s vertical sections.
- No backend or API—pure frontend, static.

##### README for additional insights
- Tech stack: React, Vite, Tailwind CSS; deployed to GitHub Pages.
- Key features: fast build & dev server (Vite), responsive design, animation JSONs for interactivity.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Build Pipeline
    subgraph "Build Pipeline"
        ProjectMetadata["package.json"]:::build
        Vite["Vite Build (vite.config.js)"]:::build
        IndexHTML["index.html"]:::build
        srcCode["src/"]:::build
        publicDir["public/"]:::build

        ProjectMetadata --> Vite
        IndexHTML --> Vite
        srcCode --> Vite
        publicDir --> Vite
        Vite --> dist["dist/"]:::build
    end

    %% Deployment
    dist --> GitHubPages["GitHub Pages/CDN"]:::hosting

    %% Client Interaction
    Browser["User Browser"]:::client
    Browser -->|"HTTPS request"| GitHubPages
    GitHubPages -->|"serves index.html, JS, CSS, assets"| Browser

    %% Client Runtime
    subgraph "Client Runtime"
        mainjsxNode["src/main.jsx"]:::client
        React["React Runtime"]:::client
        App["App.jsx"]:::components

        mainjsxNode --> React
        React --> App

        subgraph "React SPA Components"
            subgraph "Header Section"
                HeaderComp["Header.jsx"]:::components
                HeaderCSS["header.css"]:::components
            end
            subgraph "Hero Section"
                HeroComp["Hero.jsx"]:::components
                HeroCSS["hero.css"]:::components
            end
            subgraph "Main Content"
                MainComp["Main.jsx"]:::components
                MainCSS["main.css"]:::components
            end
            subgraph "Contact Section"
                ContactComp["Contact.jsx"]:::components
                ContactCSS["contact.css"]:::components
            end
            subgraph "Footer Section"
                FooterComp["Footer.jsx"]:::components
                FooterCSS["footer.css"]:::components
            end
        end

        App --> HeaderComp
        App --> HeroComp
        App --> MainComp
        App --> ContactComp
        App --> FooterComp

        %% Asset Loading
        HeaderComp --> StaticAssets["Static Assets"]:::assets
        HeroComp --> StaticAssets
        MainComp --> StaticAssets
        ContactComp --> StaticAssets
        FooterComp --> StaticAssets
    end

    %% Static Assets Details
    subgraph "Public Assets (public/)"
        AnimContact["AnimationContact.json"]:::assets
        AnimMain["AnimationMain.json"]:::assets
        Fonts["icomoon.eot"]:::assets
        Images["images/"]:::assets
        CSS["style.css"]:::assets
    end
    publicDir -.-> AnimContact
    publicDir -.-> AnimMain
    publicDir -.-> Fonts
    publicDir -.-> Images
    publicDir -.-> CSS

    %% Deployment from Build
    dist -.-> AnimContact
    dist -.-> AnimMain
    dist -.-> Fonts
    dist -.-> Images
    dist -.-> CSS

    %% Styles
    classDef build fill:#f9d,stroke:#333,stroke-width:1px
    classDef hosting fill:#9df,stroke:#333,stroke-width:1px
    classDef client fill:#df9,stroke:#333,stroke-width:1px
    classDef components fill:#fdc,stroke:#333,stroke-width:1px
    classDef assets fill:#cdf,stroke:#333,stroke-width:1px

    %% Click Events
    click ProjectMetadata "https://github.com/mokraniamine/portfolio/blob/main/package.json"
    click Vite "https://github.com/mokraniamine/portfolio/blob/main/vite.config.js"
    click IndexHTML "https://github.com/mokraniamine/portfolio/blob/main/index.html"
    click srcCode "https://github.com/mokraniamine/portfolio/tree/main/src/"
    click publicDir "https://github.com/mokraniamine/portfolio/tree/main/public/"
    click mainjsxNode "https://github.com/mokraniamine/portfolio/blob/main/src/main.jsx"
    click App "https://github.com/mokraniamine/portfolio/blob/main/src/App.jsx"
    click HeaderComp "https://github.com/mokraniamine/portfolio/blob/main/src/components/1-header/Header.jsx"
    click HeaderCSS "https://github.com/mokraniamine/portfolio/blob/main/src/components/1-header/header.css"
    click HeroComp "https://github.com/mokraniamine/portfolio/blob/main/src/components/2-hero/Hero.jsx"
    click HeroCSS "https://github.com/mokraniamine/portfolio/blob/main/src/components/2-hero/hero.css"
    click MainComp "https://github.com/mokraniamine/portfolio/blob/main/src/components/3-main/Main.jsx"
    click MainCSS "https://github.com/mokraniamine/portfolio/blob/main/src/components/3-main/main.css"
    click ContactComp "https://github.com/mokraniamine/portfolio/blob/main/src/components/4-contact/Contact.jsx"
    click ContactCSS "https://github.com/mokraniamine/portfolio/blob/main/src/components/4-contact/contact.css"
    click FooterComp "https://github.com/mokraniamine/portfolio/blob/main/src/components/5-footer/Footer.jsx"
    click FooterCSS "https://github.com/mokraniamine/portfolio/blob/main/src/components/5-footer/footer.css"
    click AnimContact "https://github.com/mokraniamine/portfolio/blob/main/public/animation/AnimationContact.json"
    click AnimMain "https://github.com/mokraniamine/portfolio/blob/main/public/animation/AnimationMain.json"
    click Fonts "https://github.com/mokraniamine/portfolio/blob/main/public/fonts/icomoon.eot"
    click Images "https://github.com/mokraniamine/portfolio/tree/main/public/images/"
    click CSS "https://github.com/mokraniamine/portfolio/blob/main/public/style.css"
    click dist "https://github.com/mokraniamine/portfolio/tree/main/dist/"
    click GitHubPages "https://github.com/mokraniamine/portfolio/tree/main/dist/"
    click StaticAssets "https://github.com/mokraniamine/portfolio/tree/main/public/"
```
