# sakthi0x/portfolio_v1 architecture

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

## Overview

This is a React/TypeScript personal portfolio with two portfolio presentations represented in the source: the routed notebook-style Home experience and a richer stealth dashboard. The principal workflow takes a visitor through the app’s unlock/loading screens into the portfolio, where they browse profile, experience, projects, activity, writing, and contact content. Theme, audio, visitor counting, and engagement tracking support that experience. The README documents Medium-style writing, WakaTime, GitHub activity, and Firebase visitor counting; some integration wiring is not visible in the excerpts, so those links are omitted or marked unverified.

Main entry points: [`src/pages/Home.tsx`](https://github.com/sakthi0x/portfolio_v1/blob/main/src/pages/Home.tsx) (Notebook home), [`src/App.tsx`](https://github.com/sakthi0x/portfolio_v1/blob/main/src/App.tsx) (App and routing), [`src/pages/StealthDashboard.tsx`](https://github.com/sakthi0x/portfolio_v1/blob/main/src/pages/StealthDashboard.tsx) (Stealth dashboard), [`src/components/sections/HeroSection.tsx`](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/HeroSection.tsx) (Profile hero)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["App and routing<br/>[App.tsx]"]
  node_unlock["Unlock intro"]
  node_loading["Loading screen<br/>[LoadingScreen.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_home["Notebook home<br/>[Home.tsx]"]
  node_stealth["Stealth dashboard"]
  node_hero["Profile hero<br/>[HeroSection.tsx]"]
  node_experience["Experience"]
  node_projects["Project catalog<br/>[projects.ts]"]
  node_deployed["Deployed projects<br/>[DeployedAssets.tsx]"]
  node_writing["Writing stream"]
  node_contact["Contact form<br/>[ContactForm.tsx]"]
end

subgraph group_interaction["Interactive features"]
  node_theme["Theme provider<br/>[ThemeProvider.tsx]"]
  node_theme_toggle["Theme toggle<br/>[ThemeToggle.tsx]"]
  node_audio_provider["Audio provider<br/>[AudioProvider.tsx]"]
  node_audio["Audio engine<br/>[audioEngine.ts]"]
  node_gamification["Engagement tracking<br/>[useGamification.ts]"]
  node_chat_widget["Chat widget<br/>[ChatWidget.tsx]"]
end

subgraph group_integrations["External data"]
  node_github["GitHub activity<br/>[GithubHeatmap.tsx]"]
  node_commit["Latest commit<br/>[LatestCommit.tsx]"]
  node_wakatime["WakaTime stats<br/>[WakatimeStats.tsx]"]
  node_visitor_count["Visitor counter<br/>[VisitorCounter.tsx]"]
  node_firebase[("Firebase counter data<br/>[firebase.ts]")]
  node_medium_api["Medium feed endpoint<br/>[medium.js]"]
  node_chat_api["Chat endpoint<br/>[chat.js]"]
end

node_visitor(("Portfolio visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"shows first"| node_unlock
node_unlock -->|"unlocks"| node_loading
node_loading -->|"reveals"| node_home
node_app -->|"wraps app"| node_theme
node_app -->|"mounts"| node_audio_provider
node_audio_provider -->|"uses"| node_audio
node_home -->|"renders"| node_experience
node_home -->|"renders"| node_github
node_home -->|"renders"| node_commit
node_home -->|"renders"| node_contact
node_home -->|"renders"| node_writing
node_home -->|"renders"| node_visitor_count
node_home -->|"reads"| node_projects
node_home -->|"renders"| node_wakatime
node_theme_toggle -->|"updates"| node_theme
node_visitor_count -->|"calls"| node_firebase
node_deployed -->|"reads"| node_projects
node_deployed -->|"tracks engagement"| node_gamification
node_stealth -->|"renders"| node_hero
node_stealth -->|"renders"| node_deployed
node_stealth -->|"renders"| node_writing
node_hero -->|"shows popup"| node_wakatime
node_hero -->|"renders"| node_commit
node_writing -.->|"may fetch"| node_medium_api
node_chat_widget -.->|"may call"| node_chat_api

click node_app "https://github.com/sakthi0x/portfolio_v1/blob/main/src/App.tsx"
click node_unlock "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/ui/UnlockIntroScreen.tsx"
click node_loading "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/ui/LoadingScreen.tsx"
click node_home "https://github.com/sakthi0x/portfolio_v1/blob/main/src/pages/Home.tsx"
click node_stealth "https://github.com/sakthi0x/portfolio_v1/blob/main/src/pages/StealthDashboard.tsx"
click node_hero "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/HeroSection.tsx"
click node_experience "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/ExperienceSection.tsx"
click node_projects "https://github.com/sakthi0x/portfolio_v1/blob/main/src/data/projects.ts"
click node_deployed "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/DeployedAssets.tsx"
click node_writing "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/FlowingBlogRiver.tsx"
click node_contact "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/ContactForm.tsx"
click node_theme "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/ThemeProvider.tsx"
click node_theme_toggle "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/ui/ThemeToggle.tsx"
click node_audio_provider "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/AudioProvider.tsx"
click node_audio "https://github.com/sakthi0x/portfolio_v1/blob/main/src/utils/audioEngine.ts"
click node_gamification "https://github.com/sakthi0x/portfolio_v1/blob/main/src/utils/useGamification.ts"
click node_github "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/GithubHeatmap.tsx"
click node_commit "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/LatestCommit.tsx"
click node_wakatime "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/WakatimeStats.tsx"
click node_visitor_count "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/VisitorCounter.tsx"
click node_firebase "https://github.com/sakthi0x/portfolio_v1/blob/main/src/services/firebase.ts"
click node_medium_api "https://github.com/sakthi0x/portfolio_v1/blob/main/api/medium.js"
click node_chat_widget "https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/ChatWidget.tsx"
click node_chat_api "https://github.com/sakthi0x/portfolio_v1/blob/main/api/chat.js"

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_unlock,node_loading toneBlue
class node_home,node_stealth,node_hero,node_experience,node_projects,node_deployed,node_writing,node_contact toneAmber
class node_theme,node_theme_toggle,node_audio_provider,node_audio,node_gamification,node_chat_widget toneMint
class node_github,node_commit,node_wakatime,node_visitor_count,node_firebase,node_medium_api,node_chat_api toneRose
class node_visitor toneIndigo
```

## Components

### App shell

- [App and routing](https://github.com/sakthi0x/portfolio_v1/blob/main/src/App.tsx): `src/App.tsx`
- [Unlock intro](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/ui/UnlockIntroScreen.tsx): `src/components/ui/UnlockIntroScreen.tsx`
- [Loading screen](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/ui/LoadingScreen.tsx): `src/components/ui/LoadingScreen.tsx`

### Portfolio content

- [Notebook home](https://github.com/sakthi0x/portfolio_v1/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Stealth dashboard](https://github.com/sakthi0x/portfolio_v1/blob/main/src/pages/StealthDashboard.tsx): `src/pages/StealthDashboard.tsx`
- [Profile hero](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/HeroSection.tsx): `src/components/sections/HeroSection.tsx`
- [Experience](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/ExperienceSection.tsx): `src/components/sections/ExperienceSection.tsx`
- [Project catalog](https://github.com/sakthi0x/portfolio_v1/blob/main/src/data/projects.ts): `src/data/projects.ts`
- [Deployed projects](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/DeployedAssets.tsx): `src/components/sections/DeployedAssets.tsx`
- [Writing stream](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/FlowingBlogRiver.tsx): `src/components/sections/FlowingBlogRiver.tsx`
- [Contact form](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/sections/ContactForm.tsx): `src/components/sections/ContactForm.tsx`

### Interactive features

- [Theme provider](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/ThemeProvider.tsx): `src/components/features/ThemeProvider.tsx`
- [Theme toggle](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/ui/ThemeToggle.tsx): `src/components/ui/ThemeToggle.tsx`
- [Audio provider](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/AudioProvider.tsx): `src/components/features/AudioProvider.tsx`
- [Audio engine](https://github.com/sakthi0x/portfolio_v1/blob/main/src/utils/audioEngine.ts): `src/utils/audioEngine.ts`
- [Engagement tracking](https://github.com/sakthi0x/portfolio_v1/blob/main/src/utils/useGamification.ts): `src/utils/useGamification.ts`
- [Chat widget](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/ChatWidget.tsx): `src/components/features/ChatWidget.tsx`

### External data

- [GitHub activity](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/GithubHeatmap.tsx): `src/components/features/GithubHeatmap.tsx`
- [Latest commit](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/LatestCommit.tsx): `src/components/features/LatestCommit.tsx`
- [WakaTime stats](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/WakatimeStats.tsx): `src/components/features/WakatimeStats.tsx`
- [Visitor counter](https://github.com/sakthi0x/portfolio_v1/blob/main/src/components/features/VisitorCounter.tsx): `src/components/features/VisitorCounter.tsx`
- [Firebase counter data](https://github.com/sakthi0x/portfolio_v1/blob/main/src/services/firebase.ts): `src/services/firebase.ts`
- [Medium feed endpoint](https://github.com/sakthi0x/portfolio_v1/blob/main/api/medium.js): `api/medium.js`
- [Chat endpoint](https://github.com/sakthi0x/portfolio_v1/blob/main/api/chat.js): `api/chat.js`

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → App and routing: opens
- App and routing → Unlock intro: shows first (evidence: `src/App.tsx`)
- Unlock intro → Loading screen: unlocks (evidence: `src/App.tsx`)
- Loading screen → Notebook home: reveals (evidence: `src/App.tsx`)
- App and routing → Theme provider: wraps app (evidence: `src/App.tsx`)
- App and routing → Audio provider: mounts (evidence: `src/App.tsx`)
- Audio provider → Audio engine: uses (evidence: `src/components/features/AudioProvider.tsx`)
- Notebook home → Experience: renders (evidence: `src/pages/Home.tsx`)
- Notebook home → GitHub activity: renders (evidence: `src/pages/Home.tsx`)
- Notebook home → Latest commit: renders (evidence: `src/pages/Home.tsx`)
- Notebook home → Contact form: renders (evidence: `src/pages/Home.tsx`)
- Notebook home → Writing stream: renders (evidence: `src/pages/Home.tsx`)
- Notebook home → Visitor counter: renders (evidence: `src/pages/Home.tsx`)
- Notebook home → Project catalog: reads (evidence: `src/pages/Home.tsx`)
- Notebook home → WakaTime stats: renders (evidence: `src/pages/Home.tsx`)
- Theme toggle → Theme provider: updates (evidence: `src/components/ui/ThemeToggle.tsx`)
- Visitor counter → Firebase counter data: calls (evidence: `src/components/features/VisitorCounter.tsx`)
- Deployed projects → Project catalog: reads (evidence: `src/components/sections/DeployedAssets.tsx`)
- Deployed projects → Engagement tracking: tracks engagement (evidence: `src/components/sections/DeployedAssets.tsx`)
- Stealth dashboard → Profile hero: renders (evidence: `src/pages/StealthDashboard.tsx`)
- Stealth dashboard → Deployed projects: renders (evidence: `src/pages/StealthDashboard.tsx`)
- Stealth dashboard → Writing stream: renders (evidence: `src/pages/StealthDashboard.tsx`)
- Profile hero → WakaTime stats: shows popup (evidence: `src/components/sections/HeroSection.tsx`)
- Profile hero → Latest commit: renders (evidence: `src/components/sections/HeroSection.tsx`)
- Writing stream → Medium feed endpoint: may fetch
- Chat widget → Chat endpoint: may call
