Architecture overview

Status: Placeholder. The full original design is at docs/plans/2026-05-10-foreman-design.md in the repo. This page will be carved up from that doc and kept current as each phase lands.

Stack at a glance

• Next.js 16 (App Router) on Vercel
• Self-hosted Supabase (auth, DB, storage, realtime), Cloudflare-tunnelled
• Tailwind CSS v4 + shadcn/ui
• TipTap, @dnd-kit/core, TanStack Query
• Resend for transactional email
• Fumadocs at /docs/*

Topology

Browser → Vercel (Next.js) → Cloudflare Tunnel → Mac Studio → Self-hosted Supabase

Where to read more

Until each section is carved out:

• Data model — see Section 4 of the design doc
• Permissions / RLS — see Section 5
• UI structure — see Section 6
• Notifications — see Section 7
• Realtime — see Section 8