# nishanth6153/portfolio architecture

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

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

## Overview

This repository implements an interactive personal portfolio website. A visitor enters through the loading screen, then explores a scroll-driven sequence of portfolio sections, project case studies, contact options, and immersive 3D scenes. The main app coordinates page entry and navigation; individual sections present distinct career and project stages using typed portfolio data. The graph reflects documented imports and rendered components. Some scene implementations and sections were not sampled, so their internal connections are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/nishanth6153/portfolio/blob/main/src/App.tsx) (Page coordinator), [`src/components/sections/WorkSection.tsx`](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/WorkSection.tsx) (Projects), [`src/components/layout/Navbar.tsx`](https://github.com/nishanth6153/portfolio/blob/main/src/components/layout/Navbar.tsx) (Navigation), [`src/components/sections/ContactSection.tsx`](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/ContactSection.tsx) (Contact)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Page experience"]
  node_app["Page coordinator<br/>[App.tsx]"]
  node_loader["Entry loader<br/>[SakuraLoader.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_hero["Introduction<br/>[HeroSection.tsx]"]
  node_about["About<br/>[AboutSection.tsx]"]
  node_work["Projects<br/>[WorkSection.tsx]"]
  node_experience["Experience"]
  node_skills["Skills<br/>[SkillsSection.tsx]"]
  node_achievements["Achievements"]
  node_certifications["Certifications"]
  node_ai["AI experience"]
  node_contact["Contact<br/>[ContactSection.tsx]"]
  node_projectdata["Project catalog<br/>[projects.ts]"]
  node_typedata["Portfolio types<br/>[portfolio.ts]"]
end

subgraph group_visual["Visual interaction"]
  node_world["Living 3D world<br/>[WorldScene.tsx]"]
  node_scenes["Project scenes<br/>[ProjectScene.tsx]"]
  node_modal["Project case study<br/>[ProjectModal.tsx]"]
  node_ambient["Ambient audio<br/>[ambientAudio.ts]"]
  node_typography["Scroll typography"]
  node_reveal["Scroll reveals<br/>[RevealOnScroll.tsx]"]
  node_glassbutton["Glass AI button<br/>[GlassAiButton.tsx]"]
end

subgraph group_support["Shared services"]
  node_clipboard["Clipboard helper<br/>[useClipboard.ts]"]
  node_scrollspy["Section tracking<br/>[useScrollSpy.ts]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"opens site"| node_app
node_app -->|"shows before entry"| node_loader
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_work
node_app -->|"renders"| node_experience
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_achievements
node_app -->|"renders"| node_certifications
node_app -->|"renders"| node_ai
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_world
node_navbar -->|"tracks sections"| node_scrollspy
node_navbar -->|"controls sound"| node_ambient
node_loader -->|"uses audio state"| node_ambient
node_work -->|"reads projects"| node_projectdata
node_work -->|"opens details"| node_modal
node_modal -->|"renders scene"| node_scenes
node_modal -.->|"displays case study"| node_projectdata
node_contact -->|"copies contact"| node_clipboard
node_contact -->|"uses reveal"| node_reveal
node_work -->|"uses animation"| node_typography
node_work -->|"renders button"| node_glassbutton
node_projectdata -->|"uses types"| node_typedata
node_scenes -->|"uses scene props"| node_typedata

click node_app "https://github.com/nishanth6153/portfolio/blob/main/src/App.tsx"
click node_loader "https://github.com/nishanth6153/portfolio/blob/main/src/components/SakuraLoader.tsx"
click node_navbar "https://github.com/nishanth6153/portfolio/blob/main/src/components/layout/Navbar.tsx"
click node_footer "https://github.com/nishanth6153/portfolio/blob/main/src/components/layout/Footer.tsx"
click node_hero "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/HeroSection.tsx"
click node_about "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/AboutSection.tsx"
click node_work "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/WorkSection.tsx"
click node_experience "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/ExperienceSection.tsx"
click node_skills "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/SkillsSection.tsx"
click node_achievements "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/AchievementsSection.tsx"
click node_certifications "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/CertificationsSection.tsx"
click node_ai "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/AiExperienceSection.tsx"
click node_contact "https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/ContactSection.tsx"
click node_projectdata "https://github.com/nishanth6153/portfolio/blob/main/src/data/projects.ts"
click node_typedata "https://github.com/nishanth6153/portfolio/blob/main/src/types/portfolio.ts"
click node_world "https://github.com/nishanth6153/portfolio/blob/main/src/components/3d/WorldScene.tsx"
click node_scenes "https://github.com/nishanth6153/portfolio/blob/main/src/components/3d/ProjectScene.tsx"
click node_modal "https://github.com/nishanth6153/portfolio/blob/main/src/components/ui/ProjectModal.tsx"
click node_ambient "https://github.com/nishanth6153/portfolio/blob/main/src/audio/ambientAudio.ts"
click node_typography "https://github.com/nishanth6153/portfolio/blob/main/src/components/animations/ScrollTypography.tsx"
click node_reveal "https://github.com/nishanth6153/portfolio/blob/main/src/components/animations/RevealOnScroll.tsx"
click node_clipboard "https://github.com/nishanth6153/portfolio/blob/main/src/hooks/useClipboard.ts"
click node_scrollspy "https://github.com/nishanth6153/portfolio/blob/main/src/hooks/useScrollSpy.ts"
click node_glassbutton "https://github.com/nishanth6153/portfolio/blob/main/src/components/threeui/GlassAiButton.tsx"

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_loader,node_navbar,node_footer toneBlue
class node_hero,node_about,node_work,node_experience,node_skills,node_achievements,node_certifications,node_ai,node_contact,node_projectdata,node_typedata toneAmber
class node_world,node_scenes,node_modal,node_ambient,node_typography,node_reveal,node_glassbutton toneMint
class node_clipboard,node_scrollspy toneRose
class node_visitor toneIndigo
```

## Components

### Page experience

- [Page coordinator](https://github.com/nishanth6153/portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [Entry loader](https://github.com/nishanth6153/portfolio/blob/main/src/components/SakuraLoader.tsx): `src/components/SakuraLoader.tsx`
- [Navigation](https://github.com/nishanth6153/portfolio/blob/main/src/components/layout/Navbar.tsx): `src/components/layout/Navbar.tsx`
- [Footer](https://github.com/nishanth6153/portfolio/blob/main/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`

### Portfolio content

- [Introduction](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/HeroSection.tsx): `src/components/sections/HeroSection.tsx`
- [About](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/AboutSection.tsx): `src/components/sections/AboutSection.tsx`
- [Projects](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/WorkSection.tsx): `src/components/sections/WorkSection.tsx`
- [Experience](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/ExperienceSection.tsx): `src/components/sections/ExperienceSection.tsx`
- [Skills](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/SkillsSection.tsx): `src/components/sections/SkillsSection.tsx`
- [Achievements](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/AchievementsSection.tsx): `src/components/sections/AchievementsSection.tsx`
- [Certifications](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/CertificationsSection.tsx): `src/components/sections/CertificationsSection.tsx`
- [AI experience](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/AiExperienceSection.tsx): `src/components/sections/AiExperienceSection.tsx`
- [Contact](https://github.com/nishanth6153/portfolio/blob/main/src/components/sections/ContactSection.tsx): `src/components/sections/ContactSection.tsx`
- [Project catalog](https://github.com/nishanth6153/portfolio/blob/main/src/data/projects.ts): `src/data/projects.ts`
- [Portfolio types](https://github.com/nishanth6153/portfolio/blob/main/src/types/portfolio.ts): `src/types/portfolio.ts`

### Visual interaction

- [Living 3D world](https://github.com/nishanth6153/portfolio/blob/main/src/components/3d/WorldScene.tsx): `src/components/3d/WorldScene.tsx`
- [Project scenes](https://github.com/nishanth6153/portfolio/blob/main/src/components/3d/ProjectScene.tsx): `src/components/3d/ProjectScene.tsx`
- [Project case study](https://github.com/nishanth6153/portfolio/blob/main/src/components/ui/ProjectModal.tsx): `src/components/ui/ProjectModal.tsx`
- [Ambient audio](https://github.com/nishanth6153/portfolio/blob/main/src/audio/ambientAudio.ts): `src/audio/ambientAudio.ts`
- [Scroll typography](https://github.com/nishanth6153/portfolio/blob/main/src/components/animations/ScrollTypography.tsx): `src/components/animations/ScrollTypography.tsx`
- [Scroll reveals](https://github.com/nishanth6153/portfolio/blob/main/src/components/animations/RevealOnScroll.tsx): `src/components/animations/RevealOnScroll.tsx`
- [Glass AI button](https://github.com/nishanth6153/portfolio/blob/main/src/components/threeui/GlassAiButton.tsx): `src/components/threeui/GlassAiButton.tsx`

### Shared services

- [Clipboard helper](https://github.com/nishanth6153/portfolio/blob/main/src/hooks/useClipboard.ts): `src/hooks/useClipboard.ts`
- [Section tracking](https://github.com/nishanth6153/portfolio/blob/main/src/hooks/useScrollSpy.ts): `src/hooks/useScrollSpy.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Page coordinator: opens site
- Page coordinator → Entry loader: shows before entry (evidence: `src/App.tsx`)
- Page coordinator → Navigation: renders (evidence: `src/App.tsx`)
- Page coordinator → Footer: renders (evidence: `src/App.tsx`)
- Page coordinator → Introduction: renders (evidence: `src/App.tsx`)
- Page coordinator → About: renders (evidence: `src/App.tsx`)
- Page coordinator → Projects: renders (evidence: `src/App.tsx`)
- Page coordinator → Experience: renders (evidence: `src/App.tsx`)
- Page coordinator → Skills: renders (evidence: `src/App.tsx`)
- Page coordinator → Achievements: renders (evidence: `src/App.tsx`)
- Page coordinator → Certifications: renders (evidence: `src/App.tsx`)
- Page coordinator → AI experience: renders (evidence: `src/App.tsx`)
- Page coordinator → Contact: renders (evidence: `src/App.tsx`)
- Page coordinator → Living 3D world: renders (evidence: `src/App.tsx`)
- Navigation → Section tracking: tracks sections (evidence: `src/components/layout/Navbar.tsx`)
- Navigation → Ambient audio: controls sound (evidence: `src/components/layout/Navbar.tsx`)
- Entry loader → Ambient audio: uses audio state (evidence: `src/components/SakuraLoader.tsx`)
- Projects → Project catalog: reads projects (evidence: `src/components/sections/WorkSection.tsx`)
- Projects → Project case study: opens details (evidence: `src/components/sections/WorkSection.tsx`)
- Project case study → Project scenes: renders scene (evidence: `src/components/ui/ProjectModal.tsx`)
- Project case study → Project catalog: displays case study
- Contact → Clipboard helper: copies contact (evidence: `src/components/sections/ContactSection.tsx`)
- Contact → Scroll reveals: uses reveal (evidence: `src/components/sections/ContactSection.tsx`)
- Projects → Scroll typography: uses animation (evidence: `src/components/sections/WorkSection.tsx`)
- Projects → Glass AI button: renders button (evidence: `src/components/sections/WorkSection.tsx`)
- Project catalog → Portfolio types: uses types (evidence: `src/data/projects.ts`)
- Project scenes → Portfolio types: uses scene props (evidence: `src/components/ui/ProjectModal.tsx`)
