# nja99/portfolio architecture

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

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

## Overview

This is a React personal portfolio site. A visitor enters through the assembled page: the hero and scroll-driven About and Projects scenes lead into experience, education, certifications, leadership, skills, testimonials, and contact content, populated from portfolio data. Shared layout and UI components support those domain sections, while separate services and hooks manage scrolling, themes, and motion preferences. The graph reflects the README’s described capabilities; unsampled implementations are represented only where the tree and documented wiring support them.

Main entry points: [`src/App.jsx`](https://github.com/nja99/portfolio/blob/main/src/App.jsx) (Page App), [`src/components/layout/ScrollScene.jsx`](https://github.com/nja99/portfolio/blob/main/src/components/layout/ScrollScene.jsx) (Scroll Scene Layout), [`src/services/ScrollService.js`](https://github.com/nja99/portfolio/blob/main/src/services/ScrollService.js) (Scroll Service), [`src/components/ui/GlobeCanvas.jsx`](https://github.com/nja99/portfolio/blob/main/src/components/ui/GlobeCanvas.jsx) (Dotted Globe)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_page["Page Assembly"]
  node_app["Page App<br/>[App.jsx]"]
end

subgraph group_scenes["Animated Scenes"]
  node_hero["Hero<br/>[HeroScene.jsx]"]
  node_about["About Statement<br/>[StatementScene.jsx]"]
  node_projects["Projects<br/>[ProjectsScene.jsx]"]
end

subgraph group_content["Portfolio Sections"]
  node_experience["Experience"]
  node_education["Education"]
  node_certifications["Certifications"]
  node_leadership["Leadership and Awards"]
  node_skills["Skills<br/>[SkillsSection.jsx]"]
  node_testimonials["Testimonials"]
  node_contact["Contact<br/>[ContactSection.jsx]"]
end

subgraph group_visuals["Layout and UI"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_background["Network Background<br/>[BackgroundFX.jsx]"]
  node_scrollscene["Scroll Scene Layout<br/>[ScrollScene.jsx]"]
  node_sectionlayout["Section Layout<br/>[Section.jsx]"]
  node_globe["Dotted Globe<br/>[GlobeCanvas.jsx]"]
  node_timeline["Timeline UI<br/>[Timeline.jsx]"]
  node_network["Network Canvas<br/>[NetworkCanvas.jsx]"]
end

subgraph group_runtime["Data and Runtime"]
  node_portfolio["Portfolio Content<br/>[portfolio.js]"]
  node_models["Domain Models<br/>[Models.js]"]
  node_scrollservice["Scroll Service<br/>[ScrollService.js]"]
  node_scrollhook["Scroll Frame Hook<br/>[useScrollFrame.js]"]
  node_motionhook["Reduced Motion Hook"]
  node_themeservice["Theme Service<br/>[ThemeService.js]"]
  node_themehook["Theme Hook<br/>[useTheme.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens site"| node_app
node_app -->|"reads content"| node_portfolio
node_portfolio -->|"creates records"| node_models
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_background
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_experience
node_app -->|"renders"| node_education
node_app -->|"renders"| node_certifications
node_app -->|"renders"| node_leadership
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_testimonials
node_app -->|"renders"| node_contact
node_app -->|"refreshes on fonts"| node_scrollservice
node_hero -->|"renders within"| node_scrollscene
node_hero -->|"renders"| node_globe
node_about -->|"uses"| node_scrollscene
node_projects -->|"uses"| node_scrollscene
node_experience -->|"uses"| node_sectionlayout
node_education -->|"uses"| node_sectionlayout
node_experience -->|"renders"| node_timeline
node_education -->|"renders"| node_timeline
node_background -->|"renders"| node_network
node_scrollscene -->|"subscribes via"| node_scrollhook
node_scrollscene -->|"checks preference"| node_motionhook
node_scrollhook -->|"subscribes to"| node_scrollservice
node_motionhook -->|"reads preference"| node_scrollservice
node_timeline -->|"updates through"| node_scrollhook
node_timeline -->|"checks preference"| node_motionhook
node_navbar -->|"theme toggle uses"| node_themehook
node_themehook -->|"subscribes to"| node_themeservice
node_network -->|"reads theme colors"| node_themehook
node_network -->|"reads scroll state"| node_scrollservice
node_globe -->|"reads theme colors"| node_themehook
node_globe -->|"subscribes to theme"| node_themeservice
node_globe -->|"reads scroll state"| node_scrollservice

click node_app "https://github.com/nja99/portfolio/blob/main/src/App.jsx"
click node_navbar "https://github.com/nja99/portfolio/blob/main/src/components/layout/Navbar.jsx"
click node_background "https://github.com/nja99/portfolio/blob/main/src/components/layout/BackgroundFX.jsx"
click node_hero "https://github.com/nja99/portfolio/blob/main/src/components/scenes/HeroScene.jsx"
click node_about "https://github.com/nja99/portfolio/blob/main/src/components/scenes/StatementScene.jsx"
click node_projects "https://github.com/nja99/portfolio/blob/main/src/components/scenes/ProjectsScene.jsx"
click node_experience "https://github.com/nja99/portfolio/blob/main/src/components/sections/ExperienceSection.jsx"
click node_education "https://github.com/nja99/portfolio/blob/main/src/components/sections/EducationSection.jsx"
click node_certifications "https://github.com/nja99/portfolio/blob/main/src/components/sections/CertificationsSection.jsx"
click node_leadership "https://github.com/nja99/portfolio/blob/main/src/components/sections/LeadershipSection.jsx"
click node_skills "https://github.com/nja99/portfolio/blob/main/src/components/sections/SkillsSection.jsx"
click node_testimonials "https://github.com/nja99/portfolio/blob/main/src/components/sections/TestimonialsSection.jsx"
click node_contact "https://github.com/nja99/portfolio/blob/main/src/components/sections/ContactSection.jsx"
click node_portfolio "https://github.com/nja99/portfolio/blob/main/src/data/portfolio.js"
click node_models "https://github.com/nja99/portfolio/blob/main/src/models/Models.js"
click node_scrollscene "https://github.com/nja99/portfolio/blob/main/src/components/layout/ScrollScene.jsx"
click node_sectionlayout "https://github.com/nja99/portfolio/blob/main/src/components/layout/Section.jsx"
click node_globe "https://github.com/nja99/portfolio/blob/main/src/components/ui/GlobeCanvas.jsx"
click node_timeline "https://github.com/nja99/portfolio/blob/main/src/components/ui/Timeline.jsx"
click node_scrollservice "https://github.com/nja99/portfolio/blob/main/src/services/ScrollService.js"
click node_scrollhook "https://github.com/nja99/portfolio/blob/main/src/hooks/useScrollFrame.js"
click node_motionhook "https://github.com/nja99/portfolio/blob/main/src/hooks/useReducedMotion.js"
click node_themeservice "https://github.com/nja99/portfolio/blob/main/src/services/ThemeService.js"
click node_themehook "https://github.com/nja99/portfolio/blob/main/src/hooks/useTheme.js"
click node_network "https://github.com/nja99/portfolio/blob/main/src/components/layout/NetworkCanvas.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_app toneBlue
class node_hero,node_about,node_projects toneAmber
class node_experience,node_education,node_certifications,node_leadership,node_skills,node_testimonials,node_contact toneMint
class node_navbar,node_background,node_scrollscene,node_sectionlayout,node_globe,node_timeline,node_network toneRose
class node_portfolio,node_models,node_scrollservice,node_scrollhook,node_motionhook,node_themeservice,node_themehook,node_visitor toneIndigo
```

## Components

### Page Assembly

- [Page App](https://github.com/nja99/portfolio/blob/main/src/App.jsx): `src/App.jsx`

### Animated Scenes

- [Hero](https://github.com/nja99/portfolio/blob/main/src/components/scenes/HeroScene.jsx): `src/components/scenes/HeroScene.jsx`
- [About Statement](https://github.com/nja99/portfolio/blob/main/src/components/scenes/StatementScene.jsx): `src/components/scenes/StatementScene.jsx`
- [Projects](https://github.com/nja99/portfolio/blob/main/src/components/scenes/ProjectsScene.jsx): `src/components/scenes/ProjectsScene.jsx`

### Portfolio Sections

- [Experience](https://github.com/nja99/portfolio/blob/main/src/components/sections/ExperienceSection.jsx): `src/components/sections/ExperienceSection.jsx`
- [Education](https://github.com/nja99/portfolio/blob/main/src/components/sections/EducationSection.jsx): `src/components/sections/EducationSection.jsx`
- [Certifications](https://github.com/nja99/portfolio/blob/main/src/components/sections/CertificationsSection.jsx): `src/components/sections/CertificationsSection.jsx`
- [Leadership and Awards](https://github.com/nja99/portfolio/blob/main/src/components/sections/LeadershipSection.jsx): `src/components/sections/LeadershipSection.jsx`
- [Skills](https://github.com/nja99/portfolio/blob/main/src/components/sections/SkillsSection.jsx): `src/components/sections/SkillsSection.jsx`
- [Testimonials](https://github.com/nja99/portfolio/blob/main/src/components/sections/TestimonialsSection.jsx): `src/components/sections/TestimonialsSection.jsx`
- [Contact](https://github.com/nja99/portfolio/blob/main/src/components/sections/ContactSection.jsx): `src/components/sections/ContactSection.jsx`

### Layout and UI

- [Navigation](https://github.com/nja99/portfolio/blob/main/src/components/layout/Navbar.jsx): `src/components/layout/Navbar.jsx`
- [Network Background](https://github.com/nja99/portfolio/blob/main/src/components/layout/BackgroundFX.jsx): `src/components/layout/BackgroundFX.jsx`
- [Scroll Scene Layout](https://github.com/nja99/portfolio/blob/main/src/components/layout/ScrollScene.jsx): `src/components/layout/ScrollScene.jsx`
- [Section Layout](https://github.com/nja99/portfolio/blob/main/src/components/layout/Section.jsx): `src/components/layout/Section.jsx`
- [Dotted Globe](https://github.com/nja99/portfolio/blob/main/src/components/ui/GlobeCanvas.jsx): `src/components/ui/GlobeCanvas.jsx`
- [Timeline UI](https://github.com/nja99/portfolio/blob/main/src/components/ui/Timeline.jsx): `src/components/ui/Timeline.jsx`
- [Network Canvas](https://github.com/nja99/portfolio/blob/main/src/components/layout/NetworkCanvas.jsx): `src/components/layout/NetworkCanvas.jsx`

### Data and Runtime

- [Portfolio Content](https://github.com/nja99/portfolio/blob/main/src/data/portfolio.js): `src/data/portfolio.js`
- [Domain Models](https://github.com/nja99/portfolio/blob/main/src/models/Models.js): `src/models/Models.js`
- [Scroll Service](https://github.com/nja99/portfolio/blob/main/src/services/ScrollService.js): `src/services/ScrollService.js`
- [Scroll Frame Hook](https://github.com/nja99/portfolio/blob/main/src/hooks/useScrollFrame.js): `src/hooks/useScrollFrame.js`
- [Reduced Motion Hook](https://github.com/nja99/portfolio/blob/main/src/hooks/useReducedMotion.js): `src/hooks/useReducedMotion.js`
- [Theme Service](https://github.com/nja99/portfolio/blob/main/src/services/ThemeService.js): `src/services/ThemeService.js`
- [Theme Hook](https://github.com/nja99/portfolio/blob/main/src/hooks/useTheme.js): `src/hooks/useTheme.js`

### Other components

- **Visitor**

## Connections

- Visitor → Page App: opens site (evidence: `README.md`)
- Page App → Portfolio Content: reads content (evidence: `src/App.jsx`)
- Portfolio Content → Domain Models: creates records (evidence: `src/data/portfolio.js`)
- Page App → Navigation: renders (evidence: `src/App.jsx`)
- Page App → Network Background: renders (evidence: `src/App.jsx`)
- Page App → Hero: renders (evidence: `src/App.jsx`)
- Page App → About Statement: renders (evidence: `src/App.jsx`)
- Page App → Projects: renders (evidence: `src/App.jsx`)
- Page App → Experience: renders (evidence: `src/App.jsx`)
- Page App → Education: renders (evidence: `src/App.jsx`)
- Page App → Certifications: renders (evidence: `src/App.jsx`)
- Page App → Leadership and Awards: renders (evidence: `src/App.jsx`)
- Page App → Skills: renders (evidence: `src/App.jsx`)
- Page App → Testimonials: renders (evidence: `src/App.jsx`)
- Page App → Contact: renders (evidence: `src/App.jsx`)
- Page App → Scroll Service: refreshes on fonts (evidence: `src/App.jsx`)
- Hero → Scroll Scene Layout: renders within (evidence: `src/components/scenes/HeroScene.jsx`)
- Hero → Dotted Globe: renders (evidence: `src/components/scenes/HeroScene.jsx`)
- About Statement → Scroll Scene Layout: uses (evidence: `src/components/scenes/StatementScene.jsx`)
- Projects → Scroll Scene Layout: uses (evidence: `src/components/scenes/ProjectsScene.jsx`)
- Experience → Section Layout: uses (evidence: `src/components/sections/ExperienceSection.jsx`)
- Education → Section Layout: uses (evidence: `src/components/sections/EducationSection.jsx`)
- Experience → Timeline UI: renders (evidence: `src/components/sections/ExperienceSection.jsx`)
- Education → Timeline UI: renders (evidence: `src/components/sections/EducationSection.jsx`)
- Network Background → Network Canvas: renders (evidence: `src/components/layout/BackgroundFX.jsx`)
- Scroll Scene Layout → Scroll Frame Hook: subscribes via (evidence: `src/components/layout/ScrollScene.jsx`)
- Scroll Scene Layout → Reduced Motion Hook: checks preference (evidence: `src/components/layout/ScrollScene.jsx`)
- Scroll Frame Hook → Scroll Service: subscribes to (evidence: `src/hooks/useScrollFrame.js`)
- Reduced Motion Hook → Scroll Service: reads preference (evidence: `src/hooks/useReducedMotion.js`)
- Timeline UI → Scroll Frame Hook: updates through (evidence: `src/components/ui/Timeline.jsx`)
- Timeline UI → Reduced Motion Hook: checks preference (evidence: `src/components/ui/Timeline.jsx`)
- Navigation → Theme Hook: theme toggle uses
- Theme Hook → Theme Service: subscribes to (evidence: `src/hooks/useTheme.js`)
- Network Canvas → Theme Hook: reads theme colors (evidence: `src/components/layout/NetworkCanvas.jsx`)
- Network Canvas → Scroll Service: reads scroll state (evidence: `src/components/layout/NetworkCanvas.jsx`)
- Dotted Globe → Theme Hook: reads theme colors (evidence: `src/components/ui/GlobeCanvas.jsx`)
- Dotted Globe → Theme Service: subscribes to theme (evidence: `src/components/ui/GlobeCanvas.jsx`)
- Dotted Globe → Scroll Service: reads scroll state (evidence: `src/components/ui/GlobeCanvas.jsx`)
