# k-nishant-18/nishant_portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/k-nishant-18/nishant_portfolio
- Repository: https://github.com/k-nishant-18/nishant_portfolio

## Overview

This is an interactive developer portfolio: visitors explore a cinematic home page, project index and project details, and can leave guestbook entries or send inquiries. The React app owns routing and shared presentation state; portfolio sections and project data provide the showcase, while the API handles backend requests and documented email/database integrations. The excerpts establish routing, selected component use, guestbook local storage, and API endpoints. Some frontend-to-API and server-to-service wiring is described only generally in the README, so those links are marked unverified.

Main entry points: [`src/pages/Home.tsx`](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/Home.tsx) (Home page), [`src/App.tsx`](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/App.tsx) (React app and routes), [`src/pages/GuestBook.tsx`](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/GuestBook.tsx) (Guestbook page), [`src/pages/ProjectDetail.tsx`](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/ProjectDetail.tsx) (Project details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["React app and routes<br/>[App.tsx]"]
  node_home["Home page<br/>[Home.tsx]"]
  node_theme["Theme state<br/>[ThemeContext.tsx]"]
  node_music["Music state<br/>[MusicContext.tsx]"]
  node_transitions["Transition state"]
end

subgraph group_showcase["Portfolio showcase"]
  node_hero["Hero experience<br/>[Hero.tsx]"]
  node_about["Bio and skills<br/>[About.tsx]"]
  node_skills["Skills section<br/>[Skills.tsx]"]
  node_projects_section["Featured projects<br/>[Projects.tsx]"]
  node_project_data["Project catalog<br/>[projects.ts]"]
  node_project_index["Project index page<br/>[Projects.tsx]"]
  node_project_detail["Project details<br/>[ProjectDetail.tsx]"]
  node_architecture["Architecture diagrams"]
  node_dev_activity["Developer activity<br/>[DevActivity.tsx]"]
  node_certs["Certifications<br/>[Certifications.tsx]"]
  node_blog["Blog section<br/>[BlogSection.tsx]"]
end

subgraph group_community["Visitor interaction"]
  node_contact["Contact section<br/>[Contact.tsx]"]
  node_guestbook_page["Guestbook page<br/>[GuestBook.tsx]"]
  node_floating_guestbook["Floating guestbook"]
  node_guestbook_local[("Visitor entry cache<br/>[guestbook.ts]")]
end

subgraph group_backend["API services"]
  node_api_entry["API function entry<br/>[&#91;...path&#93;.ts]"]
  node_api_server["Express API<br/>[server.ts]"]
  node_postgres[("Postgres database")]
  node_email["Email service"]
end

node_visitor(("Portfolio visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_project_index
node_app -->|"routes to"| node_project_detail
node_app -->|"routes to"| node_guestbook_page
node_app -->|"provides"| node_theme
node_app -->|"provides"| node_music
node_app -->|"provides"| node_transitions
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_about
node_home -->|"renders"| node_skills
node_home -->|"renders"| node_projects_section
node_home -->|"renders"| node_dev_activity
node_home -->|"renders"| node_certs
node_home -->|"renders"| node_blog
node_home -->|"renders"| node_contact
node_project_index -->|"reads"| node_project_data
node_project_detail -->|"reads"| node_project_data
node_project_detail -->|"renders"| node_architecture
node_guestbook_page -->|"loads and saves"| node_guestbook_local
node_visitor -->|"submits entries"| node_guestbook_page
node_guestbook_page -.->|"requests entries"| node_api_entry
node_floating_guestbook -->|"uses"| node_guestbook_local
node_contact -.->|"submits inquiry"| node_api_entry
node_api_entry -->|"forwards requests"| node_api_server
node_api_server -.->|"reads and writes"| node_postgres
node_api_server -.->|"sends notifications"| node_email

click node_app "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/App.tsx"
click node_home "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/Home.tsx"
click node_theme "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/context/ThemeContext.tsx"
click node_music "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/context/MusicContext.tsx"
click node_transitions "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/context/TransitionContext.jsx"
click node_hero "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Hero.tsx"
click node_about "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/About.tsx"
click node_skills "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Skills.tsx"
click node_projects_section "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Projects.tsx"
click node_project_data "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/data/projects.ts"
click node_project_index "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/Projects.tsx"
click node_project_detail "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/ProjectDetail.tsx"
click node_architecture "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/ArchitectureTabs.tsx"
click node_dev_activity "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/DevActivity.tsx"
click node_certs "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Certifications.tsx"
click node_blog "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/BlogSection.tsx"
click node_contact "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Contact.tsx"
click node_guestbook_page "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/GuestBook.tsx"
click node_floating_guestbook "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/FloatingGuestbook.tsx"
click node_guestbook_local "https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/lib/guestbook.ts"
click node_api_entry "https://github.com/k-nishant-18/nishant_portfolio/blob/main/api/%5B...path%5D.ts"
click node_api_server "https://github.com/k-nishant-18/nishant_portfolio/blob/main/api/server.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_home,node_theme,node_music,node_transitions toneBlue
class node_hero,node_about,node_skills,node_projects_section,node_project_data,node_project_index,node_project_detail,node_architecture,node_dev_activity,node_certs,node_blog toneAmber
class node_contact,node_guestbook_page,node_floating_guestbook,node_guestbook_local toneMint
class node_api_entry,node_api_server,node_postgres,node_email toneRose
class node_visitor toneIndigo
```

## Components

### App shell

- [React app and routes](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [Home page](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Theme state](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/context/ThemeContext.tsx): `src/context/ThemeContext.tsx`
- [Music state](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/context/MusicContext.tsx): `src/context/MusicContext.tsx`
- [Transition state](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/context/TransitionContext.jsx): `src/context/TransitionContext.jsx`

### Portfolio showcase

- [Hero experience](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Bio and skills](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Skills section](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Skills.tsx): `src/components/Skills.tsx`
- [Featured projects](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Projects.tsx): `src/components/Projects.tsx`
- [Project catalog](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/data/projects.ts): `src/data/projects.ts`
- [Project index page](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/Projects.tsx): `src/pages/Projects.tsx`
- [Project details](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/ProjectDetail.tsx): `src/pages/ProjectDetail.tsx`
- [Architecture diagrams](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/ArchitectureTabs.tsx): `src/components/ArchitectureTabs.tsx`
- [Developer activity](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/DevActivity.tsx): `src/components/DevActivity.tsx`
- [Certifications](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Certifications.tsx): `src/components/Certifications.tsx`
- [Blog section](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/BlogSection.tsx): `src/components/BlogSection.tsx`

### Visitor interaction

- [Contact section](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Guestbook page](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/pages/GuestBook.tsx): `src/pages/GuestBook.tsx`
- [Floating guestbook](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/components/FloatingGuestbook.tsx): `src/components/FloatingGuestbook.tsx`
- [Visitor entry cache](https://github.com/k-nishant-18/nishant_portfolio/blob/main/src/lib/guestbook.ts): `src/lib/guestbook.ts`

### API services

- [API function entry](https://github.com/k-nishant-18/nishant_portfolio/blob/main/api/%5B...path%5D.ts): `api/[...path].ts`
- [Express API](https://github.com/k-nishant-18/nishant_portfolio/blob/main/api/server.ts): `api/server.ts`
- **Postgres database**
- **Email service**

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → React app and routes: opens (evidence: `src/App.tsx`)
- React app and routes → Home page: routes to (evidence: `src/App.tsx`)
- React app and routes → Project index page: routes to (evidence: `src/App.tsx`)
- React app and routes → Project details: routes to (evidence: `src/App.tsx`)
- React app and routes → Guestbook page: routes to (evidence: `src/App.tsx`)
- React app and routes → Theme state: provides (evidence: `src/App.tsx`)
- React app and routes → Music state: provides (evidence: `src/App.tsx`)
- React app and routes → Transition state: provides (evidence: `src/App.tsx`)
- Home page → Hero experience: renders (evidence: `src/pages/Home.tsx`)
- Home page → Bio and skills: renders (evidence: `src/pages/Home.tsx`)
- Home page → Skills section: renders (evidence: `src/pages/Home.tsx`)
- Home page → Featured projects: renders (evidence: `src/pages/Home.tsx`)
- Home page → Developer activity: renders (evidence: `src/pages/Home.tsx`)
- Home page → Certifications: renders (evidence: `src/pages/Home.tsx`)
- Home page → Blog section: renders (evidence: `src/pages/Home.tsx`)
- Home page → Contact section: renders (evidence: `src/pages/Home.tsx`)
- Project index page → Project catalog: reads (evidence: `src/pages/Projects.tsx`)
- Project details → Project catalog: reads (evidence: `src/pages/ProjectDetail.tsx`)
- Project details → Architecture diagrams: renders (evidence: `src/pages/ProjectDetail.tsx`)
- Guestbook page → Visitor entry cache: loads and saves (evidence: `src/pages/GuestBook.tsx`)
- Portfolio visitor → Guestbook page: submits entries (evidence: `src/pages/GuestBook.tsx`)
- Guestbook page → API function entry: requests entries
- Floating guestbook → Visitor entry cache: uses (evidence: `src/components/FloatingGuestbook.tsx`)
- Contact section → API function entry: submits inquiry
- API function entry → Express API: forwards requests (evidence: `api/[...path].ts`)
- Express API → Postgres database: reads and writes (evidence: `README.md`)
- Express API → Email service: sends notifications (evidence: `README.md`)
