# lavventurioxx/ponpes-bili architecture

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

- Interactive diagram: https://gitdiagram.com/lavventurioxx/ponpes-bili
- Repository: https://github.com/lavventurioxx/ponpes-bili

## Overview

This is a public website and admissions-management portal for Pondok Pesantren Modern Roudlotul Abror. Visitors explore school, programs, news, and admissions information; prospective students submit an application and check its status, while administrators review applicants and manage student and site content. The sampled code shows Firebase handling authentication and application records, with Supabase Storage used for uploaded documents and images. Several route capabilities are visible only in the file tree, so their internal connections are not asserted.

Main entry points: [`src/app/page.tsx`](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/page.tsx) (Home Page), [`src/lib/firebase.ts`](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/lib/firebase.ts) (Firebase Client), [`src/components/providers/AuthProvider.tsx`](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/providers/AuthProvider.tsx) (Auth Provider), [`src/components/sections/NewsHighlightSection.tsx`](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/NewsHighlightSection.tsx) (News Highlights)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Website"]
  node_home["Home Page<br/>[page.tsx]"]
  node_hero["Hero Section<br/>[HeroSection.tsx]"]
  node_programoverlay["Program Overlay"]
  node_welcome["Welcome Section<br/>[WelcomeSection.tsx]"]
  node_stats["Stats Section<br/>[StatsSection.tsx]"]
  node_programs["Programs Section"]
  node_cta["Admissions CTA<br/>[CTASection.tsx]"]
  node_schoolinfo["School Profiles<br/>[page.tsx]"]
  node_schoolroutes["Other Public Pages"]
end

subgraph group_admissions["Admissions"]
  node_application["Application Form<br/>[page.tsx]"]
  node_status["Application Status<br/>[page.tsx]"]
  node_dashboard["Applicant Dashboard<br/>[page.tsx]"]
end

subgraph group_admin["Administration"]
  node_login["Login<br/>[page.tsx]"]
  node_adminapplicants["Applicant Review<br/>[page.tsx]"]
  node_students["Active Students<br/>[page.tsx]"]
  node_management["Organization Management<br/>[page.tsx]"]
end

subgraph group_content["Content Management"]
  node_news["News Highlights"]
  node_contentroutes["Content Pages<br/>[page.tsx]"]
  node_contenteditor["Content Editor"]
end

subgraph group_services["Backend Services"]
  node_authprovider["Auth Provider<br/>[AuthProvider.tsx]"]
  node_firebase["Firebase Client<br/>[firebase.ts]"]
  node_firestore[("Firestore")]
  node_firebaseauth["Firebase Auth"]
  node_supabaseclient["Supabase Storage Client<br/>[supabase.ts]"]
  node_supabasestorage[("Supabase Storage")]
end

node_visitor(("Visitor"))

node_visitor -.->|"visits"| node_home
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_programoverlay
node_home -->|"renders"| node_welcome
node_home -->|"renders"| node_stats
node_home -->|"renders"| node_programs
node_home -->|"renders"| node_cta
node_home -->|"renders"| node_news
node_application -->|"uploads documents"| node_supabaseclient
node_application -->|"writes application"| node_firestore
node_status -->|"reads status"| node_firebase
node_dashboard -->|"checks session"| node_authprovider
node_dashboard -->|"reads application"| node_firestore
node_login -->|"uses auth state"| node_authprovider
node_authprovider -->|"observes session"| node_firebaseauth
node_authprovider -->|"checks admin"| node_firestore
node_adminapplicants -->|"checks access"| node_authprovider
node_adminapplicants -->|"reads and updates"| node_firebase
node_students -->|"reads and updates"| node_firebase
node_management -->|"reads and saves"| node_firebase
node_news -->|"opens editor"| node_contenteditor
node_news -->|"reads and saves"| node_firestore
node_news -->|"uploads thumbnails"| node_supabaseclient
node_firebase -->|"initializes"| node_firestore
node_firebase -->|"initializes"| node_firebaseauth
node_supabaseclient -->|"uploads objects"| node_supabasestorage
node_schoolinfo -->|"reads content"| node_firebase

