# achrafelmakaoui/achrafdev_portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/achrafelmakaoui/achrafdev_portfolio
- Repository: https://github.com/achrafelmakaoui/achrafdev_portfolio

## Overview

##### Project type and purpose
- This is a single-page React front-end application (bootstrapped with Create React App) serving as a personal/portfolio website.
- Key features: landing page, about section (with globe and ripple animations), career history (education & experience), skills showcase, project gallery (driven by projects.json), contact form, theming via React Context, scroll-to-top behavior, responsive navbar, static assets and images.

##### File structure
- Top-level:
- public/ – static host files (index.html, manifest.json, robots.txt, sitemap.xml)
- src/ – application source
- package.json / lock – dependency definitions
- src/:
- index.js & index.css – entry point mounting App into DOM
- App.js – root component wrapping Routes, ThemeContext Provider, ScrollToTop, Navbar, Footer
- ScrollToTop.js – custom hook to reset scroll on route change
- ThemeContext.jsx – React Context for light/dark mode
- components/ – feature-based subfolders (About, Career, Contact, Footer, Intro, LandingPage, Navbar, ProjectPage, SkillsPage)
- assets: components/images and projects.json under ProjectPage

##### README for additional insights
- Standard Create React App instructions only; no backend or external service integrations.

##### Detail without overthinking
- Break the React App into as many logical components and layers as you see in the folder structure (App/container, context, hooks, each feature)
- Build vs. runtime separation
- How static JSON and images feed into components

## Diagram (Mermaid)

```mermaid
graph TB
    Browser["User Browser"]:::client
    CDN["CDN / Static Host"]:::cdn
    Browser -->|"GET index.html + JS"| CDN
    CDN -->|"Serves assets"| Browser

    subgraph "Build Process"
      direction TB
      NPM["npm run build"]:::build
      Webpack["Webpack / Babel"]:::build
      NPM --> Webpack
      Webpack --> Bundle["React App Bundle"]:::bundle
    end

    Browser -->|"Loads bundle"| Bundle

    subgraph "React App Runtime"
      direction TB
      RxIndex["index.js"]:::runtime
      RxCSS["index.css"]:::runtime
      App["App.js"]:::runtime
      Router["React Router"]:::runtime
      Theme["ThemeContext Provider"]:::runtime
      Scroll["ScrollToTop Hook"]:::util
      Navbar["Navbar"]:::component
      Footer["Footer"]:::component

      RxIndex --> App
      RxCSS --> App
      App --> Router
      App --> Theme
      App --> Scroll
      App --> Navbar
      App --> Footer

      subgraph "Pages"
        direction TB
        LP["LandingPage"]:::component
        Intro["Intro"]:::component
        About["About"]:::component
        Globe["Globe Animation"]:::component
        Ripple["Ripple Animation"]:::component
        Career["Career"]:::component
        Edu["Education"]:::component
        Exp["Experience"]:::component
        Skills["SkillsPage"]:::component
        FImg["FrontImages"]:::asset
        BImg["BackImages"]:::asset
        DImg["DataImages"]:::asset
        OImg["OtherImages"]:::asset
        Project["ProjectPage"]:::component
        PInfo["ProjectInfo"]:::component
        JSON["projects.json"]:::data
        Contact["Contact Form"]:::component

        Router --> LP
        LP --> Intro
        Router --> About
        About --> Globe
        About --> Ripple
        Router --> Career
        Career --> Edu
        Career --> Exp
        Router --> Skills
        Skills --> FImg
        Skills --> BImg
        Skills --> DImg
        Skills --> OImg
        Router --> Project
        Project --> PInfo
        Project --> JSON
        Router --> Contact
      end
    end

    click RxIndex "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/index.js"
    click RxCSS "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/index.css"
    click App "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/App.js"
    click Scroll "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/ScrollToTop.js"
    click Theme "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/ThemeContext.jsx"
    click CDN "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/public/index.html"
    click Navbar "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Navbar/Navbar.jsx"
    click Footer "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Footer/Footer.jsx"
    click LP "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/LandingPage/LandPage.jsx"
    click Intro "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Intro/Intro.jsx"
    click About "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/About/About.jsx"
    click Globe "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/About/Glob/Globe.jsx"
    click Ripple "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/About/Ripple/Ripple.jsx"
    click Career "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Career/Career.jsx"
    click Edu "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Career/Education/Education.jsx"
    click Exp "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Career/Experience/Experience.jsx"
    click Skills "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/SkillsPage/SkillsPage.jsx"
    click FImg "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/SkillsPage/FrontImages.jsx"
    click BImg "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/SkillsPage/BackImages.jsx"
    click DImg "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/SkillsPage/DataImages.jsx"
    click OImg "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/SkillsPage/OtherImages.jsx"
    click Project "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/ProjectPage/ProjectPage.jsx"
    click PInfo "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/ProjectPage/Project_Info/ProjectInfo.jsx"
    click JSON "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/ProjectPage/projects.json"
    click Contact "https://github.com/achrafelmakaoui/achrafdev_portfolio/blob/main/src/components/Contact/Contact.jsx"

    classDef client fill:#f9f,stroke:#333,stroke-width:1px
    classDef cdn fill:#ff9,stroke:#333,stroke-width:1px
    classDef build fill:#eef,stroke:#555,stroke-dasharray: 5 5
    classDef bundle fill:#9f9,stroke:#333,stroke-width:1px
    classDef runtime fill:#9ff,stroke:#333,stroke-width:1px
    classDef util fill:#ccf,stroke:#333,stroke-width:1px
    classDef component fill:#ccc,stroke:#333,stroke-width:1px
    classDef asset fill:#cfc,stroke:#333,stroke-width:1px
    classDef data fill:#fcf,stroke:#333,stroke-width:1px
```
