# andrew-tsegaye/stunning_3d_portfolio_website architecture

> Architecture diagram of the GitHub repository andrew-tsegaye/stunning_3d_portfolio_website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andrew-tsegaye/stunning_3d_portfolio_website
- Repository: https://github.com/andrew-tsegaye/stunning_3d_portfolio_website

## Overview

This is a React 3D portfolio site for presenting a professional profile, experience, skills, projects, testimonials, and a contact form. A visitor enters through the app shell, browses its portfolio sections and interactive 3D scenes, then can submit a message through the EmailJS integration. Portfolio content is centralized in constants, while shared section wrapping and motion helpers support presentation. The contact-to-email relationship and app composition are visible in excerpts; some section internals were not sampled, so the graph avoids guessing their detailed rendering dependencies.

Main entry points: [`src/App.jsx`](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/App.jsx) (App shell), [`src/constants/index.js`](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/constants/index.js) (Portfolio data), [`src/hoc/SectionWrapper.jsx`](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/hoc/SectionWrapper.jsx) (Section wrapper), [`src/components/Contact.jsx`](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Contact.jsx) (Contact form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Portfolio sections"]
  node_app["App shell<br/>[App.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_hero["Hero section<br/>[Hero.jsx]"]
  node_about["About section<br/>[About.jsx]"]
  node_experience["Experience section<br/>[Experience.jsx]"]
  node_tech["Skills section<br/>[Tech.jsx]"]
  node_works["Project showcase<br/>[Works.jsx]"]
  node_feedback["Testimonials<br/>[Feedbacks.jsx]"]
  node_contact["Contact form<br/>[Contact.jsx]"]
end

subgraph group_scenes["3D scenes"]
  node_computer["Computer scene<br/>[Computers.jsx]"]
  node_earth["Earth scene<br/>[Earth.jsx]"]
  node_ball["Technology scene<br/>[Ball.jsx]"]
  node_stars["Star scene<br/>[Stars.jsx]"]
  node_loader["Scene loader<br/>[Loader.jsx]"]
end

subgraph group_content["Portfolio content"]
  node_contentdata["Portfolio data<br/>[index.js]"]
  node_assets["Images and icons<br/>[index.js]"]
end

subgraph group_shared["Presentation support"]
  node_sectionwrapper["Section wrapper<br/>[SectionWrapper.jsx]"]
  node_motion["Motion variants<br/>[motion.js]"]
end

node_visitor(("Visitor"))
node_emailjs["EmailJS service"]

node_visitor -->|"browses"| node_app
node_app -->|"mounts"| node_navbar
node_app -->|"mounts"| node_hero
node_app -->|"mounts"| node_about
node_app -->|"mounts"| node_experience
node_app -->|"mounts"| node_tech
node_app -->|"mounts"| node_works
node_app -->|"mounts"| node_feedback
node_app -->|"mounts"| node_contact
node_app -->|"mounts"| node_stars
node_hero -->|"uses scene"| node_computer
node_contact -->|"renders scene"| node_earth
node_tech -->|"uses scene"| node_ball
node_computer -->|"shows fallback"| node_loader
node_earth -->|"shows fallback"| node_loader
node_ball -->|"shows fallback"| node_loader
node_about -->|"reads data"| node_contentdata
node_experience -->|"reads data"| node_contentdata
node_tech -->|"reads data"| node_contentdata
node_works -->|"reads data"| node_contentdata
node_feedback -->|"reads data"| node_contentdata
node_navbar -->|"reads links"| node_contentdata
node_contentdata -->|"imports assets"| node_assets
node_about -->|"wrapped by"| node_sectionwrapper
node_experience -->|"wrapped by"| node_sectionwrapper
node_works -->|"wrapped by"| node_sectionwrapper
node_contact -->|"wrapped by"| node_sectionwrapper
node_sectionwrapper -->|"uses variants"| node_motion
node_contact -->|"sends message"| node_emailjs

click node_app "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/App.jsx"
click node_navbar "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Navbar.jsx"
click node_hero "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Hero.jsx"
click node_about "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/About.jsx"
click node_experience "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Experience.jsx"
click node_tech "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Tech.jsx"
click node_works "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Works.jsx"
click node_feedback "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Feedbacks.jsx"
click node_contact "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Contact.jsx"
click node_computer "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Computers.jsx"
click node_earth "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Earth.jsx"
click node_ball "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Ball.jsx"
click node_stars "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Stars.jsx"
click node_loader "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Loader.jsx"
click node_contentdata "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/constants/index.js"
click node_assets "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/assets/index.js"
click node_sectionwrapper "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/hoc/SectionWrapper.jsx"
click node_motion "https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/utils/motion.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_app,node_navbar,node_hero,node_about,node_experience,node_tech,node_works,node_feedback,node_contact toneBlue
class node_computer,node_earth,node_ball,node_stars,node_loader toneAmber
class node_contentdata,node_assets toneMint
class node_sectionwrapper,node_motion toneRose
class node_visitor,node_emailjs toneIndigo
```

## Components

### Portfolio sections

- [App shell](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/App.jsx): `src/App.jsx`
- [Navigation](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Hero section](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Hero.jsx): `src/components/Hero.jsx`
- [About section](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/About.jsx): `src/components/About.jsx`
- [Experience section](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Experience.jsx): `src/components/Experience.jsx`
- [Skills section](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Tech.jsx): `src/components/Tech.jsx`
- [Project showcase](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Works.jsx): `src/components/Works.jsx`
- [Testimonials](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Feedbacks.jsx): `src/components/Feedbacks.jsx`
- [Contact form](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Contact.jsx): `src/components/Contact.jsx`

### 3D scenes

- [Computer scene](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Computers.jsx): `src/components/canvas/Computers.jsx`
- [Earth scene](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Earth.jsx): `src/components/canvas/Earth.jsx`
- [Technology scene](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Ball.jsx): `src/components/canvas/Ball.jsx`
- [Star scene](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/canvas/Stars.jsx): `src/components/canvas/Stars.jsx`
- [Scene loader](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/components/Loader.jsx): `src/components/Loader.jsx`

### Portfolio content

- [Portfolio data](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/constants/index.js): `src/constants/index.js`
- [Images and icons](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/assets/index.js): `src/assets/index.js`

### Presentation support

- [Section wrapper](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/hoc/SectionWrapper.jsx): `src/hoc/SectionWrapper.jsx`
- [Motion variants](https://github.com/andrew-tsegaye/stunning_3d_portfolio_website/blob/start-engine/src/utils/motion.js): `src/utils/motion.js`

### Other components

- **Visitor**
- **EmailJS service**

## Connections

- Visitor → App shell: browses
- App shell → Navigation: mounts (evidence: `src/App.jsx`)
- App shell → Hero section: mounts (evidence: `src/App.jsx`)
- App shell → About section: mounts (evidence: `src/App.jsx`)
- App shell → Experience section: mounts (evidence: `src/App.jsx`)
- App shell → Skills section: mounts (evidence: `src/App.jsx`)
- App shell → Project showcase: mounts (evidence: `src/App.jsx`)
- App shell → Testimonials: mounts (evidence: `src/App.jsx`)
- App shell → Contact form: mounts (evidence: `src/App.jsx`)
- App shell → Star scene: mounts (evidence: `src/App.jsx`)
- Hero section → Computer scene: uses scene (evidence: `src/components/Hero.jsx`)
- Contact form → Earth scene: renders scene (evidence: `src/components/Contact.jsx`)
- Skills section → Technology scene: uses scene (evidence: `src/components/Tech.jsx`)
- Computer scene → Scene loader: shows fallback (evidence: `src/components/canvas/Computers.jsx`)
- Earth scene → Scene loader: shows fallback (evidence: `src/components/canvas/Earth.jsx`)
- Technology scene → Scene loader: shows fallback (evidence: `src/components/canvas/Ball.jsx`)
- About section → Portfolio data: reads data (evidence: `src/components/About.jsx`)
- Experience section → Portfolio data: reads data (evidence: `src/components/Experience.jsx`)
- Skills section → Portfolio data: reads data (evidence: `src/components/Tech.jsx`)
- Project showcase → Portfolio data: reads data (evidence: `src/components/Works.jsx`)
- Testimonials → Portfolio data: reads data (evidence: `src/components/Feedbacks.jsx`)
- Navigation → Portfolio data: reads links (evidence: `src/components/Navbar.jsx`)
- Portfolio data → Images and icons: imports assets (evidence: `src/constants/index.js`)
- About section → Section wrapper: wrapped by (evidence: `src/components/About.jsx`)
- Experience section → Section wrapper: wrapped by (evidence: `src/components/Experience.jsx`)
- Project showcase → Section wrapper: wrapped by (evidence: `src/components/Works.jsx`)
- Contact form → Section wrapper: wrapped by (evidence: `src/components/Contact.jsx`)
- Section wrapper → Motion variants: uses variants (evidence: `src/hoc/SectionWrapper.jsx`)
- Contact form → EmailJS service: sends message (evidence: `src/components/Contact.jsx`)
