The open-source waitlist platform for founders & developers. Build high-converting waitlist pages, collect emails, and track growth in minutesβnot days.
WaitBee is a production-ready, open-source platform designed to help startup founders, product teams, and developers create and manage viral waitlists for product launches. Built with modern technologies and best practices, WaitBee provides everything you need to validate demand, build community, and grow your user base before launch.
- β‘ Lightning-Fast Setup - Create beautiful waitlist pages in under 60 seconds
- π Privacy-First - Open-source means full transparency and control over your data
- π Powerful Analytics - Track growth, conversions, and user sources in real-time
- π¨ Fully Customizable - Brand it, theme it, deploy it on your own domain
- π Developer-Friendly - API-ready with webhooks, integrations, and data exports
- πΌ For Founders & Teams - Built by founders, for founders scaling from 0 to millions
- Customizable landing pages with your branding
- One-click referral mechanics to drive viral growth
- Mobile-responsive design that works everywhere
- Social proof widgets to increase conversions
- Real-time subscriber tracking and analytics
- Segment and manage your audience
- Track conversion funnels and growth metrics
- Email list exports (CSV) for further analysis
- User-friendly login and password reset flows
- Admin portal for platform management
- Role-based access control
- RESTful API for programmatic access
- Webhook support for real-time events
- Third-party integrations (SendGrid, Stripe, Google Analytics)
- Easy self-hosting and deployment
- Fully customizable color themes and branding
- Custom domain support
- Adjustable CTA messages and copy
- White-label ready
- Node.js 18+ (LTS recommended)
- npm or yarn package manager
- PostgreSQL or compatible database
- Environment variables for API keys (see
.env.example)
-
Clone the repository
git clone https://github.com/chemitha/waitbee.git cd waitbee -
Install dependencies
npm install
-
Configure environment variables
cp .env.example .env.local
Edit
.env.localwith your configuration:DATABASE_URL- PostgreSQL connection stringGEMINI_API_KEY- For AI features (optional)NEXTAUTH_SECRET- For authenticationSENDGRID_API_KEY- For email notifications (optional)
-
Set up the database
npx prisma generate npx prisma migrate dev
-
Run the development server
npm run dev
Open http://localhost:3000 in your browser.
npm run build
npm startnpx verceldocker build -t waitbee .
docker run -p 3000:3000 waitbee- Sign up at
/signupto create your account - Create a waitlist with your product name and description
- Customize the landing page colors, copy, and branding
- Share your unique waitlist link with your audience
- Monitor subscriber growth and analytics in real-time
- Export your email list when ready to launch
# Get waitlist details
GET /api/waitlists/:id
# Subscribe user to waitlist
POST /api/waitlists/:id/subscribe
Content-Type: application/json
{ "email": "user@example.com" }
# Export subscribers (CSV)
GET /api/waitlists/:id/export
# Analytics
GET /api/waitlists/:id/analyticsConfigure webhooks to receive real-time events:
POST /api/webhooks/subscribe
POST /api/webhooks/waitlist-createdBuilt with modern, scalable technologies:
- Frontend: Next.js 15, React, TypeScript, TailwindCSS
- Backend: Next.js API Routes, Node.js
- Database: PostgreSQL with Prisma ORM
- Authentication: NextAuth.js
- Deployment: Vercel, Docker, self-hosted
- Integrations: SendGrid, Stripe, Google Analytics
| Layer | Technology |
|---|---|
| Language | TypeScript (74.8%), CSS (25%), JavaScript (0.2%) |
| Framework | Next.js 15 |
| Styling | TailwindCSS |
| Database | PostgreSQL + Prisma |
| Auth | NextAuth.js |
| Deployment | Vercel, Docker |
We love contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes WaitBee better.
- Fork the repository
- Create a feature branch
git checkout -b feature/your-amazing-feature
- Make your changes and commit with clear messages
git commit -m "Add: Amazing new feature that does X" - Push to your branch
git push origin feature/your-amazing-feature
- Open a Pull Request with a description of your changes
- Follow the existing code style and conventions
- Write tests for new features when appropriate
- Ensure the app builds and runs locally:
npm run dev - Update documentation for user-facing changes
- Keep commits atomic and descriptive
Found a bug? Have a feature request? Open an issue with:
- Clear description of the problem
- Steps to reproduce (if applicable)
- Expected vs. actual behavior
- Your environment details
WaitBee is open-source software licensed under the MIT License.
See the LICENSE file for details.
You're free to use, modify, and distribute WaitBee in your projects, including commercial applications.
- π Documentation: Check our docs
- π Report Issues: GitHub Issues
- π¬ Discussions: GitHub Discussions
- π§ Email: support@waitbee.app
- Mobile app (iOS & Android)
- Advanced AI-powered copy generation
- Multi-language support
- Advanced integrations (Zapier, Make.com)
- Team collaboration features
- Premium hosted version
WaitBee is created and maintained by Chemitha Sathsilu, with contributions from the amazing open-source community.
Special thanks to all our contributors and the amazing open-source community for making this project possible.