click node_home "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/page.tsx"
click node_hero "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/HeroSection.tsx"
click node_programoverlay "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/ProgramOverlaySection.tsx"
click node_welcome "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/WelcomeSection.tsx"
click node_stats "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/StatsSection.tsx"
click node_programs "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/ProgramsSection.tsx"
click node_cta "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/CTASection.tsx"
click node_news "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/NewsHighlightSection.tsx"
click node_schoolinfo "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/profil/sekolah/page.tsx"
click node_schoolroutes "https://github.com/lavventurioxx/ponpes-bili/tree/main/src/app"
click node_application "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/penerimaan-santri-baru/daftar/page.tsx"
click node_status "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/penerimaan-santri-baru/status/page.tsx"
click node_dashboard "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/dashboard/page.tsx"
click node_login "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/login/page.tsx"
click node_authprovider "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/providers/AuthProvider.tsx"
click node_adminapplicants "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/admin/page.tsx"
click node_students "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/admin/data-santri/page.tsx"
click node_management "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/profil/pengurus/page.tsx"
click node_contentroutes "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/informasi/berita/page.tsx"
click node_contenteditor "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/ui/AdminContentEditor.tsx"
click node_firebase "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/lib/firebase.ts"
click node_supabaseclient "https://github.com/lavventurioxx/ponpes-bili/blob/main/src/lib/supabase.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_hero,node_programoverlay,node_welcome,node_stats,node_programs,node_cta,node_schoolinfo,node_schoolroutes toneBlue
class node_application,node_status,node_dashboard toneAmber
class node_login,node_adminapplicants,node_students,node_management toneMint
class node_news,node_contentroutes,node_contenteditor toneRose
class node_authprovider,node_firebase,node_firestore,node_firebaseauth,node_supabaseclient,node_supabasestorage,node_visitor toneIndigo
```

## Components

### Public Website

- [Home Page](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Hero Section](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/HeroSection.tsx): `src/components/sections/HeroSection.tsx`
- [Program Overlay](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/ProgramOverlaySection.tsx): `src/components/sections/ProgramOverlaySection.tsx`
- [Welcome Section](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/WelcomeSection.tsx): `src/components/sections/WelcomeSection.tsx`
- [Stats Section](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/StatsSection.tsx): `src/components/sections/StatsSection.tsx`
- [Programs Section](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/ProgramsSection.tsx): `src/components/sections/ProgramsSection.tsx`
- [Admissions CTA](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/CTASection.tsx): `src/components/sections/CTASection.tsx`
- [School Profiles](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/profil/sekolah/page.tsx): `src/app/profil/sekolah/page.tsx`
- [Other Public Pages](https://github.com/lavventurioxx/ponpes-bili/tree/main/src/app): `src/app`

### Admissions

- [Application Form](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/penerimaan-santri-baru/daftar/page.tsx): `src/app/penerimaan-santri-baru/daftar/page.tsx`
- [Application Status](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/penerimaan-santri-baru/status/page.tsx): `src/app/penerimaan-santri-baru/status/page.tsx`
- [Applicant Dashboard](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`

### Administration

- [Login](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Applicant Review](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Active Students](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/admin/data-santri/page.tsx): `src/app/admin/data-santri/page.tsx`
- [Organization Management](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/profil/pengurus/page.tsx): `src/app/profil/pengurus/page.tsx`

### Content Management

- [News Highlights](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/sections/NewsHighlightSection.tsx): `src/components/sections/NewsHighlightSection.tsx`
- [Content Pages](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/app/informasi/berita/page.tsx): `src/app/informasi/berita/page.tsx`
- [Content Editor](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/ui/AdminContentEditor.tsx): `src/components/ui/AdminContentEditor.tsx`

### Backend Services

- [Auth Provider](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/components/providers/AuthProvider.tsx): `src/components/providers/AuthProvider.tsx`
- [Firebase Client](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- **Firestore**
- **Firebase Auth**
- [Supabase Storage Client](https://github.com/lavventurioxx/ponpes-bili/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- **Supabase Storage**

### Other components

- **Visitor**

## Connections

- Visitor → Home Page: visits
- Home Page → Hero Section: renders (evidence: `src/app/page.tsx`)
- Home Page → Program Overlay: renders (evidence: `src/app/page.tsx`)
- Home Page → Welcome Section: renders (evidence: `src/app/page.tsx`)
- Home Page → Stats Section: renders (evidence: `src/app/page.tsx`)
- Home Page → Programs Section: renders (evidence: `src/app/page.tsx`)
- Home Page → Admissions CTA: renders (evidence: `src/app/page.tsx`)
- Home Page → News Highlights: renders (evidence: `src/app/page.tsx`)
- Application Form → Supabase Storage Client: uploads documents (evidence: `src/app/penerimaan-santri-baru/daftar/page.tsx`)
- Application Form → Firestore: writes application (evidence: `src/app/penerimaan-santri-baru/daftar/page.tsx`)
- Application Status → Firebase Client: reads status (evidence: `src/app/penerimaan-santri-baru/status/page.tsx`)
- Applicant Dashboard → Auth Provider: checks session (evidence: `src/app/dashboard/page.tsx`)
- Applicant Dashboard → Firestore: reads application (evidence: `src/app/dashboard/page.tsx`)
- Login → Auth Provider: uses auth state (evidence: `src/app/login/page.tsx`)
- Auth Provider → Firebase Auth: observes session (evidence: `src/components/providers/AuthProvider.tsx`)
- Auth Provider → Firestore: checks admin (evidence: `src/components/providers/AuthProvider.tsx`)
- Applicant Review → Auth Provider: checks access (evidence: `src/app/admin/page.tsx`)
- Applicant Review → Firebase Client: reads and updates (evidence: `src/app/admin/page.tsx`)
- Active Students → Firebase Client: reads and updates (evidence: `src/app/admin/data-santri/page.tsx`)
- Organization Management → Firebase Client: reads and saves (evidence: `src/app/profil/pengurus/page.tsx`)
- News Highlights → Content Editor: opens editor (evidence: `src/components/sections/NewsHighlightSection.tsx`)
- News Highlights → Firestore: reads and saves (evidence: `src/components/sections/NewsHighlightSection.tsx`)
- News Highlights → Supabase Storage Client: uploads thumbnails (evidence: `src/components/sections/NewsHighlightSection.tsx`)
- Firebase Client → Firestore: initializes (evidence: `src/lib/firebase.ts`)
- Firebase Client → Firebase Auth: initializes (evidence: `src/lib/firebase.ts`)
- Supabase Storage Client → Supabase Storage: uploads objects (evidence: `src/lib/supabase.ts`)
- School Profiles → Firebase Client: reads content (evidence: `src/app/profil/sekolah/page.tsx`)
