# arifaritempus/codeicon architecture

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

- Interactive diagram: https://gitdiagram.com/arifaritempus/codeicon
- Repository: https://github.com/arifaritempus/codeicon

## Overview

This is a Next.js marketing site for CODEICON’s MICE agency system, with an admin content and media management workflow. Visitors receive configurable landing-page sections; administrators authenticate, edit content, and upload/list media. The main page and sampled routes show these entry points and their storage/security helpers. Other landing sections and admin-page internals are retained as product components based on the source index and tree; unsampled internals are not inferred. Supabase Storage and local files are documented in sampled storage code.

Main entry points: [`src/app/page.tsx`](https://github.com/arifaritempus/codeicon/blob/main/src/app/page.tsx) (Landing page), [`src/app/admin/page.tsx`](https://github.com/arifaritempus/codeicon/blob/main/src/app/admin/page.tsx) (Admin console), [`src/lib/contentStore.ts`](https://github.com/arifaritempus/codeicon/blob/main/src/lib/contentStore.ts) (Content and media store), [`src/app/api/upload/route.ts`](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/upload/route.ts) (Media upload endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public website"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_hero["Hero showcase<br/>[Hero.tsx]"]
  node_process["Process steps<br/>[ProcessSteps.tsx]"]
  node_features["Feature tabs<br/>[FeatureTabs.tsx]"]
  node_integrations["Integrations<br/>[Integrations.tsx]"]
  node_pricing["Pricing<br/>[Pricing.tsx]"]
  node_cases["Case studies<br/>[CaseStudies.tsx]"]
  node_faq["FAQ<br/>[Faq.tsx]"]
  node_contact["Contact CTA<br/>[ContactCta.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_scroll["Smooth scrolling<br/>[SmoothScroll.tsx]"]
end

subgraph group_admin["Content administration"]
  node_adminui["Admin console<br/>[page.tsx]"]
end

subgraph group_services["API and services"]
  node_authroutes["Authentication routes<br/>[route.ts]"]
  node_login["Login endpoint<br/>[route.ts]"]
  node_logout["Logout endpoint<br/>[route.ts]"]
  node_check["Session check<br/>[route.ts]"]
  node_auth["Session security<br/>[auth.ts]"]
  node_contentapi["Content endpoint<br/>[route.ts]"]
  node_mediaapi["Media listing endpoint<br/>[route.ts]"]
  node_uploadapi["Media upload endpoint<br/>[route.ts]"]
  node_validation["Image validation<br/>[fileValidation.ts]"]
end

subgraph group_storage["Content and media storage"]
  node_contentstore["Content and media store<br/>[contentStore.ts]"]
  node_supabase[("Supabase Storage")]
  node_localcontent["Local content file<br/>[siteContent.json]"]
  node_uploads[("Local uploads")]
end

node_visitor(("Site visitor"))

node_visitor -->|"requests page"| node_landing
node_landing -->|"loads content"| node_contentstore
node_landing -->|"renders"| node_navbar
node_landing -->|"renders"| node_hero
node_landing -->|"renders"| node_process
node_landing -->|"renders"| node_features
node_landing -->|"renders"| node_integrations
node_landing -->|"renders"| node_pricing
node_landing -->|"renders"| node_cases
node_landing -->|"renders"| node_faq
node_landing -->|"renders"| node_contact
node_landing -->|"renders"| node_footer
node_landing -->|"renders"| node_scroll
node_adminui -.->|"uses login"| node_login
node_adminui -.->|"uses logout"| node_logout
node_adminui -.->|"checks session"| node_check
node_adminui -.->|"edits content"| node_contentapi
node_adminui -.->|"lists media"| node_mediaapi
node_adminui -.->|"uploads media"| node_uploadapi
node_login -->|"validates credentials"| node_auth
node_logout -->|"uses cookie name"| node_auth
node_check -->|"checks session"| node_auth
node_contentapi -->|"checks session"| node_auth
node_contentapi -->|"reads or saves"| node_contentstore
node_mediaapi -->|"lists stored media"| node_contentstore
node_uploadapi -->|"checks session"| node_auth
node_uploadapi -->|"validates image"| node_validation
node_uploadapi -->|"uploads media"| node_contentstore
node_contentstore -->|"reads and writes"| node_supabase
node_contentstore -->|"reads and writes fallback"| node_localcontent
node_uploadapi -->|"writes fallback"| node_uploads
node_mediaapi -->|"lists local files"| node_uploads
node_mediaapi -->|"lists media via store"| node_supabase

click node_landing "https://github.com/arifaritempus/codeicon/blob/main/src/app/page.tsx"
click node_navbar "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Navbar.tsx"
click node_hero "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Hero.tsx"
click node_process "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/ProcessSteps.tsx"
click node_features "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/FeatureTabs.tsx"
click node_integrations "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Integrations.tsx"
click node_pricing "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Pricing.tsx"
click node_cases "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/CaseStudies.tsx"
click node_faq "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Faq.tsx"
click node_contact "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/ContactCta.tsx"
click node_footer "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Footer.tsx"
click node_scroll "https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/SmoothScroll.tsx"
click node_adminui "https://github.com/arifaritempus/codeicon/blob/main/src/app/admin/page.tsx"
click node_authroutes "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/login/route.ts"
click node_login "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/login/route.ts"
click node_logout "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/logout/route.ts"
click node_check "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/check/route.ts"
click node_auth "https://github.com/arifaritempus/codeicon/blob/main/src/lib/auth.ts"
click node_contentapi "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/content/route.ts"
click node_mediaapi "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/media/route.ts"
click node_uploadapi "https://github.com/arifaritempus/codeicon/blob/main/src/app/api/upload/route.ts"
click node_validation "https://github.com/arifaritempus/codeicon/blob/main/src/lib/fileValidation.ts"
click node_contentstore "https://github.com/arifaritempus/codeicon/blob/main/src/lib/contentStore.ts"
click node_localcontent "https://github.com/arifaritempus/codeicon/blob/main/src/data/siteContent.json"
click node_uploads "https://github.com/arifaritempus/codeicon/tree/main/public/uploads"

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_landing,node_navbar,node_hero,node_process,node_features,node_integrations,node_pricing,node_cases,node_faq,node_contact,node_footer,node_scroll toneBlue
class node_adminui toneAmber
class node_authroutes,node_login,node_logout,node_check,node_auth,node_contentapi,node_mediaapi,node_uploadapi,node_validation toneMint
class node_contentstore,node_supabase,node_localcontent,node_uploads toneRose
class node_visitor toneIndigo
```

## Components

### Public website

- [Landing page](https://github.com/arifaritempus/codeicon/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Navigation](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Navbar.tsx): `src/components/grovia/Navbar.tsx`
- [Hero showcase](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Hero.tsx): `src/components/grovia/Hero.tsx`
- [Process steps](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/ProcessSteps.tsx): `src/components/grovia/ProcessSteps.tsx`
- [Feature tabs](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/FeatureTabs.tsx): `src/components/grovia/FeatureTabs.tsx`
- [Integrations](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Integrations.tsx): `src/components/grovia/Integrations.tsx`
- [Pricing](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Pricing.tsx): `src/components/grovia/Pricing.tsx`
- [Case studies](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/CaseStudies.tsx): `src/components/grovia/CaseStudies.tsx`
- [FAQ](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Faq.tsx): `src/components/grovia/Faq.tsx`
- [Contact CTA](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/ContactCta.tsx): `src/components/grovia/ContactCta.tsx`
- [Footer](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/Footer.tsx): `src/components/grovia/Footer.tsx`
- [Smooth scrolling](https://github.com/arifaritempus/codeicon/blob/main/src/components/grovia/SmoothScroll.tsx): `src/components/grovia/SmoothScroll.tsx`

### Content administration

- [Admin console](https://github.com/arifaritempus/codeicon/blob/main/src/app/admin/page.tsx): `src/app/admin/page.tsx`

### API and services

- [Authentication routes](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/login/route.ts): `src/app/api/auth/login/route.ts`
- [Login endpoint](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/login/route.ts): `src/app/api/auth/login/route.ts`
- [Logout endpoint](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/logout/route.ts): `src/app/api/auth/logout/route.ts`
- [Session check](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/auth/check/route.ts): `src/app/api/auth/check/route.ts`
- [Session security](https://github.com/arifaritempus/codeicon/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Content endpoint](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/content/route.ts): `src/app/api/content/route.ts`
- [Media listing endpoint](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/media/route.ts): `src/app/api/media/route.ts`
- [Media upload endpoint](https://github.com/arifaritempus/codeicon/blob/main/src/app/api/upload/route.ts): `src/app/api/upload/route.ts`
- [Image validation](https://github.com/arifaritempus/codeicon/blob/main/src/lib/fileValidation.ts): `src/lib/fileValidation.ts`

### Content and media storage

- [Content and media store](https://github.com/arifaritempus/codeicon/blob/main/src/lib/contentStore.ts): `src/lib/contentStore.ts`
- **Supabase Storage**
- [Local content file](https://github.com/arifaritempus/codeicon/blob/main/src/data/siteContent.json): `src/data/siteContent.json`
- [Local uploads](https://github.com/arifaritempus/codeicon/tree/main/public/uploads): `public/uploads`

### Other components

- **Site visitor**

## Connections

- Site visitor → Landing page: requests page
- Landing page → Content and media store: loads content (evidence: `src/app/page.tsx`)
- Landing page → Navigation: renders (evidence: `src/app/page.tsx`)
- Landing page → Hero showcase: renders (evidence: `src/app/page.tsx`)
- Landing page → Process steps: renders (evidence: `src/app/page.tsx`)
- Landing page → Feature tabs: renders (evidence: `src/app/page.tsx`)
- Landing page → Integrations: renders (evidence: `src/app/page.tsx`)
- Landing page → Pricing: renders (evidence: `src/app/page.tsx`)
- Landing page → Case studies: renders (evidence: `src/app/page.tsx`)
- Landing page → FAQ: renders (evidence: `src/app/page.tsx`)
- Landing page → Contact CTA: renders (evidence: `src/app/page.tsx`)
- Landing page → Footer: renders (evidence: `src/app/page.tsx`)
- Landing page → Smooth scrolling: renders (evidence: `src/app/page.tsx`)
- Admin console → Login endpoint: uses login
- Admin console → Logout endpoint: uses logout
- Admin console → Session check: checks session
- Admin console → Content endpoint: edits content
- Admin console → Media listing endpoint: lists media
- Admin console → Media upload endpoint: uploads media
- Login endpoint → Session security: validates credentials (evidence: `src/app/api/auth/login/route.ts`)
- Logout endpoint → Session security: uses cookie name (evidence: `src/app/api/auth/logout/route.ts`)
- Session check → Session security: checks session (evidence: `src/app/api/auth/check/route.ts`)
- Content endpoint → Session security: checks session (evidence: `src/app/api/content/route.ts`)
- Content endpoint → Content and media store: reads or saves (evidence: `src/app/api/content/route.ts`)
- Media listing endpoint → Content and media store: lists stored media (evidence: `src/app/api/media/route.ts`)
- Media upload endpoint → Session security: checks session (evidence: `src/app/api/upload/route.ts`)
- Media upload endpoint → Image validation: validates image (evidence: `src/app/api/upload/route.ts`)
- Media upload endpoint → Content and media store: uploads media (evidence: `src/app/api/upload/route.ts`)
- Content and media store → Supabase Storage: reads and writes (evidence: `src/lib/contentStore.ts`)
- Content and media store → Local content file: reads and writes fallback (evidence: `src/lib/contentStore.ts`)
- Media upload endpoint → Local uploads: writes fallback (evidence: `src/app/api/upload/route.ts`)
- Media listing endpoint → Local uploads: lists local files (evidence: `src/app/api/media/route.ts`)
- Media listing endpoint → Supabase Storage: lists media via store (evidence: `src/app/api/media/route.ts`)
