# ihjayy/personal-portfolio architecture

> Architecture diagram of the GitHub repository ihjayy/personal-portfolio, 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/ihjayy/personal-portfolio
- Repository: https://github.com/ihjayy/personal-portfolio

## Overview

This is a React portfolio site: visitors browse a home page, project and certificate listings, and contact details/form. The app shell routes between pages and provides shared navigation, footer, and scroll progress. Home content combines biography and skills with a hero and animated wave background; project data drives category filtering and the grid. The contact form’s shown submit handler only updates local state—no message delivery service is evidenced. Several page and data relationships come from SOURCE INDEX references; unsampled implementations are not inferred beyond those references.

Main entry points: [`src/App.tsx`](https://github.com/ihjayy/personal-portfolio/blob/master/src/App.tsx) (App router), [`src/pages/ProjectsPage.tsx`](https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/ProjectsPage.tsx) (Projects page), [`src/components/sections/HeroSection.tsx`](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/HeroSection.tsx) (Hero section), [`src/components/sections/AboutSection.tsx`](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/AboutSection.tsx) (About and skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Routing and shell"]
  node_app["App router<br/>[App.tsx]"]
  node_nav["Navigation<br/>[Nav.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_pages["Portfolio pages"]
  node_home["Home page<br/>[HomePage.tsx]"]
  node_projects_page["Projects page<br/>[ProjectsPage.tsx]"]
  node_contact["Contact page<br/>[ContactPage.tsx]"]
end

subgraph group_content["Portfolio content"]
  node_hero["Hero section<br/>[HeroSection.tsx]"]
  node_about["About and skills<br/>[AboutSection.tsx]"]
  node_projects_grid["Projects grid<br/>[ProjectsGrid.tsx]"]
  node_project_data["Project records<br/>[projects.ts]"]
  node_cert_data["Certificate records<br/>[certificates.ts]"]
  node_skill_data["Skill records<br/>[skills.ts]"]
  node_nav_data["Navigation records<br/>[nav.ts]"]
end

subgraph group_ui["UI components and hooks"]
  node_gradient["Gradient waves<br/>[GradientWaves.tsx]"]
  node_skill_bar["Skill bar<br/>[SkillBar.tsx]"]
  node_icons["Social icons<br/>[icons.tsx]"]
  node_scroll_progress["Scroll progress<br/>[ScrollProgress.tsx]"]
  node_scroll_hook["Scroll progress hook"]
  node_scrolled_hook["Scrolled state hook<br/>[useScrolled.ts]"]
  node_typed_hook["Typed text hook<br/>[useTypedText.ts]"]
end

node_visitor(("Site visitor"))

node_visitor -.->|"browses"| node_app
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_footer
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_projects_page
node_app -->|"routes to"| node_contact
node_nav -->|"reads"| node_nav_data
node_nav -->|"uses"| node_scrolled_hook
node_footer -->|"reads"| node_nav_data
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_about
node_hero -->|"renders"| node_gradient
node_hero -->|"uses"| node_typed_hook
node_hero -->|"uses"| node_icons
node_about -->|"reads"| node_skill_data
node_about -->|"renders"| node_skill_bar
node_about -->|"uses"| node_icons
node_projects_page -->|"filters"| node_project_data
node_projects_page -->|"reads"| node_cert_data
node_projects_page -->|"renders"| node_projects_grid
node_contact -->|"uses"| node_icons
node_app -->|"renders"| node_scroll_progress
node_scroll_progress -->|"uses"| node_scroll_hook

click node_app "https://github.com/ihjayy/personal-portfolio/blob/master/src/App.tsx"
click node_nav "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/layout/Nav.tsx"
click node_footer "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/layout/Footer.tsx"
click node_home "https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/HomePage.tsx"
click node_projects_page "https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/ProjectsPage.tsx"
click node_contact "https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/ContactPage.tsx"
click node_hero "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/HeroSection.tsx"
click node_about "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/AboutSection.tsx"
click node_projects_grid "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/ProjectsGrid.tsx"
click node_project_data "https://github.com/ihjayy/personal-portfolio/blob/master/src/data/projects.ts"
click node_cert_data "https://github.com/ihjayy/personal-portfolio/blob/master/src/data/certificates.ts"
click node_skill_data "https://github.com/ihjayy/personal-portfolio/blob/master/src/data/skills.ts"
click node_nav_data "https://github.com/ihjayy/personal-portfolio/blob/master/src/data/nav.ts"
click node_gradient "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/GradientWaves.tsx"
click node_skill_bar "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/SkillBar.tsx"
click node_icons "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/icons.tsx"
click node_scroll_progress "https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/ScrollProgress.tsx"
click node_scroll_hook "https://github.com/ihjayy/personal-portfolio/blob/master/src/hooks/useScrollProgress.ts"
click node_scrolled_hook "https://github.com/ihjayy/personal-portfolio/blob/master/src/hooks/useScrolled.ts"
click node_typed_hook "https://github.com/ihjayy/personal-portfolio/blob/master/src/hooks/useTypedText.ts"

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_nav,node_footer toneBlue
class node_home,node_projects_page,node_contact toneAmber
class node_hero,node_about,node_projects_grid,node_project_data,node_cert_data,node_skill_data,node_nav_data toneMint
class node_gradient,node_skill_bar,node_icons,node_scroll_progress,node_scroll_hook,node_scrolled_hook,node_typed_hook toneRose
class node_visitor toneIndigo
```

## Components

### Routing and shell

- [App router](https://github.com/ihjayy/personal-portfolio/blob/master/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/layout/Nav.tsx): `src/components/layout/Nav.tsx`
- [Footer](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`

### Portfolio pages

- [Home page](https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/HomePage.tsx): `src/pages/HomePage.tsx`
- [Projects page](https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/ProjectsPage.tsx): `src/pages/ProjectsPage.tsx`
- [Contact page](https://github.com/ihjayy/personal-portfolio/blob/master/src/pages/ContactPage.tsx): `src/pages/ContactPage.tsx`

### Portfolio content

- [Hero section](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/HeroSection.tsx): `src/components/sections/HeroSection.tsx`
- [About and skills](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/AboutSection.tsx): `src/components/sections/AboutSection.tsx`
- [Projects grid](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/sections/ProjectsGrid.tsx): `src/components/sections/ProjectsGrid.tsx`
- [Project records](https://github.com/ihjayy/personal-portfolio/blob/master/src/data/projects.ts): `src/data/projects.ts`
- [Certificate records](https://github.com/ihjayy/personal-portfolio/blob/master/src/data/certificates.ts): `src/data/certificates.ts`
- [Skill records](https://github.com/ihjayy/personal-portfolio/blob/master/src/data/skills.ts): `src/data/skills.ts`
- [Navigation records](https://github.com/ihjayy/personal-portfolio/blob/master/src/data/nav.ts): `src/data/nav.ts`

### UI components and hooks

- [Gradient waves](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/GradientWaves.tsx): `src/components/ui/GradientWaves.tsx`
- [Skill bar](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/SkillBar.tsx): `src/components/ui/SkillBar.tsx`
- [Social icons](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/icons.tsx): `src/components/ui/icons.tsx`
- [Scroll progress](https://github.com/ihjayy/personal-portfolio/blob/master/src/components/ui/ScrollProgress.tsx): `src/components/ui/ScrollProgress.tsx`
- [Scroll progress hook](https://github.com/ihjayy/personal-portfolio/blob/master/src/hooks/useScrollProgress.ts): `src/hooks/useScrollProgress.ts`
- [Scrolled state hook](https://github.com/ihjayy/personal-portfolio/blob/master/src/hooks/useScrolled.ts): `src/hooks/useScrolled.ts`
- [Typed text hook](https://github.com/ihjayy/personal-portfolio/blob/master/src/hooks/useTypedText.ts): `src/hooks/useTypedText.ts`

### Other components

- **Site visitor**

## Connections

- Site visitor → App router: browses
- App router → Navigation: renders (evidence: `src/App.tsx`)
- App router → Footer: renders (evidence: `src/App.tsx`)
- App router → Home page: routes to (evidence: `src/App.tsx`)
- App router → Projects page: routes to (evidence: `src/App.tsx`)
- App router → Contact page: routes to (evidence: `src/App.tsx`)
- Navigation → Navigation records: reads (evidence: `src/components/layout/Nav.tsx`)
- Navigation → Scrolled state hook: uses (evidence: `src/components/layout/Nav.tsx`)
- Footer → Navigation records: reads (evidence: `src/components/layout/Footer.tsx`)
- Home page → Hero section: renders (evidence: `src/pages/HomePage.tsx`)
- Home page → About and skills: renders (evidence: `src/pages/HomePage.tsx`)
- Hero section → Gradient waves: renders (evidence: `src/components/sections/HeroSection.tsx`)
- Hero section → Typed text hook: uses (evidence: `src/components/sections/HeroSection.tsx`)
- Hero section → Social icons: uses (evidence: `src/components/sections/HeroSection.tsx`)
- About and skills → Skill records: reads (evidence: `src/components/sections/AboutSection.tsx`)
- About and skills → Skill bar: renders (evidence: `src/components/sections/AboutSection.tsx`)
- About and skills → Social icons: uses (evidence: `src/components/sections/AboutSection.tsx`)
- Projects page → Project records: filters (evidence: `src/pages/ProjectsPage.tsx`)
- Projects page → Certificate records: reads (evidence: `src/pages/ProjectsPage.tsx`)
- Projects page → Projects grid: renders (evidence: `src/pages/ProjectsPage.tsx`)
- Contact page → Social icons: uses (evidence: `src/pages/ContactPage.tsx`)
- App router → Scroll progress: renders (evidence: `src/App.tsx`)
- Scroll progress → Scroll progress hook: uses (evidence: `src/components/ui/ScrollProgress.tsx`)
