# loxitisstudio/acid-porto architecture

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

- Interactive diagram: https://gitdiagram.com/loxitisstudio/acid-porto
- Repository: https://github.com/loxitisstudio/acid-porto

## Overview

ACID is a personal-branding portfolio with a public creative-services site and an authenticated project dashboard. Visitors browse service and pricing sections, filter portfolio work, open project details, and submit a contact form. The dashboard manages project records and media: browser uploads go to Cloudinary, then project data is persisted in Supabase. The graph reflects documented composition and sampled calls; several page sections and API behaviors are represented from README or index references rather than inspected implementation excerpts.

Main entry points: [`components/BelowFold.tsx`](https://github.com/loxitisstudio/acid-porto/blob/main/components/BelowFold.tsx) (Below Fold), [`lib/projectClient.ts`](https://github.com/loxitisstudio/acid-porto/blob/main/lib/projectClient.ts) (Project Client), [`app/page.tsx`](https://github.com/loxitisstudio/acid-porto/blob/main/app/page.tsx) (Home Page), [`components/Portfolio.tsx`](https://github.com/loxitisstudio/acid-porto/blob/main/components/Portfolio.tsx) (Portfolio Gallery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Public Portfolio"]
  node_home["Home Page<br/>[page.tsx]"]
  node_home_shell["Home Shell<br/>[HomeShell.tsx]"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_services_view["Services<br/>[Services.tsx]"]
  node_pricing["Pricing<br/>[Pricing.tsx]"]
  node_contact["Contact Footer<br/>[Footer.tsx]"]
  node_below_fold["Below Fold<br/>[BelowFold.tsx]"]
end

subgraph group_content["Portfolio Content"]
  node_portfolio["Portfolio Gallery<br/>[Portfolio.tsx]"]
  node_projects_page["All Projects<br/>[page.tsx]"]
  node_project_modal["Project Details<br/>[ProjectModal.tsx]"]
  node_project_data["Project Content<br/>[data.ts]"]
end

subgraph group_admin["Admin Management"]
  node_login["Login Page<br/>[page.tsx]"]
  node_dashboard["Project Dashboard<br/>[page.tsx]"]
  node_project_client["Project Client<br/>[projectClient.ts]"]
end

subgraph group_services["Backend Services"]
  node_auth_routes["Auth Routes<br/>[route.ts]"]
  node_auth_logic["Session Auth<br/>[adminAuth.ts]"]
  node_project_api["Projects API<br/>[route.ts]"]
  node_supabase[("Supabase")]
  node_cloudinary_signature["Upload Signature API<br/>[route.ts]"]
  node_cloudinary[("Cloudinary")]
  node_contact_api["Contact API<br/>[route.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_home
node_home -->|"renders"| node_home_shell
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_below_fold
node_below_fold -->|"renders"| node_about
node_below_fold -->|"renders"| node_skills
node_below_fold -->|"renders"| node_portfolio
node_below_fold -->|"renders"| node_services_view
node_below_fold -->|"renders"| node_pricing
node_below_fold -->|"renders"| node_contact
node_portfolio -->|"loads content"| node_project_data
node_portfolio -->|"fetches projects"| node_project_client
node_portfolio -->|"opens details"| node_project_modal
node_projects_page -->|"fetches projects"| node_project_client
node_projects_page -->|"opens details"| node_project_modal
node_projects_page -->|"uses fallback"| node_project_data
node_project_modal -->|"renders project"| node_project_data
node_visitor -->|"signs in"| node_login
node_login -.->|"authenticates"| node_auth_routes
node_auth_routes -->|"uses session logic"| node_auth_logic
node_visitor -->|"manages work"| node_dashboard
node_dashboard -->|"manages projects"| node_project_client
node_project_client -->|"requests projects"| node_project_api
node_project_api -->|"checks admin session"| node_auth_logic
node_project_api -->|"reads and writes"| node_supabase
node_dashboard -->|"requests signature"| node_cloudinary_signature
node_project_client -->|"uploads media"| node_cloudinary
node_cloudinary_signature -->|"checks admin session"| node_auth_logic
node_dashboard -->|"stores media URL"| node_supabase
node_contact -->|"submits form"| node_contact_api
node_home_shell -.->|"presents experience"| node_visitor

click node_home "https://github.com/loxitisstudio/acid-porto/blob/main/app/page.tsx"
click node_home_shell "https://github.com/loxitisstudio/acid-porto/blob/main/components/HomeShell.tsx"
click node_hero "https://github.com/loxitisstudio/acid-porto/blob/main/components/Hero.tsx"
click node_about "https://github.com/loxitisstudio/acid-porto/blob/main/components/About.tsx"
click node_skills "https://github.com/loxitisstudio/acid-porto/blob/main/components/Skills.tsx"
click node_services_view "https://github.com/loxitisstudio/acid-porto/blob/main/components/Services.tsx"
click node_pricing "https://github.com/loxitisstudio/acid-porto/blob/main/components/Pricing.tsx"
click node_contact "https://github.com/loxitisstudio/acid-porto/blob/main/components/Footer.tsx"
click node_below_fold "https://github.com/loxitisstudio/acid-porto/blob/main/components/BelowFold.tsx"
click node_portfolio "https://github.com/loxitisstudio/acid-porto/blob/main/components/Portfolio.tsx"
click node_projects_page "https://github.com/loxitisstudio/acid-porto/blob/main/app/projects/page.tsx"
click node_project_modal "https://github.com/loxitisstudio/acid-porto/blob/main/components/ProjectModal.tsx"
click node_project_data "https://github.com/loxitisstudio/acid-porto/blob/main/lib/data.ts"
click node_login "https://github.com/loxitisstudio/acid-porto/blob/main/app/login/page.tsx"
click node_dashboard "https://github.com/loxitisstudio/acid-porto/blob/main/app/dashboard/page.tsx"
click node_project_client "https://github.com/loxitisstudio/acid-porto/blob/main/lib/projectClient.ts"
click node_auth_routes "https://github.com/loxitisstudio/acid-porto/blob/main/app/api/auth/login/route.ts"
click node_auth_logic "https://github.com/loxitisstudio/acid-porto/blob/main/lib/adminAuth.ts"
click node_project_api "https://github.com/loxitisstudio/acid-porto/blob/main/app/api/projects/route.ts"
click node_cloudinary_signature "https://github.com/loxitisstudio/acid-porto/blob/main/app/api/cloudinary/signature/route.ts"
click node_contact_api "https://github.com/loxitisstudio/acid-porto/blob/main/app/api/contact/route.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_home,node_home_shell,node_hero,node_about,node_skills,node_services_view,node_pricing,node_contact,node_below_fold toneBlue
class node_portfolio,node_projects_page,node_project_modal,node_project_data toneAmber
class node_login,node_dashboard,node_project_client toneMint
class node_auth_routes,node_auth_logic,node_project_api,node_supabase,node_cloudinary_signature,node_cloudinary,node_contact_api toneRose
class node_visitor toneIndigo
```

## Components

### Public Portfolio

- [Home Page](https://github.com/loxitisstudio/acid-porto/blob/main/app/page.tsx): `app/page.tsx`
- [Home Shell](https://github.com/loxitisstudio/acid-porto/blob/main/components/HomeShell.tsx): `components/HomeShell.tsx`
- [Hero](https://github.com/loxitisstudio/acid-porto/blob/main/components/Hero.tsx): `components/Hero.tsx`
- [About](https://github.com/loxitisstudio/acid-porto/blob/main/components/About.tsx): `components/About.tsx`
- [Skills](https://github.com/loxitisstudio/acid-porto/blob/main/components/Skills.tsx): `components/Skills.tsx`
- [Services](https://github.com/loxitisstudio/acid-porto/blob/main/components/Services.tsx): `components/Services.tsx`
- [Pricing](https://github.com/loxitisstudio/acid-porto/blob/main/components/Pricing.tsx): `components/Pricing.tsx`
- [Contact Footer](https://github.com/loxitisstudio/acid-porto/blob/main/components/Footer.tsx): `components/Footer.tsx`
- [Below Fold](https://github.com/loxitisstudio/acid-porto/blob/main/components/BelowFold.tsx): `components/BelowFold.tsx`

### Portfolio Content

- [Portfolio Gallery](https://github.com/loxitisstudio/acid-porto/blob/main/components/Portfolio.tsx): `components/Portfolio.tsx`
- [All Projects](https://github.com/loxitisstudio/acid-porto/blob/main/app/projects/page.tsx): `app/projects/page.tsx`
- [Project Details](https://github.com/loxitisstudio/acid-porto/blob/main/components/ProjectModal.tsx): `components/ProjectModal.tsx`
- [Project Content](https://github.com/loxitisstudio/acid-porto/blob/main/lib/data.ts): `lib/data.ts`

### Admin Management

- [Login Page](https://github.com/loxitisstudio/acid-porto/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Project Dashboard](https://github.com/loxitisstudio/acid-porto/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Project Client](https://github.com/loxitisstudio/acid-porto/blob/main/lib/projectClient.ts): `lib/projectClient.ts`

### Backend Services

- [Auth Routes](https://github.com/loxitisstudio/acid-porto/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Session Auth](https://github.com/loxitisstudio/acid-porto/blob/main/lib/adminAuth.ts): `lib/adminAuth.ts`
- [Projects API](https://github.com/loxitisstudio/acid-porto/blob/main/app/api/projects/route.ts): `app/api/projects/route.ts`
- **Supabase**
- [Upload Signature API](https://github.com/loxitisstudio/acid-porto/blob/main/app/api/cloudinary/signature/route.ts): `app/api/cloudinary/signature/route.ts`
- **Cloudinary**
- [Contact API](https://github.com/loxitisstudio/acid-porto/blob/main/app/api/contact/route.ts): `app/api/contact/route.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Home Page: visits
- Home Page → Home Shell: renders (evidence: `app/page.tsx`)
- Home Page → Hero: renders (evidence: `app/page.tsx`)
- Home Page → Below Fold: renders (evidence: `app/page.tsx`)
- Below Fold → About: renders (evidence: `components/BelowFold.tsx`)
- Below Fold → Skills: renders (evidence: `components/BelowFold.tsx`)
- Below Fold → Portfolio Gallery: renders (evidence: `components/BelowFold.tsx`)
- Below Fold → Services: renders (evidence: `components/BelowFold.tsx`)
- Below Fold → Pricing: renders (evidence: `components/BelowFold.tsx`)
- Below Fold → Contact Footer: renders (evidence: `components/BelowFold.tsx`)
- Portfolio Gallery → Project Content: loads content (evidence: `components/Portfolio.tsx`)
- Portfolio Gallery → Project Client: fetches projects (evidence: `components/Portfolio.tsx`)
- Portfolio Gallery → Project Details: opens details (evidence: `components/Portfolio.tsx`)
- All Projects → Project Client: fetches projects (evidence: `app/projects/page.tsx`)
- All Projects → Project Details: opens details (evidence: `app/projects/page.tsx`)
- All Projects → Project Content: uses fallback (evidence: `app/projects/page.tsx`)
- Project Details → Project Content: renders project (evidence: `components/ProjectModal.tsx`)
- Visitor → Login Page: signs in
- Login Page → Auth Routes: authenticates
- Auth Routes → Session Auth: uses session logic (evidence: `app/api/auth/login/route.ts`)
- Visitor → Project Dashboard: manages work
- Project Dashboard → Project Client: manages projects (evidence: `app/dashboard/page.tsx`)
- Project Client → Projects API: requests projects (evidence: `lib/projectClient.ts`)
- Projects API → Session Auth: checks admin session (evidence: `app/api/projects/route.ts`)
- Projects API → Supabase: reads and writes (evidence: `app/api/projects/route.ts`)
- Project Dashboard → Upload Signature API: requests signature
- Project Client → Cloudinary: uploads media (evidence: `lib/projectClient.ts`)
- Upload Signature API → Session Auth: checks admin session (evidence: `app/api/cloudinary/signature/route.ts`)
- Project Dashboard → Supabase: stores media URL
- Contact Footer → Contact API: submits form (evidence: `components/Footer.tsx`)
- Home Shell → Visitor: presents experience
