Getting Started

Get Waveup running locally in under 5 minutes.

What can you build?

Waveup works for any launch that needs a signup list:

  • SaaS & product launches — collect beta testers before launch day
  • E-commerce & limited drops — sneaker releases, limited editions, pre-orders
  • Events & conferences — early-bird RSVPs, VIP access lists
  • Restaurants & hospitality — digital waiting lists, new location openings
  • Real estate — interest lists for new developments and open houses
  • Education & courses — cohort enrollments, workshop signups

Prerequisites

  • Node.js 18+
  • npm or pnpm
  • A Vercel account (for deployment)
  • A Convex account (free tier available)

Quick Start

1. Clone the repository

git clone https://github.com/shiftclaw/waveup.git my-waitlist
cd my-waitlist
npm install

2. Configure your waitlist

Open src/config/site.ts and update the name, tagline, description, and features for your use case — whether it's a product launch, event, restaurant, or anything else.

3. Set up environment variables

Copy the example environment file and fill in your keys:

cp env.example .env.local

You will need API keys from WorkOS, Convex, and Stripe. See the Configuration guide for details.

4. Start the dev server

npm run dev

Open http://localhost:3000 to see your app.

Next Steps