# amineladrem/portfolio architecture

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

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

## Overview

##### Project type and purpose
- From the file tree and README, this is a single‐page portfolio website built with React (using TypeScript) and Vite. There is no separate backend or API—it’s a static front‐end application that displays personal or project information via different React components.

##### File structure
- Top‐level files:
- package.json / package-lock.json → npm dependencies and scripts
- vite.config.ts → Vite build/dev configuration
- tsconfig*.json → TypeScript configurations
- index.html → application entry point template
- Directories:
- public/ → static assets (images, favicon, etc.) served as‐is
- src/ → source code
– main.tsx → bootstraps React into index.html
– App.tsx + App.css → root component and its styles
– components/ → seven page/section components (home, about, blog, projects, services, contact, sidebar)
– assets/ → images or other imported media
– css/ → additional style sheets (hero.css, sidebar.css)
- No backend folder—this is purely front-end.

##### README
- README simply names the project (“Portfolio”). No extra architecture notes, confirming that structure and naming in the repo are our best source for design.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Development & Build Phase
    Developer["Developer Environment"]:::dev
    ViteDev["Vite Dev Server & Bundler"]:::build
    BuildStatic["Static Host / CDN"]:::host

    Developer -->|"writes code"| ViteDev
    ViteDev -->|"npm run build"| BuildStatic

    %% Runtime Phase
    BuildStatic -->|"serves static files"| Browser["Browser Runtime"]:::runtime

    subgraph "React Application" 
        direction TB
        App["App (src/App.tsx)"]:::component
        Sidebar["Sidebar"]:::component
        Home["Home"]:::component
        About["About"]:::component
        Blog["Blog"]:::component
        Projects["Projects"]:::component
        Services["Services"]:::component
        Contact["Contact"]:::component
        Assets["Assets & Media"]:::assets
        Styles["Global Styles"]:::assets
    end

    Browser -->|"loads bundle and hydrates"| App
    App --> Sidebar
    Sidebar --> Home
    Sidebar --> About
    Sidebar --> Blog
    Sidebar --> Projects
    Sidebar --> Services
    Sidebar --> Contact
    App --> Assets
    App --> Styles

    %% Click Events
    click Developer "https://github.com/amineladrem/portfolio/blob/main/package.json"
    click ViteDev "https://github.com/amineladrem/portfolio/blob/main/vite.config.ts"
    click BuildStatic "https://github.com/amineladrem/portfolio/tree/main/public/"
    click App "https://github.com/amineladrem/portfolio/blob/main/src/App.tsx"
    click Sidebar "https://github.com/amineladrem/portfolio/blob/main/src/components/sidebar.tsx"
    click Home "https://github.com/amineladrem/portfolio/blob/main/src/components/home.tsx"
    click About "https://github.com/amineladrem/portfolio/blob/main/src/components/about.tsx"
    click Blog "https://github.com/amineladrem/portfolio/blob/main/src/components/blog.tsx"
    click Projects "https://github.com/amineladrem/portfolio/blob/main/src/components/projects.tsx"
    click Services "https://github.com/amineladrem/portfolio/blob/main/src/components/services.tsx"
    click Contact "https://github.com/amineladrem/portfolio/blob/main/src/components/contact.tsx"
    click Assets "https://github.com/amineladrem/portfolio/tree/main/src/assets/"
    click Styles "https://github.com/amineladrem/portfolio/tree/main/src/css/"

    %% Styles
    classDef dev fill:#f9f,stroke:#333,stroke-width:1px;
    classDef build fill:#ddd,stroke:#333,stroke-width:1px;
    classDef host fill:#b6e,stroke:#333,stroke-width:1px;
    classDef runtime fill:#bbf,stroke:#333,stroke-width:1px;
    classDef component fill:#cfc,stroke:#333,stroke-width:1px;
    classDef assets fill:#fcf,stroke:#333,stroke-width:1px;
```
