# spidey-cloud/portfolio2.0 architecture

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

- Interactive diagram: https://gitdiagram.com/spidey-cloud/portfolio2.0
- Repository: https://github.com/spidey-cloud/portfolio2.0

## Overview

This is a React portfolio with a public showcase, meeting-request flow, and separately routed admin interface for authentication and content management. The visible frontend entry point selects the portfolio or admin view; showcase sections render portfolio content, while admin edits use storage helpers that call the backend API. The README documents backend booking, Supabase persistence, email notifications, and scheduling features, but backend source is absent from the supplied tree. Those backend integrations are shown as documented or unverified rather than inferred from unseen code.

Main entry points: [`src/App.tsx`](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/App.tsx) (App routing), [`src/lib/storage.ts`](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/storage.ts) (Portfolio storage), [`src/components/AdminPanel.tsx`](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/AdminPanel.tsx) (Admin panel), [`src/components/BookCall.tsx`](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/BookCall.tsx) (Meeting booking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_showcase["Portfolio showcase"]
  node_app["App routing<br/>[App.tsx]"]
  node_nav["Navigation<br/>[Navbar.tsx]"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_about["About and resume<br/>[About.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_projects["Projects<br/>[Projects.tsx]"]
  node_testimonials["Testimonials<br/>[Testimonials.tsx]"]
  node_music["Music<br/>[MusicSection.tsx]"]
  node_booking["Meeting booking<br/>[BookCall.tsx]"]
  node_footer["Footer and social<br/>[Footer.tsx]"]
  node_mouse["Canvas background"]
end

subgraph group_admin["Admin management"]
  node_admin_page["Admin page<br/>[AdminPage.tsx]"]
  node_admin_panel["Admin panel<br/>[AdminPanel.tsx]"]
  node_totp["TOTP authentication<br/>[totp.ts]"]
end

subgraph group_shared["Shared frontend services"]
  node_toast["Notifications<br/>[Toast.tsx]"]
  node_storage["Portfolio storage<br/>[storage.ts]"]
  node_validation["Input validation<br/>[validate.ts]"]
  node_portfolio_data["Default content<br/>[data.ts]"]
end

subgraph group_backend["Backend services"]
  node_backend_api["Express API"]
  node_supabase[("Supabase")]
  node_email["Email service"]
end

node_visitor(("Visitor"))
node_admin_user(("Admin user"))

node_visitor -->|"opens site"| node_app
node_admin_user -->|"opens admin"| node_app
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_testimonials
node_app -->|"renders"| node_music
node_app -->|"renders"| node_booking
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_mouse
node_app -->|"routes to"| node_admin_page
node_app -->|"renders"| node_toast
node_admin_page -->|"renders"| node_admin_panel
node_admin_panel -->|"saves content"| node_storage
node_admin_panel -->|"authenticates with"| node_totp
node_admin_panel -->|"shows feedback"| node_toast
node_admin_panel -->|"validates inputs"| node_validation
node_booking -->|"tracks activity"| node_storage
node_booking -->|"sanitizes input"| node_validation
node_about -->|"loads content"| node_storage
node_about -->|"opens resume"| node_about
node_footer -->|"tracks activity"| node_storage
node_footer -->|"renders social links"| node_footer
node_hero -->|"loads content"| node_storage
node_skills -->|"loads content"| node_storage
node_projects -->|"loads content"| node_storage
node_music -->|"loads content"| node_storage
node_testimonials -->|"reads defaults"| node_portfolio_data
node_storage -->|"sanitizes data"| node_validation
node_storage -->|"uses defaults"| node_portfolio_data
node_storage -->|"calls REST API"| node_backend_api
node_backend_api -.->|"persists records"| node_supabase
node_backend_api -.->|"sends notifications"| node_email
node_booking -.->|"submits requests"| node_backend_api

click node_app "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/App.tsx"
click node_nav "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Navbar.tsx"
click node_hero "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Hero.tsx"
click node_about "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/About.tsx"
click node_skills "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Skills.tsx"
click node_projects "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Projects.tsx"
click node_testimonials "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Testimonials.tsx"
click node_music "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/MusicSection.tsx"
click node_booking "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/BookCall.tsx"
click node_footer "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Footer.tsx"
click node_mouse "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/MouseEffectBackground.tsx"
click node_admin_page "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/pages/AdminPage.tsx"
click node_admin_panel "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/AdminPanel.tsx"
click node_totp "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/totp.ts"
click node_toast "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Toast.tsx"
click node_storage "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/storage.ts"
click node_validation "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/validate.ts"
click node_portfolio_data "https://github.com/spidey-cloud/portfolio2.0/blob/main/src/data.ts"
click node_backend_api "https://github.com/spidey-cloud/portfolio2.0/tree/main/backend"

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_nav,node_hero,node_about,node_skills,node_projects,node_testimonials,node_music,node_booking,node_footer,node_mouse,node_admin_user toneBlue
class node_admin_page,node_admin_panel,node_totp toneAmber
class node_toast,node_storage,node_validation,node_portfolio_data toneMint
class node_backend_api,node_supabase,node_email toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio showcase

- [App routing](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Hero](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [About and resume](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Skills](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Skills.tsx): `src/components/Skills.tsx`
- [Projects](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Projects.tsx): `src/components/Projects.tsx`
- [Testimonials](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Testimonials.tsx): `src/components/Testimonials.tsx`
- [Music](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/MusicSection.tsx): `src/components/MusicSection.tsx`
- [Meeting booking](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/BookCall.tsx): `src/components/BookCall.tsx`
- [Footer and social](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Canvas background](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/MouseEffectBackground.tsx): `src/components/MouseEffectBackground.tsx`

### Admin management

- [Admin page](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/pages/AdminPage.tsx): `src/pages/AdminPage.tsx`
- [Admin panel](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/AdminPanel.tsx): `src/components/AdminPanel.tsx`
- [TOTP authentication](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/totp.ts): `src/lib/totp.ts`

### Shared frontend services

- [Notifications](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/components/Toast.tsx): `src/components/Toast.tsx`
- [Portfolio storage](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Input validation](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/lib/validate.ts): `src/lib/validate.ts`
- [Default content](https://github.com/spidey-cloud/portfolio2.0/blob/main/src/data.ts): `src/data.ts`

### Backend services

- [Express API](https://github.com/spidey-cloud/portfolio2.0/tree/main/backend): `backend`
- **Supabase**
- **Email service**

### Other components

- **Visitor**
- **Admin user**

## Connections

- Visitor → App routing: opens site (evidence: `README.md`)
- Admin user → App routing: opens admin (evidence: `README.md`)
- App routing → Navigation: renders (evidence: `src/App.tsx`)
- App routing → Hero: renders (evidence: `src/App.tsx`)
- App routing → About and resume: renders (evidence: `src/App.tsx`)
- App routing → Skills: renders (evidence: `src/App.tsx`)
- App routing → Projects: renders (evidence: `src/App.tsx`)
- App routing → Testimonials: renders (evidence: `src/App.tsx`)
- App routing → Music: renders (evidence: `src/App.tsx`)
- App routing → Meeting booking: renders (evidence: `src/App.tsx`)
- App routing → Footer and social: renders (evidence: `src/App.tsx`)
- App routing → Canvas background: renders (evidence: `src/App.tsx`)
- App routing → Admin page: routes to (evidence: `src/App.tsx`)
- App routing → Notifications: renders (evidence: `src/App.tsx`)
- Admin page → Admin panel: renders (evidence: `src/pages/AdminPage.tsx`)
- Admin panel → Portfolio storage: saves content (evidence: `src/components/AdminPanel.tsx`)
- Admin panel → TOTP authentication: authenticates with (evidence: `src/components/AdminPanel.tsx`)
- Admin panel → Notifications: shows feedback (evidence: `src/components/AdminPanel.tsx`)
- Admin panel → Input validation: validates inputs (evidence: `src/components/AdminPanel.tsx`)
- Meeting booking → Portfolio storage: tracks activity (evidence: `src/components/BookCall.tsx`)
- Meeting booking → Input validation: sanitizes input (evidence: `src/components/BookCall.tsx`)
- About and resume → Portfolio storage: loads content (evidence: `src/components/About.tsx`)
- About and resume → About and resume: opens resume (evidence: `src/components/About.tsx`)
- Footer and social → Portfolio storage: tracks activity (evidence: `src/components/Footer.tsx`)
- Footer and social → Footer and social: renders social links (evidence: `src/components/Footer.tsx`)
- Hero → Portfolio storage: loads content (evidence: `src/components/Hero.tsx`)
- Skills → Portfolio storage: loads content (evidence: `src/components/Skills.tsx`)
- Projects → Portfolio storage: loads content (evidence: `src/components/Projects.tsx`)
- Music → Portfolio storage: loads content (evidence: `src/components/MusicSection.tsx`)
- Testimonials → Default content: reads defaults (evidence: `src/components/Testimonials.tsx`)
- Portfolio storage → Input validation: sanitizes data (evidence: `src/lib/storage.ts`)
- Portfolio storage → Default content: uses defaults (evidence: `src/lib/storage.ts`)
- Portfolio storage → Express API: calls REST API (evidence: `src/lib/storage.ts`)
- Express API → Supabase: persists records (evidence: `README.md`)
- Express API → Email service: sends notifications (evidence: `README.md`)
- Meeting booking → Express API: submits requests
