# aashishjha174-arch/aashish-portfolio architecture

> Architecture diagram of the GitHub repository aashishjha174-arch/aashish-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/aashishjha174-arch/aashish-portfolio
- Repository: https://github.com/aashishjha174-arch/aashish-portfolio

## Overview

This is a React portfolio site: visitors enter through the portfolio app, browse its profile and projects, and can contact the owner; the app also offers Google sign-in or guest access. Supporting features include a Three.js animated background, a contact form backed by Google Forms, a separate comments/reviews component backed by an HTTP API, and offline caching through a service worker. The README describes only Create React App scaffolding. The reviews component is present but its connection to the app is not shown; other relationships are limited to the supplied excerpts.

Main entry points: [`src/App.jsx`](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx) (Portfolio app), [`src/components/ContactSection.jsx`](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ContactSection.jsx) (Contact form), [`src/index.js`](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/index.js) (React entry point), [`src/components/ReviewsSection.jsx`](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ReviewsSection.jsx) (Reviews and replies)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portfolio experience"]
  node_app["Portfolio app<br/>[App.jsx]"]
  node_background["3D background"]
  node_about["About profile<br/>[App.jsx]"]
  node_projects["Project showcase<br/>[App.jsx]"]
  node_app_entry["React entry point<br/>[index.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_config["Firebase auth setup<br/>[firebase.js]"]
  node_firebase_auth{{"Firebase Authentication"}}
end

subgraph group_engagement["Visitor engagement"]
  node_contact["Contact form<br/>[ContactSection.jsx]"]
  node_reviews["Reviews and replies<br/>[ReviewsSection.jsx]"]
  node_comment_api{{"Comments API"}}
  node_google_forms{{"Google Forms"}}
  node_contact_channels{{"Phone and social links"}}
end

subgraph group_offline["Offline support"]
  node_service_worker["Offline service worker<br/>[service-worker.js]"]
  node_cached_assets[("Cached site assets")]
end

node_visitor(("Visitor"))
node_browser(("Visitor browser"))

node_visitor -->|"browses"| node_app
node_app -->|"renders"| node_about
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_background
node_app -->|"uses auth"| node_auth_config
node_auth_config -->|"initializes"| node_firebase_auth
node_app -->|"signs in and out"| node_firebase_auth
node_contact -->|"submits form"| node_google_forms
node_contact -->|"opens contact links"| node_contact_channels
node_reviews -->|"fetches and posts"| node_comment_api
node_reviews -->|"requests notifications"| node_browser
node_app_entry -->|"renders"| node_app
node_app_entry -->|"registers worker"| node_browser
node_service_worker -->|"caches assets"| node_cached_assets
node_service_worker -->|"serves offline"| node_browser

click node_app "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx"
click node_background "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ThreeBackground.jsx"
click node_about "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx"
click node_projects "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx"
click node_contact "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ContactSection.jsx"
click node_reviews "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ReviewsSection.jsx"
click node_auth_config "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/firebase.js"
click node_service_worker "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/public/service-worker.js"
click node_app_entry "https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/index.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_background,node_about,node_projects,node_app_entry,node_browser toneBlue
class node_auth_config,node_firebase_auth toneAmber
class node_contact,node_reviews,node_comment_api,node_google_forms,node_contact_channels toneMint
class node_service_worker,node_cached_assets toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio experience

- [Portfolio app](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx): `src/App.jsx`
- [3D background](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ThreeBackground.jsx): `src/components/ThreeBackground.jsx`
- [About profile](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx): `src/App.jsx`
- [Project showcase](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/App.jsx): `src/App.jsx`
- [React entry point](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/index.js): `src/index.js`

### Identity and access

- [Firebase auth setup](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/firebase.js): `src/firebase.js`
- **Firebase Authentication**

### Visitor engagement

- [Contact form](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ContactSection.jsx): `src/components/ContactSection.jsx`
- [Reviews and replies](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/src/components/ReviewsSection.jsx): `src/components/ReviewsSection.jsx`
- **Comments API**
- **Google Forms**
- **Phone and social links**

### Offline support

- [Offline service worker](https://github.com/aashishjha174-arch/aashish-portfolio/blob/main/public/service-worker.js): `public/service-worker.js`
- **Cached site assets**

### Other components

- **Visitor**
- **Visitor browser**

## Connections

- Visitor → Portfolio app: browses (evidence: `src/App.jsx`)
- Portfolio app → About profile: renders (evidence: `src/App.jsx`)
- Portfolio app → Project showcase: renders (evidence: `src/App.jsx`)
- Portfolio app → Contact form: renders (evidence: `src/App.jsx`)
- Portfolio app → 3D background: renders (evidence: `src/App.jsx`)
- Portfolio app → Firebase auth setup: uses auth (evidence: `src/App.jsx`)
- Firebase auth setup → Firebase Authentication: initializes (evidence: `src/firebase.js`)
- Portfolio app → Firebase Authentication: signs in and out (evidence: `src/App.jsx`)
- Contact form → Google Forms: submits form (evidence: `src/components/ContactSection.jsx`)
- Contact form → Phone and social links: opens contact links (evidence: `src/components/ContactSection.jsx`)
- Reviews and replies → Comments API: fetches and posts (evidence: `src/components/ReviewsSection.jsx`)
- Reviews and replies → Visitor browser: requests notifications (evidence: `src/components/ReviewsSection.jsx`)
- React entry point → Portfolio app: renders (evidence: `src/index.js`)
- React entry point → Visitor browser: registers worker (evidence: `src/index.js`)
- Offline service worker → Cached site assets: caches assets (evidence: `public/service-worker.js`)
- Offline service worker → Visitor browser: serves offline (evidence: `public/service-worker.js`)
