# anusafzal/anus-portfolio architecture

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

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

## Overview

This is a personal portfolio website with a public showcase and a protected admin console. Visitors browse profile, skills, projects, education, and contact details; project records can come from Supabase or static fallback data, while contact inquiries are submitted to an Edge Function. Admins sign in, pass an admin check, and manage projects and contact submissions. The graph follows the shown routing and service calls; unsampled database policies and Edge Function internals are not expanded.

Main entry points: [`src/pages/PublicPortfolio.jsx`](https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/PublicPortfolio.jsx) (Portfolio Page), [`src/App.jsx`](https://github.com/anusafzal/anus-portfolio/blob/main/src/App.jsx) (Application Router), [`src/lib/supabase.js`](https://github.com/anusafzal/anus-portfolio/blob/main/src/lib/supabase.js) (Supabase Client), [`src/data/portfolioData.js`](https://github.com/anusafzal/anus-portfolio/blob/main/src/data/portfolioData.js) (Static Portfolio Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Portfolio"]
  node_app["Application Router<br/>[App.jsx]"]
  node_portfolio["Portfolio Page"]
  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_education["Education<br/>[Education.jsx]"]
  node_contact["Contact Form<br/>[Contact.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_admin["Admin Console"]
  node_adminlogin["Admin Login<br/>[AdminLogin.jsx]"]
  node_protected["Route Guard<br/>[ProtectedRoute.jsx]"]
  node_dashboard["Admin Dashboard<br/>[AdminDashboard.jsx]"]
  node_layout["Admin Layout<br/>[AdminLayout.jsx]"]
end

subgraph group_services["Application Services"]
  node_auth["Auth Provider<br/>[AuthContext.jsx]"]
  node_authhook["Auth Hook<br/>[useAuth.js]"]
  node_projectservice["Project Service<br/>[projectService.js]"]
  node_contactservice["Contact Service<br/>[contactService.js]"]
  node_admincontacts["Contact Admin Service"]
  node_portfoliodata["Static Portfolio Data<br/>[portfolioData.js]"]
  node_supabaseclient["Supabase Client<br/>[supabase.js]"]
end

subgraph group_backend["Supabase Backend"]
  node_database[("Supabase Database")]
  node_edgefunction["Contact Edge Function<br/>[index.ts]"]
end

node_visitor(("Visitor"))
node_administrator(("Administrator"))
node_github(("GitHub"))

node_visitor -->|"opens site"| node_app
node_administrator -->|"opens console"| node_app
node_app -->|"routes to"| node_portfolio
node_app -->|"routes to"| node_adminlogin
node_app -->|"guards admin route"| node_protected
node_protected -->|"renders when allowed"| node_dashboard
node_portfolio -->|"renders"| node_navbar
node_portfolio -->|"renders"| node_hero
node_portfolio -->|"renders"| node_about
node_portfolio -->|"renders"| node_skills
node_portfolio -->|"renders"| node_projects
node_portfolio -->|"renders"| node_education
node_portfolio -->|"renders"| node_contact
node_portfolio -->|"renders"| node_footer
node_hero -->|"reads"| node_portfoliodata
node_about -->|"reads"| node_portfoliodata
node_skills -->|"reads"| node_portfoliodata
node_projects -->|"reads fallback"| node_portfoliodata
node_projects -->|"loads projects"| node_projectservice
node_projects -->|"links repositories"| node_github
node_contact -->|"submits inquiry"| node_contactservice
node_contactservice -->|"posts inquiry"| node_edgefunction
node_adminlogin -->|"uses auth"| node_authhook
node_protected -->|"checks access"| node_authhook
node_layout -->|"uses auth"| node_authhook
node_authhook -->|"reads context"| node_auth
node_app -->|"provides auth"| node_auth
node_auth -->|"authenticates and checks role"| node_supabaseclient
node_projectservice -->|"queries projects"| node_supabaseclient
node_projectservice -->|"falls back to"| node_portfoliodata
node_contactservice -->|"gets function URL"| node_supabaseclient
node_admincontacts -->|"queries contacts"| node_supabaseclient
node_supabaseclient -.->|"accesses"| node_database
node_dashboard -->|"loads and updates contacts"| node_admincontacts
node_dashboard -->|"loads projects"| node_projectservice
node_dashboard -->|"renders within"| node_layout

click node_app "https://github.com/anusafzal/anus-portfolio/blob/main/src/App.jsx"
click node_portfolio "https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/PublicPortfolio.jsx"
click node_hero "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Hero.jsx"
click node_about "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/About.jsx"
click node_skills "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Skills.jsx"
click node_projects "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Projects.jsx"
click node_education "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Education.jsx"
click node_contact "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Contact.jsx"
click node_navbar "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Navbar.jsx"
click node_footer "https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Footer.jsx"
click node_adminlogin "https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/AdminLogin.jsx"
click node_protected "https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/ProtectedRoute.jsx"
click node_dashboard "https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_layout "https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/AdminLayout.jsx"
click node_auth "https://github.com/anusafzal/anus-portfolio/blob/main/src/context/AuthContext.jsx"
click node_authhook "https://github.com/anusafzal/anus-portfolio/blob/main/src/hooks/useAuth.js"
click node_projectservice "https://github.com/anusafzal/anus-portfolio/blob/main/src/services/projectService.js"
click node_contactservice "https://github.com/anusafzal/anus-portfolio/blob/main/src/services/contactService.js"
click node_admincontacts "https://github.com/anusafzal/anus-portfolio/blob/main/src/services/adminContactService.js"
click node_portfoliodata "https://github.com/anusafzal/anus-portfolio/blob/main/src/data/portfolioData.js"
click node_supabaseclient "https://github.com/anusafzal/anus-portfolio/blob/main/src/lib/supabase.js"
click node_edgefunction "https://github.com/anusafzal/anus-portfolio/blob/main/supabase/functions/submit-contact/index.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_app,node_portfolio,node_hero,node_about,node_skills,node_projects,node_education,node_contact,node_navbar,node_footer toneBlue
class node_adminlogin,node_protected,node_dashboard,node_layout toneAmber
class node_auth,node_authhook,node_projectservice,node_contactservice,node_admincontacts,node_portfoliodata,node_supabaseclient toneMint
class node_database,node_edgefunction toneRose
class node_visitor,node_administrator,node_github toneIndigo
```

## Components

### Public Portfolio

- [Application Router](https://github.com/anusafzal/anus-portfolio/blob/main/src/App.jsx): `src/App.jsx`
- [Portfolio Page](https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/PublicPortfolio.jsx): `src/pages/PublicPortfolio.jsx`
- [Hero](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`
- [About](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/About.jsx): `src/components/About.jsx`
- [Skills](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Skills.jsx): `src/components/Skills.jsx`
- [Projects](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Projects.jsx): `src/components/Projects.jsx`
- [Education](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Education.jsx): `src/components/Education.jsx`
- [Contact Form](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Contact.jsx): `src/components/Contact.jsx`
- [Navigation](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Footer](https://github.com/anusafzal/anus-portfolio/blob/main/src/components/Footer.jsx): `src/components/Footer.jsx`

### Admin Console

- [Admin Login](https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/AdminLogin.jsx): `src/pages/admin/AdminLogin.jsx`
- [Route Guard](https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/ProtectedRoute.jsx): `src/pages/admin/ProtectedRoute.jsx`
- [Admin Dashboard](https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Admin Layout](https://github.com/anusafzal/anus-portfolio/blob/main/src/pages/admin/AdminLayout.jsx): `src/pages/admin/AdminLayout.jsx`

### Application Services

- [Auth Provider](https://github.com/anusafzal/anus-portfolio/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Auth Hook](https://github.com/anusafzal/anus-portfolio/blob/main/src/hooks/useAuth.js): `src/hooks/useAuth.js`
- [Project Service](https://github.com/anusafzal/anus-portfolio/blob/main/src/services/projectService.js): `src/services/projectService.js`
- [Contact Service](https://github.com/anusafzal/anus-portfolio/blob/main/src/services/contactService.js): `src/services/contactService.js`
- [Contact Admin Service](https://github.com/anusafzal/anus-portfolio/blob/main/src/services/adminContactService.js): `src/services/adminContactService.js`
- [Static Portfolio Data](https://github.com/anusafzal/anus-portfolio/blob/main/src/data/portfolioData.js): `src/data/portfolioData.js`
- [Supabase Client](https://github.com/anusafzal/anus-portfolio/blob/main/src/lib/supabase.js): `src/lib/supabase.js`

### Supabase Backend

- **Supabase Database**
- [Contact Edge Function](https://github.com/anusafzal/anus-portfolio/blob/main/supabase/functions/submit-contact/index.ts): `supabase/functions/submit-contact/index.ts`

### Other components

- **Visitor**
- **Administrator**
- **GitHub**

## Connections

- Visitor → Application Router: opens site (evidence: `src/App.jsx`)
- Administrator → Application Router: opens console (evidence: `src/App.jsx`)
- Application Router → Portfolio Page: routes to (evidence: `src/App.jsx`)
- Application Router → Admin Login: routes to (evidence: `src/App.jsx`)
- Application Router → Route Guard: guards admin route (evidence: `src/App.jsx`)
- Route Guard → Admin Dashboard: renders when allowed (evidence: `src/App.jsx`)
- Portfolio Page → Navigation: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → Hero: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → About: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → Skills: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → Projects: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → Education: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → Contact Form: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Portfolio Page → Footer: renders (evidence: `src/pages/PublicPortfolio.jsx`)
- Hero → Static Portfolio Data: reads (evidence: `src/components/Hero.jsx`)
- About → Static Portfolio Data: reads (evidence: `src/components/About.jsx`)
- Skills → Static Portfolio Data: reads (evidence: `src/components/Skills.jsx`)
- Projects → Static Portfolio Data: reads fallback (evidence: `src/components/Projects.jsx`)
- Projects → Project Service: loads projects (evidence: `src/components/Projects.jsx`)
- Projects → GitHub: links repositories (evidence: `src/components/Projects.jsx`)
- Contact Form → Contact Service: submits inquiry (evidence: `src/components/Contact.jsx`)
- Contact Service → Contact Edge Function: posts inquiry (evidence: `src/services/contactService.js`)
- Admin Login → Auth Hook: uses auth (evidence: `src/pages/admin/AdminLogin.jsx`)
- Route Guard → Auth Hook: checks access (evidence: `src/pages/admin/ProtectedRoute.jsx`)
- Admin Layout → Auth Hook: uses auth (evidence: `src/pages/admin/AdminLayout.jsx`)
- Auth Hook → Auth Provider: reads context (evidence: `src/hooks/useAuth.js`)
- Application Router → Auth Provider: provides auth (evidence: `src/App.jsx`)
- Auth Provider → Supabase Client: authenticates and checks role (evidence: `src/context/AuthContext.jsx`)
- Project Service → Supabase Client: queries projects (evidence: `src/services/projectService.js`)
- Project Service → Static Portfolio Data: falls back to (evidence: `src/services/projectService.js`)
- Contact Service → Supabase Client: gets function URL (evidence: `src/services/contactService.js`)
- Contact Admin Service → Supabase Client: queries contacts (evidence: `src/services/adminContactService.js`)
- Supabase Client → Supabase Database: accesses
- Admin Dashboard → Contact Admin Service: loads and updates contacts (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Admin Dashboard → Project Service: loads projects (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Admin Dashboard → Admin Layout: renders within (evidence: `src/pages/admin/AdminDashboard.jsx`)
