Project: SaaS Dashboard

Stack

• Next.js 15 App Router
• Supabase (Auth + DB + Storage)
• Tailwind CSS v4
• Stripe for payments

Commands

• npm run dev - Start dev server
• npm run build - Production build
• npm run db:migrate - Run migrations
• npm run db:seed - Seed database

File Structure

src/
  app/           # Next.js app router pages
  components/    # Reusable UI components
  lib/           # Utilities and configs
  actions/       # Server actions
  hooks/         # Custom React hooks

Rules

• Use server components by default
• Client components only when needed (interactivity)
• All data fetching in server components or server actions
• Use Supabase RLS for authorization
• Never expose service role key to client
• Tailwind for all styling, no CSS modules
• Mobile-first responsive design