How thecompass-edu/website works
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: server.ts Server Supabase client · articles Article management · route.ts Confirmation endpoint · RecentArticles.tsx Recent articles
Components 24
Reader experience
- Homepage
src/app/page.tsx - Home sections
src/sections/home - Recent articles
src/sections/home/RecentArticles.tsx - Weekly fun fact
src/components/home/WeeklyFunFact.tsx - Article listing
src/app/articles/page.tsx - Article detail
src/app/articles/[slug]/page.tsx
Editorial admin
- Admin dashboard
src/app/admin/page.tsx - Article management
src/app/admin/articles - Article creation
src/app/admin/articles/new/page.tsx - Article editor
src/components/admin/ArticleEditor.tsx - Fun-fact management
src/app/admin/fun-facts - Visitor reports
src/app/admin/visitors/page.tsx
Analytics
- Visit tracker
src/components/analytics/SiteVisitTracker.tsx - Visit endpoint
src/app/api/analytics/visit/route.ts - Article-view tracker
src/components/analytics/ArticleViewTracker.tsx - Article-view endpoint
src/app/api/analytics/article-view/route.ts
Newsletter
- Newsletter signup
src/components/home/NewsletterSignup.tsx - Signup action
src/app/actions/newsletter.ts - Confirmation endpoint
src/app/api/newsletter/confirm/route.ts - Confirmation result
src/app/newsletter/confirmed/page.tsx
Data and security
- Server Supabase client
src/lib/supabase/server.ts - Admin Supabase client
src/lib/supabase/admin.ts - Supabase data store
Other components
- Reader
Connections 25
- Reader → Homepage: opens
- Homepage → Home sections: renders
- Home sections → Recent articles: includes
- Recent articles → Weekly fun fact: renders
src/sections/home/RecentArticles.tsx - Recent articles → Server Supabase client: queries via
src/sections/home/RecentArticles.tsx - Article listing → Server Supabase client: queries via
src/app/articles/page.tsx - Article management → Server Supabase client: queries via
src/app/admin/articles/page.tsx - Article management → Article creation: links to
src/app/admin/articles/page.tsx - Article creation → Article editor: loads
src/app/admin/articles/new/page.tsx - Article creation → Server Supabase client: submits via
- Article management → Server Supabase client: queries via
src/app/admin/articles/page.tsx - Admin dashboard → Server Supabase client: queries via
src/app/admin/page.tsx - Visit tracker → Visit endpoint: posts
- Visit endpoint → Admin Supabase client: uses
src/app/api/analytics/visit/route.ts - Visit endpoint → Supabase data store: reads and writes
src/app/api/analytics/visit/route.ts - Article-view tracker → Article-view endpoint: posts
- Article-view endpoint → Admin Supabase client: uses
src/app/api/analytics/article-view/route.ts - Article-view endpoint → Supabase data store: checks and records
src/app/api/analytics/article-view/route.ts - Admin dashboard → Supabase data store: aggregates data
src/app/admin/page.tsx - Visitor reports → Server Supabase client: queries via
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
src/app/api/newsletter/confirm/route.ts - Confirmation endpoint → Supabase data store: looks up and updates
src/app/api/newsletter/confirm/route.ts - Confirmation endpoint → Confirmation result: redirects to
src/app/api/newsletter/confirm/route.ts