# sidvsingh1407/ai-portfolio-sidvsingh architecture

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

- Interactive diagram: https://gitdiagram.com/sidvsingh1407/ai-portfolio-sidvsingh
- Repository: https://github.com/sidvsingh1407/ai-portfolio-sidvsingh

## Overview

This is a personal portfolio site for presenting the author’s background, project work, and written insights, with a contact form that stores submissions in Firestore. A visitor enters through the React app, navigates routed pages, and can submit a message; shared navigation and visual components surround the page content. The content is primarily local data. The graph reflects relationships visible in excerpts or the source index; unsampled service behavior and optional integrations are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/App.tsx) (App router), [`src/pages/Home.tsx`](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Home.tsx) (Home and contact), [`src/content.ts`](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/content.ts) (Portfolio content), [`src/components/FloatingParticles.tsx`](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/FloatingParticles.tsx) (Particle effects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_router["App router<br/>[App.tsx]"]
end

subgraph group_pages["Portfolio pages"]
  node_home["Home and contact<br/>[Home.tsx]"]
  node_about["About page<br/>[About.tsx]"]
  node_projects["Projects page<br/>[Projects.tsx]"]
  node_blog["Insights list<br/>[Blog.tsx]"]
  node_blogpost["Insight article<br/>[BlogPost.tsx]"]
end

subgraph group_shared["Shared presentation"]
  node_header["Header navigation<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_particles["Particle effects"]
  node_starfield["Starfield<br/>[Starfield.tsx]"]
  node_machine["Machine-readable layer"]
end

subgraph group_data["Content and services"]
  node_content["Portfolio content<br/>[content.ts]"]
  node_firebase["Firebase client<br/>[firebase.ts]"]
  node_gemini["Gemini service<br/>[gemini.ts]"]
  node_logger["Logger<br/>[logger.ts]"]
end

node_visitor(("Visitor"))
node_firestore[("Firestore")]

node_visitor -->|"opens site"| node_entry
node_entry -->|"renders"| node_router
node_router -->|"renders"| node_header
node_router -->|"renders"| node_footer
node_router -->|"renders"| node_starfield
node_router -->|"renders"| node_machine
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_about
node_router -->|"routes to"| node_projects
node_router -->|"routes to"| node_blog
node_router -->|"routes to"| node_blogpost
node_home -->|"reads"| node_content
node_about -->|"reads"| node_content
node_projects -->|"reads"| node_content
node_blog -->|"reads"| node_content
node_blogpost -->|"reads"| node_content
node_home -->|"uses client"| node_firebase
node_firebase -->|"initializes client"| node_firestore
node_home -->|"writes messages"| node_firestore
node_home -->|"renders"| node_particles
node_header -->|"renders"| node_particles
node_footer -->|"renders"| node_particles
node_gemini -->|"references"| node_logger

click node_entry "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/main.tsx"
click node_router "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/App.tsx"
click node_home "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Home.tsx"
click node_about "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/About.tsx"
click node_projects "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Projects.tsx"
click node_blog "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Blog.tsx"
click node_blogpost "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/BlogPost.tsx"
click node_header "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/Header.tsx"
click node_footer "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/Footer.tsx"
click node_particles "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/FloatingParticles.tsx"
click node_starfield "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/Starfield.tsx"
click node_machine "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/MachineReadableLayer.tsx"
click node_content "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/content.ts"
click node_firebase "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/firebase.ts"
click node_gemini "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/services/gemini.ts"
click node_logger "https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/utils/logger.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_entry,node_router toneBlue
class node_home,node_about,node_projects,node_blog,node_blogpost,node_firestore toneAmber
class node_header,node_footer,node_particles,node_starfield,node_machine toneMint
class node_content,node_firebase,node_gemini,node_logger toneRose
class node_visitor toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/main.tsx): `src/main.tsx`
- [App router](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/App.tsx): `src/App.tsx`

### Portfolio pages

- [Home and contact](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [About page](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/About.tsx): `src/pages/About.tsx`
- [Projects page](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Projects.tsx): `src/pages/Projects.tsx`
- [Insights list](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/Blog.tsx): `src/pages/Blog.tsx`
- [Insight article](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/pages/BlogPost.tsx): `src/pages/BlogPost.tsx`

### Shared presentation

- [Header navigation](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [Footer](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Particle effects](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/FloatingParticles.tsx): `src/components/FloatingParticles.tsx`
- [Starfield](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/Starfield.tsx): `src/components/Starfield.tsx`
- [Machine-readable layer](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/components/MachineReadableLayer.tsx): `src/components/MachineReadableLayer.tsx`

### Content and services

- [Portfolio content](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/content.ts): `src/content.ts`
- [Firebase client](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/firebase.ts): `src/firebase.ts`
- [Gemini service](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/services/gemini.ts): `src/services/gemini.ts`
- [Logger](https://github.com/sidvsingh1407/ai-portfolio-sidvsingh/blob/main/src/utils/logger.ts): `src/utils/logger.ts`

### Other components

- **Visitor**
- **Firestore**

## Connections

- Visitor → React entry: opens site (evidence: `src/main.tsx`)
- React entry → App router: renders (evidence: `src/main.tsx`)
- App router → Header navigation: renders (evidence: `src/App.tsx`)
- App router → Footer: renders (evidence: `src/App.tsx`)
- App router → Starfield: renders (evidence: `src/App.tsx`)
- App router → Machine-readable layer: renders (evidence: `src/App.tsx`)
- App router → Home and contact: routes to (evidence: `src/App.tsx`)
- App router → About page: routes to (evidence: `src/App.tsx`)
- App router → Projects page: routes to (evidence: `src/App.tsx`)
- App router → Insights list: routes to (evidence: `src/App.tsx`)
- App router → Insight article: routes to (evidence: `src/App.tsx`)
- Home and contact → Portfolio content: reads (evidence: `src/pages/Home.tsx`)
- About page → Portfolio content: reads (evidence: `src/pages/About.tsx`)
- Projects page → Portfolio content: reads (evidence: `src/pages/Projects.tsx`)
- Insights list → Portfolio content: reads (evidence: `src/pages/Blog.tsx`)
- Insight article → Portfolio content: reads (evidence: `src/pages/BlogPost.tsx`)
- Home and contact → Firebase client: uses client (evidence: `src/pages/Home.tsx`)
- Firebase client → Firestore: initializes client (evidence: `src/firebase.ts`)
- Home and contact → Firestore: writes messages (evidence: `src/pages/Home.tsx`)
- Home and contact → Particle effects: renders (evidence: `src/pages/Home.tsx`)
- Header navigation → Particle effects: renders (evidence: `src/components/Header.tsx`)
- Footer → Particle effects: renders (evidence: `src/components/Footer.tsx`)
- Gemini service → Logger: references (evidence: `src/services/gemini.ts`)
