Waitlist

What it is

The Waitlist module gives you a public, conversion-focused landing page at /waitlist where visitors enter their email (and optionally name + referral source) to join your early-access list. Each submission is persisted to the database and triggers a confirmation email.

Use it when you want to:

• Launch a "coming soon" page while building.
• Gate signups behind an approval flow (beta / invite-only).
• Collect demand signal before going public.

How to enable / disable

Enabled by default. Toggle with a single env var — no code changes.

# Disable the public /waitlist page and the admin/waitlist sidebar entry
ENABLE_WAITLIST="false"

When disabled:

• /waitlist returns 404 (via src/proxy.ts).
• The Waitlist link is removed from the marketing navbar.
• The /admin/waitlist link is hidden from the admin sidebar.
• The waitlist URL is removed from sitemap.xml.

Dashboard/admin API routes continue to exist; the flag only controls visibility of UI surfaces.

Where customers find it

• Marketing navbar — a Waitlist link is shown when ENABLE_WAITLIST is on.
• Direct URL — /<locale>/waitlist (indexed in the sitemap).

If you want to route visitors from a "Coming soon" hero instead of the regular pricing page, remove /pricing from the navbar and point the Hero CTA to /waitlist by editing src/components/marketing/Hero.tsx.

Files

Flow

1. Visitor submits the form on /waitlist.
2. joinWaitlist server action validates input with Zod and checks a shared rate limit (waitlist:global, 60 req/min).
3. If the email is new, a row is inserted into waitlist_entry; duplicates return a friendly "already on the list" message.
4. A confirmation email is sent via the Email module (sendEmail). Failures are logged but do not block the response.
5. Admins can review submissions at /admin/waitlist.

i18n

Copy lives under the Waitlist namespace in messages/<locale>.json. Required keys: pageTitle, pageSubtitle, noSpam, plus form/error strings used by WaitlistForm.

Removing the module

If you don't need waitlist at all (not just temporarily disabled), remove it entirely:

1. Delete src/app/[locale]/(marketing)/waitlist/, src/app/[locale]/admin/waitlist/, src/lib/actions/waitlist.ts, src/components/marketing/WaitlistForm.tsx.
2. Drop the waitlist_entry table from src/lib/db/schema.ts and regenerate migrations (pnpm run db:generate).
3. Remove the waitlist entries from src/config/navigation.ts and the blog/waitlist branches in src/proxy.ts, src/app/sitemap.ts, and src/components/marketing/Navbar.tsx.
4. Remove the waitlist flag from env.features in src/lib/config.ts and drop ENABLE_WAITLIST from .env.example.
5. Remove the Waitlist namespace from each messages/<locale>.json.