create-new-project

When to use

• Next.js (App Router) + TypeScript
• Tailwind CSS + shadcn/ui
• Supabase (Postgres, Auth, Storage, Realtime)
• Deploy on Vercel
• API routes in Next.js for internal + third-party integrations

What you must ask (minimal)

1. Project name (kebab-case recommended)
2. Package manager: pnpm (default) / npm
3. Supabase mode:
   • "local-first" (init Supabase locally + migrations)
   • "cloud-only" (create env placeholders; user will link later)

• "public API for third-party order creation" yes/no (default: yes)

Execution plan (do this in order)

1. Create the project folder using the script (pick the right OS reminder):
   • macOS/Linux/Git-Bash/WSL:

     bash scripts/create-new-project.sh <name>

   • Windows PowerShell:

     powershell -ExecutionPolicy Bypass -File scripts/create-new-project.ps1 -Name <name>

2. Ensure the scaffold includes:
   • Next.js app (App Router) + Tailwind
   • shadcn/ui initialized
   • Supabase client helpers (server + browser)

   • .env.example

     +

     .env.local

     placeholders (never commit secrets)
   • Supabase migration file with baseline schema for orders/sales (multi-tenant ready)
   • Example API routes:

     • /api/v1/orders

       (authenticated internal)

     • /api/v1/public/orders

       (API key for third-party callers)
3. After generation, run:
   • install deps (if not already)

   • pnpm dev

     (or npm) quick smoke test
   • if Supabase CLI present and local-first:

     supabase init

     and confirm migration file exists
4. Output to the user:
   • what was created (high-level)
   • exact next steps to connect Supabase Cloud + Vercel env vars
   • how to call the public API endpoint from another system

Guardrails

• Do NOT add next-themes/react-day-picker unless versions are compatible with the chosen React/Next baseline.
• Do NOT commit

  .env.local

  , Supabase service role keys, or Vercel tokens.
• Keep the project "boring": simple, predictable, production-ready defaults.

References

• See

  references/STACK.md

  for backend/API model on Vercel + Supabase.
• See

  references/DB_SCHEMA.sql

  for schema + RLS-ready patterns.