Project Plan

Goal
Ship a minimal, reusable wait-list starter that anyone can deploy to Vercel in one click.

0 · Prerequisites

1 · Repo scaffolding

waitlist-kit/ ├─ app/ │ ├─ layout.tsx # global shell + Tailwind │ ├─ page.tsx # landing │ ├─ join/page.tsx # sign-up form (magic link) │ ├─ list/page.tsx # public list of sign-ups │ └─ api/ │ └─ preview/route.ts # (optional) OG-image ├─ lib/ │ └─ supabase.ts # createBrowserClient / createServerClient ├─ public/ │ └─ logo.svg # replaceable brand asset ├─ supabase/ │ ├─ migrations/ │ │ └─ 000_waitlist.sql # table + RLS policy │ └─ config.toml # link migrations ├─ content.json # hero copy, colours, perks cards ├─ tailwind.config.ts ├─ .env.example ├─ vercel.json # runtime opts (edge optional) └─ README.md

Keep editable copy in content.json so deployers tweak text, not TSX.

2 · Database schema (000_waitlist.sql)

create table public.waitlist_signups (
  id         uuid primary key default gen_random_uuid(),
  email      text not null check (email <> ''),
  name       text,
  message    text,
  hidden     boolean default false,
  created_at timestamp with time zone default now()
);
 
alter table public.waitlist_signups
  enable row level security;
 
create policy "Public insert" on public.waitlist_signups
  for insert using (true);

Magic-link e-mail auth works without extra policies.

3 · Core UI flow

1. Landing – reads perks + launch date from content.json.

2. Call-to-action

   • Show Continue with Google only if NEXT_PUBLIC_GOOGLE env-var exists.
   • Always offer Sign up with email (Supabase magic link).

3. Insert to Supabase

   supabase
     .from('waitlist_signups')
     .insert({ email, name, message, hidden });

4. Redirect to /list – fetch with

   select * from waitlist_signups
   order by created_at desc;

   Display as Tailwind card grid; rows #1–40 get a founder badge.

4 · Packaging as a template

5 · Buyer onboarding

1. Click Deploy to Vercel.
2. Authorise Vercel ⇄ Supabase.
3. Wait ~60 s for build.
4. (Optional) Add Google OAuth creds in Supabase → Auth → Providers.
5. Replace public/logo.svg & tweak content.json.
6. Push → redeploy → done.

6 · Optional power-ups

7 · Schedule & owners

≈ 2 focussed energy-flow days.

8 · Risks & mitigations

9 · Next-action checklist

• npx create-next-app@latest waitlist-kit --ts --tailwind
• Add files per § 1
• Paste SQL migration; test (supabase start)
• Wire forms → DB insert
• Push to GitHub; create Vercel project
• Verify one-click deploy flow
• Write README + licence

Everything's captured – paste this file into your repo as PROJECT_PLAN.mdx and start building.