Ana Sayfa / Kod ve Scriptler / Launchlist - Referral Waitlist

Launchlist - Referral Waitlist

Launchlist; sıralama tablosu, sahtekârlık işaretleri ve CSV dışa aktarma ile yönlendirme tabanlı bir bekleme listesi yürütür.

  • Yayın tarihi10 Kasım 2026
  • Paket içeriği.css, .html, .ts, .tsx, .json, JavaScript .js
  • Son güncelleme10 Kasım 2026
  • Canlı demoVar
Launchlist - Referral Waitlist

Overview

Get in early. Bring friends.

Launchlist is a self-hosted pre-launch waitlist with a transparent referral loop. People join with an email, share a code, climb five reward tiers, and watch a live leaderboard. The operator gets fraud flags, a review queue, and a CSV that imports straight into an email tool.

What you get

  • Email capture with normalized de-duplication (the original spot is kept)
  • Referral codes and links; direct invites score 10, network joins score 2
  • Five tiers from Waitlist to Founding Partner, with visible thresholds and progress
  • Live public leaderboard with podium, points and cursor pagination
  • Welcome page with code, full invite link, next reward and the invite chain
  • Advisory fraud flags: disposable domain, shared IP, signup burst, hourly rate
  • Admin review queue with one-click clear; flagged accounts are hidden from public proof
  • Mail-ready CSV: fixed columns, UTF-8 + CRLF, formula-injection neutralised
  • Simulated onboarding outbox (wire your own SMTP bridge)
  • React 18 + Vite + TypeScript UI; Express + one atomic JSON file; Docker
  • 106 automated tests, ~99.6% line coverage

Referral rules that are easy to explain

Direct invite: 10 points. Friend-of-a-friend: 2 points per level. Reward tiers follow direct invites so the ladder stays legible; network reach adds rank points on top. Every page shows the same rules.

Set the public URL

Behind a reverse proxy, set PUBLIC_URL=https://launch.example.com (or forward X-Forwarded-Host/X-Forwarded-Proto). The welcome page then shows the real, clickable invite link instead of a localhost address.

Admin and privacy

Set ADMIN_TOKEN to a long random value to protect /admin and the admin APIs. The token is entered once per tab. Email delivery is simulated: the UI and this listing say so. The demo seed is fictional; set SEED_DEMO=0 for a blank list.

Deployment

Docker one-liner or plain Node 20+. The included DEPLOYMENT.md covers Docker install, Node + nvm, systemd, PUBLIC_URL, admin token, Nginx + HTTPS, backup/restore, referral rules, fraud flags, CSV, updating, a troubleshooting table and a browser verification checklist.

Run it

docker compose up -d --build
# http://localhost:31000

Or locally: npm ci && npm run build && PORT=31000 npm start.

API

GET /api/health · GET /api/public/overview · POST /api/signups · GET /api/signups/:code · GET /api/leaderboard · GET /api/admin/overview · GET /api/admin/signups · POST /api/admin/signups/:id/clear-flags · GET /api/admin/export.csv · GET /api/admin/outbox · POST /api/admin/outbox/send

Features

Email capture with normalized de-duplication Referral codes, direct (10 pts) and friend-of-a-friend (2 pts) scoring Five reward tiers with visible thresholds and progress Live public leaderboard with cursor pagination and podium Advisory fraud flags: disposable domain, shared IP, signup burst, rate limit Review queue with one-click clear; hidden from public until cleared Mail-ready CSV: fixed columns, UTF-8 + CRLF, formula-injection safe Simulated outbox for onboarding sequences (wire your own SMTP) React + Node + one JSON store; Docker; no database 106 automated tests, 99.6% line coverage

Requirements

Node.js 20+ (22 recommended) or Docker 24+. No database, no external services. A writable data/ directory. Set PUBLIC_URL (e.g. https://launch.example.com) so invite links use the public host; otherwise the app derives them from X-Forwarded-Host/Host. Set ADMIN_TOKEN to protect /admin and admin APIs (long random value). Set LAUNCH_AT (ISO-8601, e.g. 2027-01-01T18:00:00Z) to your launch timestamp; the shipped default is a demo date. Email sequences are simulated (outbox only). Fraud flags are advisory; the app has no HTTP rate limiter of its own. The demo seed contains fictional signups and three flagged examples; set SEED_DEMO=0 for an empty list.