# vijayaragavaav07-vlsi/vijayaragavaa-protfolio architecture

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

- Interactive diagram: https://gitdiagram.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio
- Repository: https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio

## Overview

This is a data-driven personal portfolio with an administrative CMS. Visitors view portfolio sections and can submit contact messages; administrators manage portfolio content and media. The public app loads live section data through a central hook, falling back to bundled portfolio data when live data is unavailable. Admin CRUD and media upload are distinct management paths. The source excerpts show key calls, but do not expose every route or service implementation, so uncertain links are omitted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/App.tsx) (Portfolio app), [`frontend/src/pages/admin`](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/pages/admin) (Content managers), [`frontend/src/lib/supabase.ts`](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/lib/supabase.ts) (Supabase client), [`frontend/src/hooks/useAdminCRUD.ts`](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/hooks/useAdminCRUD.ts) (Admin CRUD hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public portfolio"]
  node_app["Portfolio app<br/>[App.tsx]"]
  node_hero["Hero section<br/>[Hero.tsx]"]
  node_contact["Contact form<br/>[Contact.tsx]"]
  node_public_sections["Portfolio sections"]
end

subgraph group_admin["Admin CMS"]
  node_admin_pages["Content managers"]
  node_admin_crud["Admin CRUD hook<br/>[useAdminCRUD.ts]"]
  node_auth["Admin authentication<br/>[AuthContext.tsx]"]
  node_admin_widgets["Admin UI controls"]
  node_media_uploader["Media uploader<br/>[MediaUploader.tsx]"]
end

subgraph group_data["Data access"]
  node_static_data["Fallback content<br/>[portfolioData.ts]"]
  node_portfolio_hook["Portfolio loader"]
  node_section_services["Section services"]
  node_storage_service["Media storage service<br/>[storageService.ts]"]
end

subgraph group_shared["Shared infrastructure"]
  node_supabase_client["Supabase client<br/>[supabase.ts]"]
  node_database_types["Database schema types<br/>[database.ts]"]
  node_portfolio_types["Portfolio types<br/>[portfolio.ts]"]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))
node_supabase[("Supabase")]

node_visitor -->|"views"| node_app
node_app -->|"loads live data"| node_portfolio_hook
node_app -->|"uses fallback"| node_static_data
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_public_sections
node_portfolio_hook -->|"fetches sections"| node_section_services
node_admin_user -.->|"manages content"| node_admin_pages
node_admin_pages -->|"creates and updates"| node_admin_crud
node_admin_crud -->|"queries client"| node_supabase_client
node_admin_pages -->|"uses form controls"| node_admin_widgets
node_admin_pages -->|"uses uploader"| node_media_uploader
node_media_uploader -->|"uploads files"| node_storage_service
node_storage_service -->|"uses client"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase

click node_app "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/App.tsx"
click node_hero "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/components/Hero.tsx"
click node_contact "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/components/Contact.tsx"
click node_public_sections "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/components"
click node_static_data "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/data/portfolioData.ts"
click node_portfolio_hook "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/hooks/usePortfolioData.ts"
click node_section_services "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/services"
click node_admin_pages "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/pages/admin"
click node_admin_crud "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/hooks/useAdminCRUD.ts"
click node_auth "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/context/AuthContext.tsx"
click node_admin_widgets "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/components/admin"
click node_media_uploader "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/components/admin/MediaUploader.tsx"
click node_storage_service "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/services/storageService.ts"
click node_supabase_client "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/lib/supabase.ts"
click node_database_types "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/types/database.ts"
click node_portfolio_types "https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/types/portfolio.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_hero,node_contact,node_public_sections toneBlue
class node_admin_pages,node_admin_crud,node_auth,node_admin_widgets,node_media_uploader,node_supabase toneAmber
class node_static_data,node_portfolio_hook,node_section_services,node_storage_service toneMint
class node_supabase_client,node_database_types,node_portfolio_types toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public portfolio

- [Portfolio app](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Hero section](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/components/Hero.tsx): `frontend/src/components/Hero.tsx`
- [Contact form](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/components/Contact.tsx): `frontend/src/components/Contact.tsx`
- [Portfolio sections](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/components): `frontend/src/components`

### Admin CMS

- [Content managers](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Admin CRUD hook](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/hooks/useAdminCRUD.ts): `frontend/src/hooks/useAdminCRUD.ts`
- [Admin authentication](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Admin UI controls](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/components/admin): `frontend/src/components/admin`
- [Media uploader](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/components/admin/MediaUploader.tsx): `frontend/src/components/admin/MediaUploader.tsx`

### Data access

- [Fallback content](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/data/portfolioData.ts): `frontend/src/data/portfolioData.ts`
- [Portfolio loader](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/hooks/usePortfolioData.ts): `frontend/src/hooks/usePortfolioData.ts`
- [Section services](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/tree/main/frontend/src/services): `frontend/src/services`
- [Media storage service](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/services/storageService.ts): `frontend/src/services/storageService.ts`

### Shared infrastructure

- [Supabase client](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/lib/supabase.ts): `frontend/src/lib/supabase.ts`
- [Database schema types](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/types/database.ts): `frontend/src/types/database.ts`
- [Portfolio types](https://github.com/vijayaragavaav07-vlsi/vijayaragavaa-protfolio/blob/main/frontend/src/types/portfolio.ts): `frontend/src/types/portfolio.ts`

### Other components

- **Visitor**
- **Administrator**
- **Supabase**

## Connections

- Visitor → Portfolio app: views (evidence: `frontend/src/App.tsx`)
- Portfolio app → Portfolio loader: loads live data (evidence: `frontend/src/App.tsx`)
- Portfolio app → Fallback content: uses fallback (evidence: `frontend/src/App.tsx`)
- Portfolio app → Hero section: renders (evidence: `frontend/src/App.tsx`)
- Portfolio app → Contact form: renders (evidence: `frontend/src/App.tsx`)
- Portfolio app → Portfolio sections: renders (evidence: `frontend/src/App.tsx`)
- Portfolio loader → Section services: fetches sections (evidence: `frontend/src/hooks/usePortfolioData.ts`)
- Administrator → Content managers: manages content
- Content managers → Admin CRUD hook: creates and updates (evidence: `frontend/src/pages/admin/AboutManager.tsx`)
- Admin CRUD hook → Supabase client: queries client (evidence: `frontend/src/hooks/useAdminCRUD.ts`)
- Content managers → Admin UI controls: uses form controls (evidence: `frontend/src/pages/admin/AboutManager.tsx`)
- Content managers → Media uploader: uses uploader (evidence: `frontend/src/pages/admin/HomeManager.tsx`)
- Media uploader → Media storage service: uploads files (evidence: `frontend/src/components/admin/MediaUploader.tsx`)
- Media storage service → Supabase client: uses client (evidence: `frontend/src/services/storageService.ts`)
- Supabase client → Supabase: connects to (evidence: `frontend/src/lib/supabase.ts`)
