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
- Read the Configuration guide to customize your waitlist
- Explore the Components overview
- Follow the Deployment guide when you are ready to go live