# thecompass-edu/website architecture

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

- Interactive diagram: https://gitdiagram.com/thecompass-edu/website
- Repository: https://github.com/thecompass-edu/website

## Overview

The Compass is a publication site with an editorial admin, article and fun-fact content, newsletter signup, and traffic analytics. Readers browse the homepage and articles; editors manage content through admin pages, while analytics endpoints record visits and article views for dashboard reporting. The graph includes the main publishing and reader-facing stages, plus newsletter confirmation and analytics. Several routes and integrations were not sampled, so those capabilities are represented only where the tree or source index supports them; uncertain links are omitted.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/thecompass-edu/website/blob/main/src/lib/supabase/server.ts) (Server Supabase client), [`src/app/admin/articles`](https://github.com/thecompass-edu/website/tree/main/src/app/admin/articles) (Article management), [`src/app/api/newsletter/confirm/route.ts`](https://github.com/thecompass-edu/website/blob/main/src/app/api/newsletter/confirm/route.ts) (Confirmation endpoint), [`src/sections/home/RecentArticles.tsx`](https://github.com/thecompass-edu/website/blob/main/src/sections/home/RecentArticles.tsx) (Recent articles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reader["Reader experience"]
  node_home["Homepage<br/>[page.tsx]"]
  node_home_sections["Home sections"]
  node_recent_articles["Recent articles<br/>[RecentArticles.tsx]"]
  node_weekly_fact["Weekly fun fact<br/>[WeeklyFunFact.tsx]"]
  node_article_browse["Article listing<br/>[page.tsx]"]
  node_article_detail["Article detail<br/>[page.tsx]"]
end

subgraph group_editorial["Editorial admin"]
  node_admin["Admin dashboard<br/>[page.tsx]"]
  node_article_admin["Article management"]
  node_article_create["Article creation<br/>[page.tsx]"]
  node_article_editor["Article editor<br/>[ArticleEditor.tsx]"]
  node_fact_admin["Fun-fact management"]
  node_visitor_admin["Visitor reports<br/>[page.tsx]"]
end

subgraph group_measurement["Analytics"]
  node_visit_tracker["Visit tracker"]
  node_visit_api["Visit endpoint<br/>[route.ts]"]
  node_article_tracker["Article-view tracker"]
  node_view_api["Article-view endpoint<br/>[route.ts]"]
end

subgraph group_engagement["Newsletter"]
  node_newsletter["Newsletter signup"]
  node_newsletter_action["Signup action<br/>[newsletter.ts]"]
  node_confirm_api["Confirmation endpoint<br/>[route.ts]"]
  node_confirmation_page["Confirmation result<br/>[page.tsx]"]
end

subgraph group_platform["Data and security"]
  node_server_client["Server Supabase client<br/>[server.ts]"]
  node_admin_client["Admin Supabase client<br/>[admin.ts]"]
  node_database[("Supabase data store")]
end

node_reader(("Reader"))

node_reader -.->|"opens"| node_home
node_home -.->|"renders"| node_home_sections
node_home_sections -.->|"includes"| node_recent_articles
node_recent_articles -->|"renders"| node_weekly_fact
node_recent_articles -->|"queries via"| node_server_client
node_article_browse -->|"queries via"| node_server_client
node_article_admin -->|"queries via"| node_server_client
node_article_admin -->|"links to"| node_article_create
node_article_create -->|"loads"| node_article_editor
node_article_create -->|"submits via"| node_server_client
node_article_admin -->|"queries via"| node_server_client
node_admin -->|"queries via"| node_server_client
node_visit_tracker -.->|"posts"| node_visit_api
node_visit_api -->|"uses"| node_admin_client
node_visit_api -->|"reads and writes"| node_database
node_article_tracker -.->|"posts"| node_view_api
node_view_api -->|"uses"| node_admin_client
node_view_api -->|"checks and records"| node_database
node_admin -->|"aggregates data"| node_database
node_visitor_admin -->|"queries via"| node_server_client
node_newsletter -.->|"submits to"| node_newsletter_action
node_newsletter_action -.->|"manages subscribers"| node_database
node_confirm_api -->|"uses"| node_admin_client
node_confirm_api -->|"looks up and updates"| node_database
node_confirm_api -->|"redirects to"| node_confirmation_page

click node_home "https://github.com/thecompass-edu/website/blob/main/src/app/page.tsx"
click node_home_sections "https://github.com/thecompass-edu/website/tree/main/src/sections/home"
click node_recent_articles "https://github.com/thecompass-edu/website/blob/main/src/sections/home/RecentArticles.tsx"
click node_weekly_fact "https://github.com/thecompass-edu/website/blob/main/src/components/home/WeeklyFunFact.tsx"
click node_article_browse "https://github.com/thecompass-edu/website/blob/main/src/app/articles/page.tsx"
click node_article_detail "https://github.com/thecompass-edu/website/blob/main/src/app/articles/%5Bslug%5D/page.tsx"
click node_admin "https://github.com/thecompass-edu/website/blob/main/src/app/admin/page.tsx"
click node_article_admin "https://github.com/thecompass-edu/website/tree/main/src/app/admin/articles"
click node_article_create "https://github.com/thecompass-edu/website/blob/main/src/app/admin/articles/new/page.tsx"
click node_article_editor "https://github.com/thecompass-edu/website/blob/main/src/components/admin/ArticleEditor.tsx"
click node_fact_admin "https://github.com/thecompass-edu/website/tree/main/src/app/admin/fun-facts"
click node_visitor_admin "https://github.com/thecompass-edu/website/blob/main/src/app/admin/visitors/page.tsx"
click node_visit_tracker "https://github.com/thecompass-edu/website/blob/main/src/components/analytics/SiteVisitTracker.tsx"
click node_visit_api "https://github.com/thecompass-edu/website/blob/main/src/app/api/analytics/visit/route.ts"
click node_article_tracker "https://github.com/thecompass-edu/website/blob/main/src/components/analytics/ArticleViewTracker.tsx"
click node_view_api "https://github.com/thecompass-edu/website/blob/main/src/app/api/analytics/article-view/route.ts"
click node_newsletter "https://github.com/thecompass-edu/website/blob/main/src/components/home/NewsletterSignup.tsx"
click node_newsletter_action "https://github.com/thecompass-edu/website/blob/main/src/app/actions/newsletter.ts"
click node_confirm_api "https://github.com/thecompass-edu/website/blob/main/src/app/api/newsletter/confirm/route.ts"
click node_confirmation_page "https://github.com/thecompass-edu/website/blob/main/src/app/newsletter/confirmed/page.tsx"
click node_server_client "https://github.com/thecompass-edu/website/blob/main/src/lib/supabase/server.ts"
click node_admin_client "https://github.com/thecompass-edu/website/blob/main/src/lib/supabase/admin.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_sections,node_recent_articles,node_weekly_fact,node_article_browse,node_article_detail toneBlue
class node_admin,node_article_admin,node_article_create,node_article_editor,node_fact_admin,node_visitor_admin toneAmber
class node_visit_tracker,node_visit_api,node_article_tracker,node_view_api toneMint
class node_newsletter,node_newsletter_action,node_confirm_api,node_confirmation_page toneRose
class node_server_client,node_admin_client,node_database,node_reader toneIndigo
```

## Components

### Reader experience

- [Homepage](https://github.com/thecompass-edu/website/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Home sections](https://github.com/thecompass-edu/website/tree/main/src/sections/home): `src/sections/home`
- [Recent articles](https://github.com/thecompass-edu/website/blob/main/src/sections/home/RecentArticles.tsx): `src/sections/home/RecentArticles.tsx`
- [Weekly fun fact](https://github.com/thecompass-edu/website/blob/main/src/components/home/WeeklyFunFact.tsx): `src/components/home/WeeklyFunFact.tsx`
- [Article listing](https://github.com/thecompass-edu/website/blob/main/src/app/articles/page.tsx): `src/app/articles/page.tsx`
- [Article detail](https://github.com/thecompass-edu/website/blob/main/src/app/articles/%5Bslug%5D/page.tsx): `src/app/articles/[slug]/page.tsx`

### Editorial admin

- [Admin dashboard](https://github.com/thecompass-edu/website/blob/main/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Article management](https://github.com/thecompass-edu/website/tree/main/src/app/admin/articles): `src/app/admin/articles`
- [Article creation](https://github.com/thecompass-edu/website/blob/main/src/app/admin/articles/new/page.tsx): `src/app/admin/articles/new/page.tsx`
- [Article editor](https://github.com/thecompass-edu/website/blob/main/src/components/admin/ArticleEditor.tsx): `src/components/admin/ArticleEditor.tsx`
- [Fun-fact management](https://github.com/thecompass-edu/website/tree/main/src/app/admin/fun-facts): `src/app/admin/fun-facts`
- [Visitor reports](https://github.com/thecompass-edu/website/blob/main/src/app/admin/visitors/page.tsx): `src/app/admin/visitors/page.tsx`

### Analytics

- [Visit tracker](https://github.com/thecompass-edu/website/blob/main/src/components/analytics/SiteVisitTracker.tsx): `src/components/analytics/SiteVisitTracker.tsx`
- [Visit endpoint](https://github.com/thecompass-edu/website/blob/main/src/app/api/analytics/visit/route.ts): `src/app/api/analytics/visit/route.ts`
- [Article-view tracker](https://github.com/thecompass-edu/website/blob/main/src/components/analytics/ArticleViewTracker.tsx): `src/components/analytics/ArticleViewTracker.tsx`
- [Article-view endpoint](https://github.com/thecompass-edu/website/blob/main/src/app/api/analytics/article-view/route.ts): `src/app/api/analytics/article-view/route.ts`

### Newsletter

- [Newsletter signup](https://github.com/thecompass-edu/website/blob/main/src/components/home/NewsletterSignup.tsx): `src/components/home/NewsletterSignup.tsx`
- [Signup action](https://github.com/thecompass-edu/website/blob/main/src/app/actions/newsletter.ts): `src/app/actions/newsletter.ts`
- [Confirmation endpoint](https://github.com/thecompass-edu/website/blob/main/src/app/api/newsletter/confirm/route.ts): `src/app/api/newsletter/confirm/route.ts`
- [Confirmation result](https://github.com/thecompass-edu/website/blob/main/src/app/newsletter/confirmed/page.tsx): `src/app/newsletter/confirmed/page.tsx`

### Data and security

- [Server Supabase client](https://github.com/thecompass-edu/website/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Admin Supabase client](https://github.com/thecompass-edu/website/blob/main/src/lib/supabase/admin.ts): `src/lib/supabase/admin.ts`
- **Supabase data store**

### Other components

- **Reader**

## Connections

- Reader → Homepage: opens
- Homepage → Home sections: renders
- Home sections → Recent articles: includes
- Recent articles → Weekly fun fact: renders (evidence: `src/sections/home/RecentArticles.tsx`)
- Recent articles → Server Supabase client: queries via (evidence: `src/sections/home/RecentArticles.tsx`)
- Article listing → Server Supabase client: queries via (evidence: `src/app/articles/page.tsx`)
- Article management → Server Supabase client: queries via (evidence: `src/app/admin/articles/page.tsx`)
- Article management → Article creation: links to (evidence: `src/app/admin/articles/page.tsx`)
- Article creation → Article editor: loads (evidence: `src/app/admin/articles/new/page.tsx`)
- Article creation → Server Supabase client: submits via
- Article management → Server Supabase client: queries via (evidence: `src/app/admin/articles/page.tsx`)
- Admin dashboard → Server Supabase client: queries via (evidence: `src/app/admin/page.tsx`)
- Visit tracker → Visit endpoint: posts
- Visit endpoint → Admin Supabase client: uses (evidence: `src/app/api/analytics/visit/route.ts`)
- Visit endpoint → Supabase data store: reads and writes (evidence: `src/app/api/analytics/visit/route.ts`)
- Article-view tracker → Article-view endpoint: posts
- Article-view endpoint → Admin Supabase client: uses (evidence: `src/app/api/analytics/article-view/route.ts`)
- Article-view endpoint → Supabase data store: checks and records (evidence: `src/app/api/analytics/article-view/route.ts`)
- Admin dashboard → Supabase data store: aggregates data (evidence: `src/app/admin/page.tsx`)
- Visitor reports → Server Supabase client: queries via (evidence: `src/app/admin/visitors/page.tsx`)
- Newsletter signup → Signup action: submits to
- Signup action → Supabase data store: manages subscribers
- Confirmation endpoint → Admin Supabase client: uses (evidence: `src/app/api/newsletter/confirm/route.ts`)
- Confirmation endpoint → Supabase data store: looks up and updates (evidence: `src/app/api/newsletter/confirm/route.ts`)
- Confirmation endpoint → Confirmation result: redirects to (evidence: `src/app/api/newsletter/confirm/route.ts`)
