How luak-leuven/luak-website works
Project Type and Purpose
• This is a full‑stack, content‑driven website (LUAK) built with Nuxt 3 for the frontend/SSR, Nuxt Content for markdown pages, TailwindCSS + DaisyUI for styling, and Supabase as a serverless backend (Postgres DB, Auth, Edge Functions). It’s deployed on Vercel.
File Structure Analysis
• Top‑level “pages”, “components”, “layouts”, “assets” – standard Nuxt 3 directory for routing, UI, and static assets.
• “content” holds markdown under subfolders (activities, info, news, pages, stories) consumed by @nuxt/content.
• “supabase” folder contains:
• “migrations” (SQL schema changes)
• “seed.sql” (initial data)
• “functions” (TypeScript edge functions living in Supabase for webhooks, CORS/shared utilities, Stripe integration).
• Config and build scripts: nuxt.config.ts, tailwind.config.js, tsconfig.json, .env.example, .devcontainer, Docker/VSCode setup.
README Insights
• Emphasizes tech stack, use of VSCode Dev Container or Codespaces, environment variables for Supabase, and Vercel deployment.
a. Main Components
• Browser / Client UI (Nuxt 3 pages + components)
• Nuxt Server (SSR / SSG on Vercel) + @nuxt/content engine
• Supabase Backend
– Postgres Database
– Auth service
– Edge Functions (Stripe webhook, other server‑side logic)
• External Services: Stripe (payment), Vercel CDN
• Content repository (local markdown files)
b. Interactions
– Browser ↔️ Nuxt Server via HTTP/HTTPS (SSR or fetch calls)
– Nuxt Server (or client) ↔️ Supabase Client SDK for Auth, CRUD, real‑time
– Stripe → Supabase Edge Function (webhook) → Postgres
– CI/CD (GitHub → Vercel) deploying code + static assets
c. Architectural Patterns
– Jamstack/SSR hybrid: static content + server‑side rendering for dynamic pages
– Serverless functions for payment/webhooks
– Content‑driven routing (markdown file → route)
– Modular Vue component-based UI
d. Key Technologies
– Frontend: Nuxt 3, Vue 3, TailwindCSS + DaisyUI
– Content: @nuxt/content reading markdown under “content/”
– Backend: Supabase (Postgres, Auth, Edge Functions in TypeScript)
– Deployment: Vercel (SSR + static hosting)
– Dev: Docker / VSCode Dev Container, TypeScript, ESLint, Prettier