Fast, free, and forever yours.
Deploy your own waitlist to Cloudflare Workers in minutes.

Website • Documentation • Getting Started • API Reference

---

Quick Start

npx create-0list

The CLI will guide you through:

1. Creating your project
2. Setting up Cloudflare D1 database
3. Running migrations
4. Starting the dev server

That's it. Your waitlist is ready.

Other package managers

# pnpm
pnpm create 0list

# bun
bun create 0list

# yarn
yarn create 0list

Why 0list?

Most waitlist solutions are SaaS products that charge per signup, lock you into their platform, and store your user data on their servers.

0list is different:

Feature	0list	Typical SaaS
Cost	Free forever	$29-99/mo
Data ownership	100% yours	Their servers
Vendor lock-in	None	High
Customization	Full source access	Limited
Performance	Edge (300+ locations)	Single region

Features

Core

• Edge-native — Runs on Cloudflare Workers in 300+ locations worldwide. Sub-50ms response times globally.
• D1 Database — SQLite at the edge. No external database to provision, manage, or pay for.
• Self-hosted — Deploy to your own Cloudflare account. Your data never touches third-party servers.
• Open source — MIT licensed. Fork it, modify it, make it yours.

Admin Dashboard

• Real-time analytics — Track signups, confirmations, and conversion rates
• Traffic sources — See where your signups are coming from with UTM tracking
• Multiple waitlists — Manage unlimited waitlists from one dashboard
• Export data — Download your signups as CSV anytime

Email & Integrations

• Double opt-in — Optional email confirmation to verify signups
• Custom templates — Fully customizable email templates with React Email
• Transport chain — Cloudflare Email Sending, SMTP (works with Amazon SES), or the Gmail API, with config-driven failover (see apps/api/EMAIL.md)
• Campaigns — Code-defined React Email campaigns with a no-code lifecycle: preview, test-send, idempotent batched launch, and stats from the dashboard or CLI (see apps/api/CAMPAIGNS.md)
• Tracking & unsubscribe — Self-hosted open/click tracking and one-click unsubscribe with List-Unsubscribe headers
• Sealed config — Per-list identity/transport/notification config in versioned JSONC; secrets encrypted in place (enc:v1:), unlocked by a single worker secret (see apps/api/CONFIG.md)
• Discord notifications — Per-list signup pings via webhook
• REST API — Full API for custom integrations and workflows

Security

• Cloudflare Access — Protect your admin dashboard with zero-trust authentication
• Rate limiting — Built-in protection against abuse
• No tracking — No analytics, no cookies, no third-party scripts

Project Structure

├── apps/
│   ├── api/          # Hono backend (Cloudflare Workers)
│   ├── web/          # React admin dashboard
│   ├── www/          # Marketing website (Astro)
│   └── public/       # Embeddable signup widget
├── packages/
│   └── create-0list/ # CLI scaffolding tool

Documentation

Guide	Description
Getting Started	Deploy your first waitlist in 5 minutes
Configuration	Environment variables and settings
API Reference	REST API documentation
Email Templates	Customize confirmation emails
Cloudflare Access	Secure your admin dashboard

Development

# Clone the repo
git clone https://github.com/d4mr/0list.git
cd 0list

# Install dependencies
bun install

# Set up local D1 database
bun run db:migrate:local

# Start dev server
bun dev

The dev server runs:

• API at http://localhost:8787
• Admin dashboard at http://localhost:5173
• Marketing site at http://localhost:4321

Deployment

# Deploy to Cloudflare Workers
bun run deploy

See the deployment guide for detailed instructions.

Staying Updated

0list is designed to receive updates easily. When you scaffold with create-0list, the upstream remote is configured automatically:

# Pull latest updates
git pull upstream main

# Resolve any conflicts, then deploy
bun run deploy

Tech Stack

• Runtime: Cloudflare Workers
• Database: Cloudflare D1 (SQLite)
• Backend: Hono
• Frontend: React + Vite
• ORM: Drizzle
• Emails: React Email over Cloudflare Email Sending / SMTP (SES-compatible) / Gmail API
• Marketing: Astro

Contributing

Contributions are welcome! Please read the contributing guidelines before submitting a PR.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT © d4mr

---

_{Built with 🧡 for the Cloudflare ecosystem}