# heshamabdelazim/hesham-portfolio architecture

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

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

## Overview

This is a React portfolio site: visitors browse the developer’s profile, work, skills, education, and contact form. The app entry point mounts the page, whose main component assembles those sections and shared presentation elements. Section components render their own content from local data; the contact form submits through Formspree. The graph reflects imports and calls visible in the excerpts or SOURCE INDEX; unsampled components are represented only where their connections are documented there.

Main entry points: [`src/App.1.jsx`](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/App.1.jsx) (Page Assembly), [`src/components/5-main/Projects.jsx`](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/Projects.jsx) (Project Gallery), [`src/components/6-contact/Contact.jsx`](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Contact.jsx) (Contact Form), [`src/components/1-header/Header.jsx`](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/Header.jsx) (Header Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_page["Portfolio Page"]
  node_entry["React Entry<br/>[main.jsx]"]
  node_app["Page Assembly<br/>[App.1.jsx]"]
end

subgraph group_profile["Profile Sections"]
  node_header["Header Navigation<br/>[Header.jsx]"]
  node_nav["Section Navigation<br/>[Nav.tsx]"]
  node_cv["CV Download<br/>[DownloadCV.jsx]"]
  node_hero["Hero Profile<br/>[hero.jsx]"]
  node_hero_data["Social Links Data<br/>[data.ts]"]
  node_hero_icons["Social Icons<br/>[MyIcons.jsx]"]
  node_about["About Profile<br/>[About.tsx]"]
  node_academic["Academic History<br/>[Academic.tsx]"]
  node_academic_data["Academic Data<br/>[data.ts]"]
  node_academic_tab["Academic Tabs<br/>[AcademicTab.tsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_work["Work and Skills"]
  node_projects["Project Gallery<br/>[Projects.jsx]"]
  node_project_card["Project Card<br/>[Project.jsx]"]
  node_project_data["Project Data<br/>[data.ts]"]
  node_project_links["Project Links<br/>[PutLinks.tsx]"]
  node_skills["Skills Display<br/>[Skills.tsx]"]
  node_skill_data["Skills Data<br/>[data.ts]"]
  node_skill_box["Skill Box<br/>[Box.tsx]"]
  node_contact["Contact Form<br/>[Contact.jsx]"]
  node_contact_input["Form Inputs<br/>[Input.jsx]"]
  node_contact_message["Submission Message<br/>[Message.tsx]"]
end

subgraph group_shared["Shared Presentation"]
  node_section["Section Wrapper<br/>[HSeciton.tsx]"]
  node_theme["Theme State<br/>[light-dark.ts]"]
  node_particles_bg["Particle Background<br/>[BG_particles.jsx]"]
  node_particles["Particle Renderer<br/>[Particles.jsx]"]
  node_loading_page["Loading Page<br/>[LoadingPage.jsx]"]
  node_loading["Loading Indicator<br/>[Loading.jsx]"]
  node_tap["Gallery Interaction<br/>[Tap.jsx]"]
end

node_visitor(("Portfolio Visitor"))
node_formspree["Formspree"]

node_visitor -.->|"opens"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_header
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_academic
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_footer
node_app -->|"wraps sections"| node_section
node_app -->|"sets theme"| node_theme
node_app -->|"renders"| node_particles_bg
node_app -->|"renders"| node_loading_page
node_header -->|"renders"| node_nav
node_header -->|"renders"| node_cv
node_hero -->|"uses links"| node_hero_data
node_hero -->|"renders"| node_hero_icons
node_academic -->|"uses data"| node_academic_data
node_academic -->|"renders"| node_academic_tab
node_projects -->|"uses data"| node_project_data
node_projects -->|"renders"| node_project_card
node_projects -->|"uses interaction"| node_tap
node_project_card -->|"renders"| node_project_links
node_project_card -->|"renders"| node_loading
node_skills -->|"uses data"| node_skill_data
node_skills -->|"renders"| node_skill_box
node_contact -->|"renders"| node_contact_input
node_contact -->|"renders"| node_contact_message
node_contact -->|"submits form"| node_formspree
node_contact_message -->|"uses indicator"| node_loading
node_particles_bg -->|"renders"| node_particles
node_loading_page -->|"renders"| node_loading

click node_entry "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/main.jsx"
click node_app "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/App.1.jsx"
click node_header "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/Header.jsx"
click node_nav "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/Nav.tsx"
click node_cv "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/DownloadCV.jsx"
click node_hero "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/2-hero/hero.jsx"
click node_hero_data "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/2-hero/data.ts"
click node_hero_icons "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/2-hero/MyIcons.jsx"
click node_about "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/3-about/About.tsx"
click node_academic "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/4-Academic/Academic.tsx"
click node_academic_data "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/4-Academic/data.ts"
click node_academic_tab "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/4-Academic/AcademicTab.tsx"
click node_projects "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/Projects.jsx"
click node_project_card "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/Project.jsx"
click node_project_data "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/data.ts"
click node_project_links "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/PutLinks.tsx"
click node_skills "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/8-skills/Skills.tsx"
click node_skill_data "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/8-skills/data.ts"
click node_skill_box "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/8-skills/Box.tsx"
click node_contact "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Contact.jsx"
click node_contact_input "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Input.jsx"
click node_contact_message "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Message.tsx"
click node_footer "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/7-footer/Footer.jsx"
click node_section "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/HSeciton.tsx"
click node_theme "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/utilis/light-dark.ts"
click node_particles_bg "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/98-particles/BG_particles.jsx"
click node_particles "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/98-particles/Particles.jsx"
click node_loading_page "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/99-Loading/LoadingPage.jsx"
click node_loading "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/99-Loading/Loading.jsx"
click node_tap "https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/Tap.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_app toneBlue
class node_header,node_nav,node_cv,node_hero,node_hero_data,node_hero_icons,node_about,node_academic,node_academic_data,node_academic_tab,node_footer toneAmber
class node_projects,node_project_card,node_project_data,node_project_links,node_skills,node_skill_data,node_skill_box,node_contact,node_contact_input,node_contact_message toneMint
class node_section,node_theme,node_particles_bg,node_particles,node_loading_page,node_loading,node_tap toneRose
class node_visitor,node_formspree toneIndigo
```

## Components

### Portfolio Page

- [React Entry](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/main.jsx): `src/main.jsx`
- [Page Assembly](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/App.1.jsx): `src/App.1.jsx`

### Profile Sections

- [Header Navigation](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/Header.jsx): `src/components/1-header/Header.jsx`
- [Section Navigation](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/Nav.tsx): `src/components/1-header/Nav.tsx`
- [CV Download](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/1-header/DownloadCV.jsx): `src/components/1-header/DownloadCV.jsx`
- [Hero Profile](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/2-hero/hero.jsx): `src/components/2-hero/hero.jsx`
- [Social Links Data](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/2-hero/data.ts): `src/components/2-hero/data.ts`
- [Social Icons](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/2-hero/MyIcons.jsx): `src/components/2-hero/MyIcons.jsx`
- [About Profile](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/3-about/About.tsx): `src/components/3-about/About.tsx`
- [Academic History](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/4-Academic/Academic.tsx): `src/components/4-Academic/Academic.tsx`
- [Academic Data](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/4-Academic/data.ts): `src/components/4-Academic/data.ts`
- [Academic Tabs](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/4-Academic/AcademicTab.tsx): `src/components/4-Academic/AcademicTab.tsx`
- [Footer](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/7-footer/Footer.jsx): `src/components/7-footer/Footer.jsx`

### Work and Skills

- [Project Gallery](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/Projects.jsx): `src/components/5-main/Projects.jsx`
- [Project Card](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/Project.jsx): `src/components/5-main/Project.jsx`
- [Project Data](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/data.ts): `src/components/5-main/data.ts`
- [Project Links](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/5-main/PutLinks.tsx): `src/components/5-main/PutLinks.tsx`
- [Skills Display](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/8-skills/Skills.tsx): `src/components/8-skills/Skills.tsx`
- [Skills Data](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/8-skills/data.ts): `src/components/8-skills/data.ts`
- [Skill Box](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/8-skills/Box.tsx): `src/components/8-skills/Box.tsx`
- [Contact Form](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Contact.jsx): `src/components/6-contact/Contact.jsx`
- [Form Inputs](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Input.jsx): `src/components/6-contact/Input.jsx`
- [Submission Message](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/6-contact/Message.tsx): `src/components/6-contact/Message.tsx`

### Shared Presentation

- [Section Wrapper](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/HSeciton.tsx): `src/components/HSeciton.tsx`
- [Theme State](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/utilis/light-dark.ts): `src/utilis/light-dark.ts`
- [Particle Background](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/98-particles/BG_particles.jsx): `src/components/98-particles/BG_particles.jsx`
- [Particle Renderer](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/98-particles/Particles.jsx): `src/components/98-particles/Particles.jsx`
- [Loading Page](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/99-Loading/LoadingPage.jsx): `src/components/99-Loading/LoadingPage.jsx`
- [Loading Indicator](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/99-Loading/Loading.jsx): `src/components/99-Loading/Loading.jsx`
- [Gallery Interaction](https://github.com/heshamabdelazim/hesham-portfolio/blob/main/src/components/Tap.jsx): `src/components/Tap.jsx`

### Other components

- **Portfolio Visitor**
- **Formspree**

## Connections

- Portfolio Visitor → React Entry: opens
- React Entry → Page Assembly: renders (evidence: `src/main.jsx`)
- Page Assembly → Header Navigation: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Hero Profile: renders (evidence: `src/App.1.jsx`)
- Page Assembly → About Profile: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Academic History: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Project Gallery: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Skills Display: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Contact Form: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Footer: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Section Wrapper: wraps sections (evidence: `src/App.1.jsx`)
- Page Assembly → Theme State: sets theme (evidence: `src/App.1.jsx`)
- Page Assembly → Particle Background: renders (evidence: `src/App.1.jsx`)
- Page Assembly → Loading Page: renders (evidence: `src/App.1.jsx`)
- Header Navigation → Section Navigation: renders (evidence: `src/components/1-header/Header.jsx`)
- Header Navigation → CV Download: renders (evidence: `src/components/1-header/Header.jsx`)
- Hero Profile → Social Links Data: uses links (evidence: `src/components/2-hero/hero.jsx`)
- Hero Profile → Social Icons: renders (evidence: `src/components/2-hero/hero.jsx`)
- Academic History → Academic Data: uses data (evidence: `src/components/4-Academic/Academic.tsx`)
- Academic History → Academic Tabs: renders (evidence: `src/components/4-Academic/Academic.tsx`)
- Project Gallery → Project Data: uses data (evidence: `src/components/5-main/Projects.jsx`)
- Project Gallery → Project Card: renders (evidence: `src/components/5-main/Projects.jsx`)
- Project Gallery → Gallery Interaction: uses interaction (evidence: `src/components/5-main/Projects.jsx`)
- Project Card → Project Links: renders (evidence: `src/components/5-main/Project.jsx`)
- Project Card → Loading Indicator: renders (evidence: `src/components/5-main/Project.jsx`)
- Skills Display → Skills Data: uses data (evidence: `src/components/8-skills/Skills.tsx`)
- Skills Display → Skill Box: renders (evidence: `src/components/8-skills/Skills.tsx`)
- Contact Form → Form Inputs: renders (evidence: `src/components/6-contact/Contact.jsx`)
- Contact Form → Submission Message: renders (evidence: `src/components/6-contact/Contact.jsx`)
- Contact Form → Formspree: submits form (evidence: `src/components/6-contact/Contact.jsx`)
- Submission Message → Loading Indicator: uses indicator (evidence: `src/components/6-contact/Message.tsx`)
- Particle Background → Particle Renderer: renders (evidence: `src/components/98-particles/BG_particles.jsx`)
- Loading Page → Loading Indicator: renders (evidence: `src/components/99-Loading/LoadingPage.jsx`)
