# gowtham2098/portfolio architecture

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

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

## Overview

This is a data-driven personal portfolio website. Its main workflow loads resume content from Markdown, parses it into typed data, and passes that data through the app to portfolio sections; visitors can also switch themes, download a PDF resume, and contact the owner via email. The README documents the Markdown/HMR flow; source-index references and excerpts support the component wiring. Some section implementations were not excerpted, so their internal behavior is represented only where documented.

Main entry points: [`src/App.tsx`](https://github.com/gowtham2098/portfolio/blob/main/src/App.tsx) (App composition), [`src/components/Hero.tsx`](https://github.com/gowtham2098/portfolio/blob/main/src/components/Hero.tsx) (Hero), [`src/components/About.tsx`](https://github.com/gowtham2098/portfolio/blob/main/src/components/About.tsx) (About), [`src/components/Navbar.tsx`](https://github.com/gowtham2098/portfolio/blob/main/src/components/Navbar.tsx) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Resume content"]
  node_resume_md["Resume Markdown<br/>[resume.md]"]
  node_resume_hook["Resume loader<br/>[useResume.ts]"]
  node_parser["Markdown parser<br/>[markdownParser.ts]"]
  node_resume_types["Resume types<br/>[resume.ts]"]
end

subgraph group_portfolio["Portfolio experience"]
  node_app["App composition<br/>[App.tsx]"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_experience["Experience<br/>[Experience.tsx]"]
  node_projects["Projects<br/>[Projects.tsx]"]
  node_certifications["Certifications<br/>[Certifications.tsx]"]
  node_education["Education<br/>[Education.tsx]"]
  node_contact["Contact<br/>[Contact.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_code_window["Code window<br/>[CodeWindow.tsx]"]
end

subgraph group_shared["Shared presentation"]
  node_reveal["Scroll reveal<br/>[Reveal.tsx]"]
  node_backdrop["Section backdrop"]
  node_heading["Section heading<br/>[SectionHeading.tsx]"]
  node_cn["Class utility<br/>[cn.ts]"]
end

subgraph group_interactions["Visitor interactions"]
  node_theme_hook["Theme state<br/>[useTheme.ts]"]
  node_theme_toggle["Theme toggle<br/>[ThemeToggle.tsx]"]
  node_spotlight["Hero spotlight"]
  node_download["Resume download<br/>[download.tsx]"]
  node_resume_pdf["PDF document<br/>[ResumePdf.tsx]"]
end

node_visitor(("Visitor"))
node_mail_client(("Mail client"))
node_browser_storage["Browser storage and preferences"]

node_visitor -->|"opens"| node_app
node_resume_md -->|"loads as raw text"| node_resume_hook
node_resume_hook -->|"parses with"| node_parser
node_parser -->|"produces typed data"| node_resume_types
node_app -->|"loads resume"| node_resume_hook
node_app -->|"gets theme state"| node_theme_hook
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_experience
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_certifications
node_app -->|"renders"| node_education
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_footer
node_hero -->|"uses"| node_spotlight
node_hero -->|"requests PDF"| node_download
node_hero -->|"renders"| node_code_window
node_download -->|"creates document with"| node_resume_pdf
node_navbar -->|"renders"| node_theme_toggle
node_navbar -->|"uses"| node_download
node_contact -->|"opens mailto"| node_mail_client
node_theme_hook -->|"reads and writes preference"| node_browser_storage
node_theme_hook -->|"checks system theme"| node_browser_storage
node_about -->|"uses"| node_heading
node_about -->|"uses"| node_backdrop
node_about -->|"uses"| node_reveal
node_backdrop -->|"uses"| node_cn

click node_resume_md "https://github.com/gowtham2098/portfolio/blob/main/src/data/resume.md"
click node_resume_hook "https://github.com/gowtham2098/portfolio/blob/main/src/hooks/useResume.ts"
click node_parser "https://github.com/gowtham2098/portfolio/blob/main/src/utils/markdownParser.ts"
click node_resume_types "https://github.com/gowtham2098/portfolio/blob/main/src/types/resume.ts"
click node_app "https://github.com/gowtham2098/portfolio/blob/main/src/App.tsx"
click node_hero "https://github.com/gowtham2098/portfolio/blob/main/src/components/Hero.tsx"
click node_about "https://github.com/gowtham2098/portfolio/blob/main/src/components/About.tsx"
click node_skills "https://github.com/gowtham2098/portfolio/blob/main/src/components/Skills.tsx"
click node_experience "https://github.com/gowtham2098/portfolio/blob/main/src/components/Experience.tsx"
click node_projects "https://github.com/gowtham2098/portfolio/blob/main/src/components/Projects.tsx"
click node_certifications "https://github.com/gowtham2098/portfolio/blob/main/src/components/Certifications.tsx"
click node_education "https://github.com/gowtham2098/portfolio/blob/main/src/components/Education.tsx"
click node_contact "https://github.com/gowtham2098/portfolio/blob/main/src/components/Contact.tsx"
click node_navbar "https://github.com/gowtham2098/portfolio/blob/main/src/components/Navbar.tsx"
click node_footer "https://github.com/gowtham2098/portfolio/blob/main/src/components/Footer.tsx"
click node_code_window "https://github.com/gowtham2098/portfolio/blob/main/src/components/CodeWindow.tsx"
click node_reveal "https://github.com/gowtham2098/portfolio/blob/main/src/components/Reveal.tsx"
click node_backdrop "https://github.com/gowtham2098/portfolio/blob/main/src/components/SectionBackdrop.tsx"
click node_heading "https://github.com/gowtham2098/portfolio/blob/main/src/components/SectionHeading.tsx"
click node_cn "https://github.com/gowtham2098/portfolio/blob/main/src/utils/cn.ts"
click node_theme_hook "https://github.com/gowtham2098/portfolio/blob/main/src/hooks/useTheme.ts"
click node_theme_toggle "https://github.com/gowtham2098/portfolio/blob/main/src/components/ThemeToggle.tsx"
click node_spotlight "https://github.com/gowtham2098/portfolio/blob/main/src/hooks/useHeroSpotlight.ts"
click node_download "https://github.com/gowtham2098/portfolio/blob/main/src/utils/download.tsx"
click node_resume_pdf "https://github.com/gowtham2098/portfolio/blob/main/src/components/ResumePdf.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_resume_md,node_resume_hook,node_parser,node_resume_types,node_mail_client toneBlue
class node_app,node_hero,node_about,node_skills,node_experience,node_projects,node_certifications,node_education,node_contact,node_navbar,node_footer,node_code_window,node_browser_storage toneAmber
class node_reveal,node_backdrop,node_heading,node_cn toneMint
class node_theme_hook,node_theme_toggle,node_spotlight,node_download,node_resume_pdf toneRose
class node_visitor toneIndigo
```

## Components

### Resume content

- [Resume Markdown](https://github.com/gowtham2098/portfolio/blob/main/src/data/resume.md): `src/data/resume.md`
- [Resume loader](https://github.com/gowtham2098/portfolio/blob/main/src/hooks/useResume.ts): `src/hooks/useResume.ts`
- [Markdown parser](https://github.com/gowtham2098/portfolio/blob/main/src/utils/markdownParser.ts): `src/utils/markdownParser.ts`
- [Resume types](https://github.com/gowtham2098/portfolio/blob/main/src/types/resume.ts): `src/types/resume.ts`

### Portfolio experience

- [App composition](https://github.com/gowtham2098/portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [Hero](https://github.com/gowtham2098/portfolio/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [About](https://github.com/gowtham2098/portfolio/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Skills](https://github.com/gowtham2098/portfolio/blob/main/src/components/Skills.tsx): `src/components/Skills.tsx`
- [Experience](https://github.com/gowtham2098/portfolio/blob/main/src/components/Experience.tsx): `src/components/Experience.tsx`
- [Projects](https://github.com/gowtham2098/portfolio/blob/main/src/components/Projects.tsx): `src/components/Projects.tsx`
- [Certifications](https://github.com/gowtham2098/portfolio/blob/main/src/components/Certifications.tsx): `src/components/Certifications.tsx`
- [Education](https://github.com/gowtham2098/portfolio/blob/main/src/components/Education.tsx): `src/components/Education.tsx`
- [Contact](https://github.com/gowtham2098/portfolio/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Navigation](https://github.com/gowtham2098/portfolio/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Footer](https://github.com/gowtham2098/portfolio/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Code window](https://github.com/gowtham2098/portfolio/blob/main/src/components/CodeWindow.tsx): `src/components/CodeWindow.tsx`

### Shared presentation

- [Scroll reveal](https://github.com/gowtham2098/portfolio/blob/main/src/components/Reveal.tsx): `src/components/Reveal.tsx`
- [Section backdrop](https://github.com/gowtham2098/portfolio/blob/main/src/components/SectionBackdrop.tsx): `src/components/SectionBackdrop.tsx`
- [Section heading](https://github.com/gowtham2098/portfolio/blob/main/src/components/SectionHeading.tsx): `src/components/SectionHeading.tsx`
- [Class utility](https://github.com/gowtham2098/portfolio/blob/main/src/utils/cn.ts): `src/utils/cn.ts`

### Visitor interactions

- [Theme state](https://github.com/gowtham2098/portfolio/blob/main/src/hooks/useTheme.ts): `src/hooks/useTheme.ts`
- [Theme toggle](https://github.com/gowtham2098/portfolio/blob/main/src/components/ThemeToggle.tsx): `src/components/ThemeToggle.tsx`
- [Hero spotlight](https://github.com/gowtham2098/portfolio/blob/main/src/hooks/useHeroSpotlight.ts): `src/hooks/useHeroSpotlight.ts`
- [Resume download](https://github.com/gowtham2098/portfolio/blob/main/src/utils/download.tsx): `src/utils/download.tsx`
- [PDF document](https://github.com/gowtham2098/portfolio/blob/main/src/components/ResumePdf.tsx): `src/components/ResumePdf.tsx`

### Other components

- **Visitor**
- **Mail client**
- **Browser storage and preferences**

## Connections

- Visitor → App composition: opens (evidence: `README.md`)
- Resume Markdown → Resume loader: loads as raw text (evidence: `README.md`)
- Resume loader → Markdown parser: parses with (evidence: `src/hooks/useResume.ts`)
- Markdown parser → Resume types: produces typed data (evidence: `src/utils/markdownParser.ts`)
- App composition → Resume loader: loads resume (evidence: `src/App.tsx`)
- App composition → Theme state: gets theme state (evidence: `src/App.tsx`)
- App composition → Navigation: renders (evidence: `src/App.tsx`)
- App composition → Hero: renders (evidence: `src/App.tsx`)
- App composition → About: renders (evidence: `src/App.tsx`)
- App composition → Skills: renders (evidence: `src/App.tsx`)
- App composition → Experience: renders (evidence: `src/App.tsx`)
- App composition → Projects: renders (evidence: `src/App.tsx`)
- App composition → Certifications: renders (evidence: `src/App.tsx`)
- App composition → Education: renders (evidence: `src/App.tsx`)
- App composition → Contact: renders (evidence: `src/App.tsx`)
- App composition → Footer: renders (evidence: `src/App.tsx`)
- Hero → Hero spotlight: uses (evidence: `src/components/Hero.tsx`)
- Hero → Resume download: requests PDF (evidence: `src/components/Hero.tsx`)
- Hero → Code window: renders (evidence: `src/components/Hero.tsx`)
- Resume download → PDF document: creates document with (evidence: `src/utils/download.tsx`)
- Navigation → Theme toggle: renders (evidence: `src/components/Navbar.tsx`)
- Navigation → Resume download: uses (evidence: `src/components/Navbar.tsx`)
- Contact → Mail client: opens mailto (evidence: `src/components/Contact.tsx`)
- Theme state → Browser storage and preferences: reads and writes preference (evidence: `src/hooks/useTheme.ts`)
- Theme state → Browser storage and preferences: checks system theme (evidence: `src/hooks/useTheme.ts`)
- About → Section heading: uses (evidence: `src/components/About.tsx`)
- About → Section backdrop: uses (evidence: `src/components/About.tsx`)
- About → Scroll reveal: uses (evidence: `src/components/About.tsx`)
- Section backdrop → Class utility: uses (evidence: `src/components/SectionBackdrop.tsx`)
