⚡ Waitless

Open-source waitlist & launch platform — self-hosted, your own SMTP, zero lock-in.

---

Waitless lets you launch beautiful waitlist pages, collect signups, and manage subscribers — all from a single self-hosted binary. No third-party email lock-in, no monthly fees, no limits.

✨ Features

🚀 Launch Public waitlist pages — branded /w/:slug pages, ready to share Embeddable widget — drop a <script> tag into any website Referral system — unique codes for viral growth Coupon engine — reward early adopters	📊 Manage Analytics dashboard — signup trends, growth metrics, charts Subscriber management — search, filter, sort, bulk actions CSV import/export — migrate data in and out freely Multi-project — unlimited waitlists from one install
📧 Email OAuth email — Gmail & Zoho Mail (OAuth2, no app passwords) Any SMTP — Mailgun, SES, SendGrid, Postmark, self-hosted Professional templates — beautiful HTML welcome emails Custom from name — send as your brand	🔐 Platform REST API — full API with key-based auth for integrations Webhooks — real-time event push to your backend Telegram notifications — get alerted on new signups Admin panel — manage users, projects, platform-wide

📸 Screenshots

Dashboard Analytics · Subscriber Management · Public Waitlist Page

🚀 Quick Start

Docker (Recommended)

git clone https://github.com/Yupcha/waitless
cd waitless
docker compose -f docker/docker-compose.yml up -d

Visit http://localhost:8080 — the first account becomes the admin.

From Source

# Clone
git clone https://github.com/Yupcha/waitless &&cd waitless
# Configure
cp .env.example .env # Edit with your database settings# Build & run (single binary!)
make build
./waitless

Requirements: Go 1.25+, Bun 1.2+, PostgreSQL 16+

Development Mode

make dev-backend # Terminal 1: Go server with hot reload
make dev-frontend # Terminal 2: Vite dev server → proxies to :8080

⚙️ Configuration

Environment Variables

Variable	Description	Default
DATABASE_URL	PostgreSQL connection string	—
PORT	Server port	8080
BASE_URL	Public URL (for OAuth callbacks)	http://localhost:8080
ENCRYPTION_KEY	32-byte key for encrypting tokens at rest	auto-generated

Email Providers

Each project configures its own email from the dashboard.

Provider	Type	Setup
Gmail	OAuth2	One-click connect with Google account
Zoho Mail	OAuth2	One-click connect (supports .in/.com/.eu)
Mailgun	SMTP	smtp.mailgun.org:587
SendGrid	SMTP	smtp.sendgrid.net:587
Amazon SES	SMTP	email-smtp.{region}.amazonaws.com:587
Postmark	SMTP	smtp.postmarkapp.com:587
Any SMTP	SMTP	Your own host & port

OAuth2 Email (Optional)

# Gmail OAuth
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
# Zoho OAuth
ZOHO_CLIENT_ID=your-zoho-client-id
ZOHO_CLIENT_SECRET=your-zoho-client-secret
ZOHO_DOMAIN=zoho.in # or zoho.com, zoho.eu

🔌 REST API

All API endpoints use Bearer token or X-API-Key authentication.

# List subscribers
curl -H "X-API-Key: wl_your_key" \
https://your-domain.com/api/v1/projects/:id/subscribers
# Add subscriber
curl -X POST -H "X-API-Key: wl_your_key" \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","name":"User"}' \
https://your-domain.com/api/v1/projects/:id/subscribers

📖 Full API docs:docs/rest-api-v1.md · docs/public-api.md

🧩 Embeddable Widget

Drop this into any website to show a waitlist signup form:

<divid="waitless-widget"></div><scriptsrc="https://your-domain.com/widget.js"
data-project="your-project-slug"></script>

🏗️ Architecture

./waitless (single binary, ~17MB)
├── Go HTTP server (Chi)
│ ├── /api/auth/* → Auth (register, login, sessions)
│ ├── /api/dashboard/* → Dashboard API (authenticated)
│ ├── /api/admin/* → Admin API (role-gated)
│ ├── /api/v1/* → REST API (API key auth)
│ ├── /api/public/* → Public waitlist API
│ └── /api/oauth/* → OAuth2 callbacks (Gmail, Zoho)
└── Embedded React frontend (TanStack Router)
├── / → Landing page
├── /dashboard → Management UI
├── /docs → API documentation
└── /w/:slug → Public waitlist pages

Tech stack: Go · React 19 · TanStack Router · PostgreSQL · GORM · Recharts

🚢 Deploy

VPS / Bare Metal

make build
scp waitless .env user@server:/opt/waitless/
# On servercd /opt/waitless && ./waitless

Docker

docker compose -f docker/docker-compose.yml up -d

Systemd Service

[Unit]Description=Waitless
After=postgresql.service
[Service]WorkingDirectory=/opt/waitless
ExecStart=/opt/waitless/waitless
Restart=always
[Install]WantedBy=multi-user.target

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

1. Fork the repo
2. Create a branch (git checkout -b feature/amazing)
3. Commit & push
4. Open a Pull Request

📜 License

MIT — see LICENSE

---

_{Built with ❤️ for the open-source community}