# aditya-p-29/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/aditya-p-29/portfolio
- Repository: https://github.com/aditya-p-29/portfolio

## Overview

This repository is a personal developer portfolio built with Next.js. Visitors browse a single-page presentation of the developer, skills, work, testimonials, projects, and GitHub activity, then can download a résumé or send a contact message. The page composition and UI components are shown in the excerpts; the API route implementations are read but their downstream integrations are not described here, so those links are omitted. The README describes the project as a Next.js app but does not document additional product capabilities.

Main entry points: [`src/app/page.tsx`](https://github.com/aditya-p-29/portfolio/blob/main/src/app/page.tsx) (Home page), [`src/lib/utils.ts`](https://github.com/aditya-p-29/portfolio/blob/main/src/lib/utils.ts) (Class utilities), [`src/components/sections/Projects.tsx`](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Projects.tsx) (Projects), [`src/components/sections/ContactForm.tsx`](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/ContactForm.tsx) (Contact form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio site"]
  node_home["Home page<br/>[page.tsx]"]
  node_shell["Site shell<br/>[layout.tsx]"]
  node_header["Navigation<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_content["Portfolio content"]
  node_hero["Introduction<br/>[Hero.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_work["Work history<br/>[Work.tsx]"]
  node_testimonial["Testimonial<br/>[Testimonial.tsx]"]
  node_projects["Projects<br/>[Projects.tsx]"]
  node_github["GitHub section<br/>[Github.tsx]"]
  node_githubstats["GitHub stats<br/>[GithubStats.tsx]"]
  node_portfolio_data["Portfolio data<br/>[index.ts]"]
end

subgraph group_contact["Contact and API"]
  node_contact_section["Contact section<br/>[Contact.tsx]"]
  node_contact_form["Contact form<br/>[ContactForm.tsx]"]
  node_contact_api["Contact endpoint<br/>[route.ts]"]
  node_github_api["GitHub endpoint<br/>[route.ts]"]
end

subgraph group_ui["UI components"]
  node_button["Button<br/>[button.tsx]"]
  node_card["Card<br/>[card.tsx]"]
  node_badge["Badge<br/>[badge.tsx]"]
  node_input["Input<br/>[input.tsx]"]
  node_textarea["Textarea<br/>[textarea.tsx]"]
  node_tooltip["Tooltip<br/>[tooltip.tsx]"]
  node_utils["Class utilities<br/>[utils.ts]"]
end

node_visitor(("Visitor"))
node_external_github(("GitHub service"))

node_visitor -->|"opens site"| node_shell
node_shell -->|"renders"| node_header
node_shell -->|"renders"| node_footer
node_shell -->|"wraps page"| node_home
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_skills
node_home -->|"renders"| node_work
node_home -->|"renders"| node_testimonial
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_github
node_home -->|"renders"| node_contact_section
node_github -->|"renders"| node_githubstats
node_skills -->|"reads technologies"| node_portfolio_data
node_projects -->|"reads projects"| node_portfolio_data
node_testimonial -->|"reads testimonials"| node_portfolio_data
node_githubstats -->|"fetches stats"| node_github_api
node_github_api -.-> node_external_github
node_contact_section -->|"renders"| node_contact_form
node_contact_form -.-> node_contact_api
node_contact_section -->|"uses"| node_button
node_contact_form -->|"uses"| node_button
node_contact_form -->|"uses"| node_input
node_contact_form -->|"uses"| node_textarea
node_projects -->|"uses"| node_card
node_projects -->|"uses"| node_button
node_projects -->|"uses"| node_badge
node_githubstats -->|"uses"| node_card
node_githubstats -->|"uses"| node_tooltip
node_header -->|"uses"| node_button
node_button -->|"merges classes"| node_utils
node_card -->|"merges classes"| node_utils
node_badge -->|"merges classes"| node_utils
node_input -->|"merges classes"| node_utils
node_textarea -->|"merges classes"| node_utils
node_tooltip -->|"merges classes"| node_utils

click node_home "https://github.com/aditya-p-29/portfolio/blob/main/src/app/page.tsx"
click node_shell "https://github.com/aditya-p-29/portfolio/blob/main/src/app/layout.tsx"
click node_header "https://github.com/aditya-p-29/portfolio/blob/main/src/components/layout/Header.tsx"
click node_footer "https://github.com/aditya-p-29/portfolio/blob/main/src/components/layout/Footer.tsx"
click node_hero "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Hero.tsx"
click node_skills "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Skills.tsx"
click node_work "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Work.tsx"
click node_testimonial "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Testimonial.tsx"
click node_projects "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Projects.tsx"
click node_github "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Github.tsx"
click node_githubstats "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/GithubStats.tsx"
click node_portfolio_data "https://github.com/aditya-p-29/portfolio/blob/main/src/constants/index.ts"
click node_contact_section "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Contact.tsx"
click node_contact_form "https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/ContactForm.tsx"
click node_contact_api "https://github.com/aditya-p-29/portfolio/blob/main/src/app/api/contact/route.ts"
click node_github_api "https://github.com/aditya-p-29/portfolio/blob/main/src/app/api/github/route.ts"
click node_button "https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/button.tsx"
click node_card "https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/card.tsx"
click node_badge "https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/badge.tsx"
click node_input "https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/input.tsx"
click node_textarea "https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/textarea.tsx"
click node_tooltip "https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/tooltip.tsx"
click node_utils "https://github.com/aditya-p-29/portfolio/blob/main/src/lib/utils.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_home,node_shell,node_header,node_footer toneBlue
class node_hero,node_skills,node_work,node_testimonial,node_projects,node_github,node_githubstats,node_portfolio_data toneAmber
class node_contact_section,node_contact_form,node_contact_api,node_github_api toneMint
class node_button,node_card,node_badge,node_input,node_textarea,node_tooltip,node_utils toneRose
class node_visitor,node_external_github toneIndigo
```

## Components

### Portfolio site

- [Home page](https://github.com/aditya-p-29/portfolio/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Site shell](https://github.com/aditya-p-29/portfolio/blob/main/src/app/layout.tsx): `src/app/layout.tsx`
- [Navigation](https://github.com/aditya-p-29/portfolio/blob/main/src/components/layout/Header.tsx): `src/components/layout/Header.tsx`
- [Footer](https://github.com/aditya-p-29/portfolio/blob/main/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`

### Portfolio content

- [Introduction](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Hero.tsx): `src/components/sections/Hero.tsx`
- [Skills](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Skills.tsx): `src/components/sections/Skills.tsx`
- [Work history](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Work.tsx): `src/components/sections/Work.tsx`
- [Testimonial](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Testimonial.tsx): `src/components/sections/Testimonial.tsx`
- [Projects](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Projects.tsx): `src/components/sections/Projects.tsx`
- [GitHub section](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Github.tsx): `src/components/sections/Github.tsx`
- [GitHub stats](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/GithubStats.tsx): `src/components/sections/GithubStats.tsx`
- [Portfolio data](https://github.com/aditya-p-29/portfolio/blob/main/src/constants/index.ts): `src/constants/index.ts`

### Contact and API

- [Contact section](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/Contact.tsx): `src/components/sections/Contact.tsx`
- [Contact form](https://github.com/aditya-p-29/portfolio/blob/main/src/components/sections/ContactForm.tsx): `src/components/sections/ContactForm.tsx`
- [Contact endpoint](https://github.com/aditya-p-29/portfolio/blob/main/src/app/api/contact/route.ts): `src/app/api/contact/route.ts`
- [GitHub endpoint](https://github.com/aditya-p-29/portfolio/blob/main/src/app/api/github/route.ts): `src/app/api/github/route.ts`

### UI components

- [Button](https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Card](https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/card.tsx): `src/components/ui/card.tsx`
- [Badge](https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/badge.tsx): `src/components/ui/badge.tsx`
- [Input](https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/input.tsx): `src/components/ui/input.tsx`
- [Textarea](https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/textarea.tsx): `src/components/ui/textarea.tsx`
- [Tooltip](https://github.com/aditya-p-29/portfolio/blob/main/src/components/ui/tooltip.tsx): `src/components/ui/tooltip.tsx`
- [Class utilities](https://github.com/aditya-p-29/portfolio/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **Visitor**
- **GitHub service**

## Connections

- Visitor → Site shell: opens site (evidence: `src/app/layout.tsx`)
- Site shell → Navigation: renders (evidence: `src/app/layout.tsx`)
- Site shell → Footer: renders (evidence: `src/app/layout.tsx`)
- Site shell → Home page: wraps page (evidence: `src/app/layout.tsx`)
- Home page → Introduction: renders (evidence: `src/app/page.tsx`)
- Home page → Skills: renders (evidence: `src/app/page.tsx`)
- Home page → Work history: renders (evidence: `src/app/page.tsx`)
- Home page → Testimonial: renders (evidence: `src/app/page.tsx`)
- Home page → Projects: renders (evidence: `src/app/page.tsx`)
- Home page → GitHub section: renders (evidence: `src/app/page.tsx`)
- Home page → Contact section: renders (evidence: `src/app/page.tsx`)
- GitHub section → GitHub stats: renders (evidence: `src/components/sections/Github.tsx`)
- Skills → Portfolio data: reads technologies (evidence: `src/components/sections/Skills.tsx`)
- Projects → Portfolio data: reads projects (evidence: `src/components/sections/Projects.tsx`)
- Testimonial → Portfolio data: reads testimonials (evidence: `src/components/sections/Testimonial.tsx`)
- GitHub stats → GitHub endpoint: fetches stats (evidence: `src/components/sections/GithubStats.tsx`)
- GitHub endpoint → GitHub service
- Contact section → Contact form: renders (evidence: `src/components/sections/Contact.tsx`)
- Contact form → Contact endpoint
- Contact section → Button: uses (evidence: `src/components/sections/Contact.tsx`)
- Contact form → Button: uses (evidence: `src/components/sections/ContactForm.tsx`)
- Contact form → Input: uses (evidence: `src/components/sections/ContactForm.tsx`)
- Contact form → Textarea: uses (evidence: `src/components/sections/ContactForm.tsx`)
- Projects → Card: uses (evidence: `src/components/sections/Projects.tsx`)
- Projects → Button: uses (evidence: `src/components/sections/Projects.tsx`)
- Projects → Badge: uses (evidence: `src/components/sections/Projects.tsx`)
- GitHub stats → Card: uses (evidence: `src/components/sections/GithubStats.tsx`)
- GitHub stats → Tooltip: uses (evidence: `src/components/sections/GithubStats.tsx`)
- Navigation → Button: uses (evidence: `src/components/layout/Header.tsx`)
- Button → Class utilities: merges classes (evidence: `src/components/ui/button.tsx`)
- Card → Class utilities: merges classes (evidence: `src/components/ui/card.tsx`)
- Badge → Class utilities: merges classes (evidence: `src/components/ui/badge.tsx`)
- Input → Class utilities: merges classes (evidence: `src/components/ui/input.tsx`)
- Textarea → Class utilities: merges classes (evidence: `src/components/ui/textarea.tsx`)
- Tooltip → Class utilities: merges classes (evidence: `src/components/ui/tooltip.tsx`)
