# yashuck18-cloud/portfolio architecture

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

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

## Overview

This repository is a personal portfolio website with an admin CMS. Visitors follow the public-page route to a portfolio assembled from profile, skills, projects, certifications, resume, GitHub, and contact sections. Admins have separate login, dashboard, and settings routes; portfolio state is loaded and edited through shared context, with browser-local persistence and Firebase realtime synchronization. Contact also submits through EmailJS. Evidence is limited to the supplied excerpts and SOURCE INDEX references; unsampled route and section internals are not inferred.

Main entry points: [`src/Portfolio.jsx`](https://github.com/yashuck18-cloud/portfolio/blob/main/src/Portfolio.jsx) (Portfolio page), [`src/hooks/usePortfolioData.js`](https://github.com/yashuck18-cloud/portfolio/blob/main/src/hooks/usePortfolioData.js) (Data adapter hook), [`src/context/PortfolioContext.jsx`](https://github.com/yashuck18-cloud/portfolio/blob/main/src/context/PortfolioContext.jsx) (Portfolio state), [`src/App.jsx`](https://github.com/yashuck18-cloud/portfolio/blob/main/src/App.jsx) (Route application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App routing"]
  node_app["Route application<br/>[App.jsx]"]
end

subgraph group_public["Public portfolio"]
  node_portfolio["Portfolio page<br/>[Portfolio.jsx]"]
  node_hero["Hero<br/>[Hero.jsx]"]
  node_about["About<br/>[About.jsx]"]
  node_skills["Skills<br/>[Skills.jsx]"]
  node_projects["Projects<br/>[Projects.jsx]"]
  node_certifications["Certifications<br/>[Certifications.jsx]"]
  node_resume["Resume<br/>[Resume.jsx]"]
  node_github["GitHub section<br/>[Github.jsx]"]
  node_contact["Contact<br/>[Contact.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_heading["Section heading<br/>[SectionHeading.jsx]"]
end

subgraph group_admin["Portfolio admin"]
  node_login["Admin login<br/>[Login.jsx]"]
  node_private["Private route<br/>[PrivateRoute.jsx]"]
  node_dashboard["CMS dashboard<br/>[Dashboard.jsx]"]
  node_settings["Admin settings<br/>[Settings.jsx]"]
end

subgraph group_state["Portfolio data"]
  node_hook["Data adapter hook"]
  node_context["Portfolio state"]
  node_defaults["Default content<br/>[defaults.js]"]
  node_storage["Local storage"]
  node_firebaseconfig["Firebase client<br/>[firebase.js]"]
  node_dataindex["Static portfolio data<br/>[index.js]"]
end

node_visitor(("Visitor"))
node_adminuser(("Admin user"))
node_emailjs["EmailJS"]
node_browserstore[("Browser localStorage")]
node_firebase[("Firebase Realtime Database")]

node_visitor -->|"opens site"| node_app
node_adminuser -->|"opens admin"| node_app
node_app -->|"routes home"| node_portfolio
node_app -->|"routes login"| node_login
node_app -->|"guards admin"| node_private
node_private -->|"renders protected"| node_dashboard
node_private -->|"renders protected"| node_settings
node_app -->|"provides state"| node_context
node_portfolio -->|"renders"| node_hero
node_portfolio -->|"renders"| node_about
node_portfolio -->|"renders"| node_skills
node_portfolio -->|"renders"| node_projects
node_portfolio -->|"renders"| node_certifications
node_portfolio -->|"renders"| node_resume
node_portfolio -->|"renders"| node_github
node_portfolio -->|"renders"| node_contact
node_portfolio -->|"renders"| node_footer
node_hero -->|"reads portfolio data"| node_hook
node_about -->|"reads portfolio data"| node_hook
node_skills -->|"reads portfolio data"| node_hook
node_projects -->|"reads portfolio data"| node_hook
node_certifications -->|"reads portfolio data"| node_hook
node_resume -->|"reads portfolio data"| node_hook
node_github -->|"reads portfolio data"| node_hook
node_contact -->|"reads portfolio data"| node_hook
node_hook -->|"consumes state"| node_context
node_contact -->|"sends message"| node_emailjs
node_dashboard -->|"uses portfolio state"| node_context
node_dashboard -->|"imports database client"| node_firebaseconfig
node_login -->|"uses Firebase"| node_firebaseconfig
node_settings -->|"uses Firebase"| node_firebaseconfig
node_context -->|"uses database client"| node_firebaseconfig
node_context -->|"loads and saves"| node_storage
node_context -->|"initializes and resets"| node_defaults
node_storage -->|"merges fallback"| node_defaults
node_storage -->|"reads and writes"| node_browserstore
node_firebaseconfig -->|"initializes connection"| node_firebase
node_context -->|"syncs CMS data"| node_firebase
node_certifications -->|"renders heading"| node_heading
node_about -->|"renders heading"| node_heading
node_skills -->|"renders heading"| node_heading
node_projects -->|"renders heading"| node_heading
node_github -->|"renders heading"| node_heading
node_footer -->|"imports static data"| node_dataindex

click node_app "https://github.com/yashuck18-cloud/portfolio/blob/main/src/App.jsx"
click node_portfolio "https://github.com/yashuck18-cloud/portfolio/blob/main/src/Portfolio.jsx"
click node_hero "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Hero.jsx"
click node_about "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/About.jsx"
click node_skills "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Skills.jsx"
click node_projects "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Projects.jsx"
click node_certifications "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Certifications.jsx"
click node_resume "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Resume.jsx"
click node_github "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Github.jsx"
click node_contact "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Contact.jsx"
click node_footer "https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Footer.jsx"
click node_login "https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/Login.jsx"
click node_private "https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/PrivateRoute.jsx"
click node_dashboard "https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/Dashboard.jsx"
click node_settings "https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/Settings.jsx"
click node_hook "https://github.com/yashuck18-cloud/portfolio/blob/main/src/hooks/usePortfolioData.js"
click node_context "https://github.com/yashuck18-cloud/portfolio/blob/main/src/context/PortfolioContext.jsx"
click node_defaults "https://github.com/yashuck18-cloud/portfolio/blob/main/src/data/defaults.js"
click node_storage "https://github.com/yashuck18-cloud/portfolio/blob/main/src/utils/portfolioStorage.js"
click node_firebaseconfig "https://github.com/yashuck18-cloud/portfolio/blob/main/src/firebase.js"
click node_heading "https://github.com/yashuck18-cloud/portfolio/blob/main/src/components/ui/SectionHeading.jsx"
click node_dataindex "https://github.com/yashuck18-cloud/portfolio/blob/main/src/data/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_adminuser toneBlue
class node_portfolio,node_hero,node_about,node_skills,node_projects,node_certifications,node_resume,node_github,node_contact,node_footer,node_heading,node_browserstore,node_firebase toneAmber
class node_login,node_private,node_dashboard,node_settings toneMint
class node_hook,node_context,node_defaults,node_storage,node_firebaseconfig,node_dataindex toneRose
class node_visitor,node_emailjs toneIndigo
```

## Components

### App routing

- [Route application](https://github.com/yashuck18-cloud/portfolio/blob/main/src/App.jsx): `src/App.jsx`

### Public portfolio

- [Portfolio page](https://github.com/yashuck18-cloud/portfolio/blob/main/src/Portfolio.jsx): `src/Portfolio.jsx`
- [Hero](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Hero.jsx): `src/sections/Hero.jsx`
- [About](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/About.jsx): `src/sections/About.jsx`
- [Skills](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Skills.jsx): `src/sections/Skills.jsx`
- [Projects](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Projects.jsx): `src/sections/Projects.jsx`
- [Certifications](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Certifications.jsx): `src/sections/Certifications.jsx`
- [Resume](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Resume.jsx): `src/sections/Resume.jsx`
- [GitHub section](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Github.jsx): `src/sections/Github.jsx`
- [Contact](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Contact.jsx): `src/sections/Contact.jsx`
- [Footer](https://github.com/yashuck18-cloud/portfolio/blob/main/src/sections/Footer.jsx): `src/sections/Footer.jsx`
- [Section heading](https://github.com/yashuck18-cloud/portfolio/blob/main/src/components/ui/SectionHeading.jsx): `src/components/ui/SectionHeading.jsx`

### Portfolio admin

- [Admin login](https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/Login.jsx): `src/admin/Login.jsx`
- [Private route](https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/PrivateRoute.jsx): `src/admin/PrivateRoute.jsx`
- [CMS dashboard](https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/Dashboard.jsx): `src/admin/Dashboard.jsx`
- [Admin settings](https://github.com/yashuck18-cloud/portfolio/blob/main/src/admin/Settings.jsx): `src/admin/Settings.jsx`

### Portfolio data

- [Data adapter hook](https://github.com/yashuck18-cloud/portfolio/blob/main/src/hooks/usePortfolioData.js): `src/hooks/usePortfolioData.js`
- [Portfolio state](https://github.com/yashuck18-cloud/portfolio/blob/main/src/context/PortfolioContext.jsx): `src/context/PortfolioContext.jsx`
- [Default content](https://github.com/yashuck18-cloud/portfolio/blob/main/src/data/defaults.js): `src/data/defaults.js`
- [Local storage](https://github.com/yashuck18-cloud/portfolio/blob/main/src/utils/portfolioStorage.js): `src/utils/portfolioStorage.js`
- [Firebase client](https://github.com/yashuck18-cloud/portfolio/blob/main/src/firebase.js): `src/firebase.js`
- [Static portfolio data](https://github.com/yashuck18-cloud/portfolio/blob/main/src/data/index.js): `src/data/index.js`

### Other components

- **Visitor**
- **Admin user**
- **EmailJS**
- **Browser localStorage**
- **Firebase Realtime Database**

## Connections

- Visitor → Route application: opens site (evidence: `src/App.jsx`)
- Admin user → Route application: opens admin (evidence: `src/App.jsx`)
- Route application → Portfolio page: routes home (evidence: `src/App.jsx`)
- Route application → Admin login: routes login (evidence: `src/App.jsx`)
- Route application → Private route: guards admin (evidence: `src/App.jsx`)
- Private route → CMS dashboard: renders protected (evidence: `src/App.jsx`)
- Private route → Admin settings: renders protected (evidence: `src/App.jsx`)
- Route application → Portfolio state: provides state (evidence: `src/App.jsx`)
- Portfolio page → Hero: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → About: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → Skills: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → Projects: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → Certifications: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → Resume: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → GitHub section: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → Contact: renders (evidence: `src/Portfolio.jsx`)
- Portfolio page → Footer: renders (evidence: `src/Portfolio.jsx`)
- Hero → Data adapter hook: reads portfolio data (evidence: `src/sections/Hero.jsx`)
- About → Data adapter hook: reads portfolio data (evidence: `src/sections/About.jsx`)
- Skills → Data adapter hook: reads portfolio data (evidence: `src/sections/Skills.jsx`)
- Projects → Data adapter hook: reads portfolio data (evidence: `src/sections/Projects.jsx`)
- Certifications → Data adapter hook: reads portfolio data (evidence: `src/sections/Certifications.jsx`)
- Resume → Data adapter hook: reads portfolio data (evidence: `src/sections/Resume.jsx`)
- GitHub section → Data adapter hook: reads portfolio data (evidence: `src/sections/Github.jsx`)
- Contact → Data adapter hook: reads portfolio data (evidence: `src/sections/Contact.jsx`)
- Data adapter hook → Portfolio state: consumes state (evidence: `src/hooks/usePortfolioData.js`)
- Contact → EmailJS: sends message (evidence: `src/sections/Contact.jsx`)
- CMS dashboard → Portfolio state: uses portfolio state (evidence: `src/admin/Dashboard.jsx`)
- CMS dashboard → Firebase client: imports database client (evidence: `src/admin/Dashboard.jsx`)
- Admin login → Firebase client: uses Firebase (evidence: `src/admin/Login.jsx`)
- Admin settings → Firebase client: uses Firebase (evidence: `src/admin/Settings.jsx`)
- Portfolio state → Firebase client: uses database client (evidence: `src/context/PortfolioContext.jsx`)
- Portfolio state → Local storage: loads and saves (evidence: `src/context/PortfolioContext.jsx`)
- Portfolio state → Default content: initializes and resets (evidence: `src/context/PortfolioContext.jsx`)
- Local storage → Default content: merges fallback (evidence: `src/utils/portfolioStorage.js`)
- Local storage → Browser localStorage: reads and writes (evidence: `src/utils/portfolioStorage.js`)
- Firebase client → Firebase Realtime Database: initializes connection (evidence: `src/firebase.js`)
- Portfolio state → Firebase Realtime Database: syncs CMS data (evidence: `src/context/PortfolioContext.jsx`)
- Certifications → Section heading: renders heading (evidence: `src/sections/Certifications.jsx`)
- About → Section heading: renders heading (evidence: `src/sections/About.jsx`)
- Skills → Section heading: renders heading (evidence: `src/sections/Skills.jsx`)
- Projects → Section heading: renders heading (evidence: `src/sections/Projects.jsx`)
- GitHub section → Section heading: renders heading (evidence: `src/sections/Github.jsx`)
- Footer → Static portfolio data: imports static data (evidence: `src/sections/Footer.jsx`)
