# hadehwahle/my-portfolio architecture

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

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

## Overview

This is a personal portfolio site with a small contact-message API. Visitors browse profile, work, services, and experience content, then may submit a contact form; the API validates it and sends an email to the owner plus an auto-reply. The frontend composition and contact path are shown in sampled source. Other section-to-content use is supported by the SOURCE INDEX; email delivery through Gmail SMTP is documented. No database or other backend product subsystem is indicated.

Main entry points: [`client/src/App.jsx`](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/App.jsx) (Page composition), [`client/src/data/content.js`](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/data/content.js) (Portfolio content data), [`client/src/components/Contact.jsx`](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Contact.jsx) (Contact form), [`server/routes/contact.js`](https://github.com/hadehwahle/my-portfolio/blob/main/server/routes/contact.js) (Contact route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio site"]
  node_entry["React entry<br/>[main.jsx]"]
  node_page["Page composition<br/>[App.jsx]"]
  node_header["Navigation and theme<br/>[Header.jsx]"]
  node_hero["Introduction<br/>[Hero.jsx]"]
  node_work["Selected work<br/>[Work.jsx]"]
  node_services["Services and toolkit<br/>[Services.jsx]"]
  node_about["About and experience<br/>[About.jsx]"]
  node_contact["Contact form<br/>[Contact.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_content["Portfolio content"]
  node_portfolio_data["Portfolio content data<br/>[content.js]"]
end

subgraph group_api["Contact API"]
  node_express_app["Express API<br/>[server.js]"]
  node_contact_route["Contact route<br/>[contact.js]"]
  node_validation["Input validation<br/>[validateContact.js]"]
end

subgraph group_mail["Email delivery"]
  node_email_controller["Email controller"]
end

node_visitor(("Visitor"))
node_gmail{{"Gmail SMTP"}}

node_visitor -->|"opens site"| node_entry
node_entry -->|"renders"| node_page
node_page -->|"renders"| node_header
node_page -->|"renders"| node_hero
node_page -->|"renders"| node_work
node_page -->|"renders"| node_services
node_page -->|"renders"| node_about
node_page -->|"renders"| node_contact
node_page -->|"renders"| node_footer
node_header -->|"reads profile"| node_portfolio_data
node_hero -->|"reads profile"| node_portfolio_data
node_work -->|"reads projects"| node_portfolio_data
node_services -->|"reads services"| node_portfolio_data
node_about -->|"reads experience"| node_portfolio_data
node_contact -->|"reads contact data"| node_portfolio_data
node_footer -->|"reads profile"| node_portfolio_data
node_visitor -->|"submits message"| node_contact
node_contact -->|"posts contact data"| node_express_app
node_express_app -->|"routes requests"| node_contact_route
node_contact_route -->|"validates input"| node_validation
node_contact_route -->|"dispatches handler"| node_email_controller
node_email_controller -->|"sends two emails"| node_gmail
node_email_controller -->|"returns status"| node_contact

click node_entry "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/main.jsx"
click node_page "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/App.jsx"
click node_header "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Header.jsx"
click node_hero "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Hero.jsx"
click node_work "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Work.jsx"
click node_services "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Services.jsx"
click node_about "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/About.jsx"
click node_contact "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Contact.jsx"
click node_footer "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Footer.jsx"
click node_portfolio_data "https://github.com/hadehwahle/my-portfolio/blob/main/client/src/data/content.js"
click node_express_app "https://github.com/hadehwahle/my-portfolio/blob/main/server/server.js"
click node_contact_route "https://github.com/hadehwahle/my-portfolio/blob/main/server/routes/contact.js"
click node_validation "https://github.com/hadehwahle/my-portfolio/blob/main/server/middleware/validateContact.js"
click node_email_controller "https://github.com/hadehwahle/my-portfolio/blob/main/server/controllers/contactController.js"

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_page,node_header,node_hero,node_work,node_services,node_about,node_contact,node_footer toneBlue
class node_portfolio_data toneAmber
class node_express_app,node_contact_route,node_validation toneMint
class node_email_controller toneRose
class node_visitor,node_gmail toneIndigo
```

## Components

### Portfolio site

- [React entry](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/main.jsx): `client/src/main.jsx`
- [Page composition](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Navigation and theme](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Header.jsx): `client/src/components/Header.jsx`
- [Introduction](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Hero.jsx): `client/src/components/Hero.jsx`
- [Selected work](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Work.jsx): `client/src/components/Work.jsx`
- [Services and toolkit](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Services.jsx): `client/src/components/Services.jsx`
- [About and experience](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/About.jsx): `client/src/components/About.jsx`
- [Contact form](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Contact.jsx): `client/src/components/Contact.jsx`
- [Footer](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/components/Footer.jsx): `client/src/components/Footer.jsx`

### Portfolio content

- [Portfolio content data](https://github.com/hadehwahle/my-portfolio/blob/main/client/src/data/content.js): `client/src/data/content.js`

### Contact API

- [Express API](https://github.com/hadehwahle/my-portfolio/blob/main/server/server.js): `server/server.js`
- [Contact route](https://github.com/hadehwahle/my-portfolio/blob/main/server/routes/contact.js): `server/routes/contact.js`
- [Input validation](https://github.com/hadehwahle/my-portfolio/blob/main/server/middleware/validateContact.js): `server/middleware/validateContact.js`

### Email delivery

- [Email controller](https://github.com/hadehwahle/my-portfolio/blob/main/server/controllers/contactController.js): `server/controllers/contactController.js`

### Other components

- **Visitor**
- **Gmail SMTP**

## Connections

- Visitor → React entry: opens site (evidence: `README.md`)
- React entry → Page composition: renders (evidence: `client/src/main.jsx`)
- Page composition → Navigation and theme: renders (evidence: `client/src/App.jsx`)
- Page composition → Introduction: renders (evidence: `client/src/App.jsx`)
- Page composition → Selected work: renders (evidence: `client/src/App.jsx`)
- Page composition → Services and toolkit: renders (evidence: `client/src/App.jsx`)
- Page composition → About and experience: renders (evidence: `client/src/App.jsx`)
- Page composition → Contact form: renders (evidence: `client/src/App.jsx`)
- Page composition → Footer: renders (evidence: `client/src/App.jsx`)
- Navigation and theme → Portfolio content data: reads profile (evidence: `client/src/components/Header.jsx`)
- Introduction → Portfolio content data: reads profile (evidence: `client/src/components/Hero.jsx`)
- Selected work → Portfolio content data: reads projects (evidence: `client/src/components/Work.jsx`)
- Services and toolkit → Portfolio content data: reads services (evidence: `client/src/components/Services.jsx`)
- About and experience → Portfolio content data: reads experience (evidence: `client/src/components/About.jsx`)
- Contact form → Portfolio content data: reads contact data (evidence: `client/src/components/Contact.jsx`)
- Footer → Portfolio content data: reads profile (evidence: `client/src/components/Footer.jsx`)
- Visitor → Contact form: submits message (evidence: `client/src/components/Contact.jsx`)
- Contact form → Express API: posts contact data (evidence: `client/src/components/Contact.jsx`)
- Express API → Contact route: routes requests (evidence: `server/server.js`)
- Contact route → Input validation: validates input (evidence: `server/routes/contact.js`)
- Contact route → Email controller: dispatches handler (evidence: `server/routes/contact.js`)
- Email controller → Gmail SMTP: sends two emails (evidence: `server/controllers/contactController.js`)
- Email controller → Contact form: returns status (evidence: `server/controllers/contactController.js`)
