Digital queues for campus services, clinics, and small businesses.
Customers join from a phone, watch their position, and get called when it is their turn. Staff run a PIN-protected operator dashboard with capacity limits, rolling ETA stats, and history export.
QueueLess is a lightweight queue system on Cloudflare Workers + Durable Objects — no D1, no external database. Deploy with a free Cloudflare account (Workers + Pages + one secret).
| Surface | URL | Role |
|---|---|---|
| App | thequeueless.pages.dev | SPA (customer, operator, board, docs) |
| API | queueless.zamdevio.workers.dev | Hono worker + Durable Objects |
| Source | github.com/zamdevio/queueless | Monorepo |
pnpm install
pnpm typecheck && pnpm build && pnpm test| Command | What |
|---|---|
pnpm web:dev |
SPA on http://localhost:5173 |
pnpm worker:dev |
API on http://localhost:8787 |
pnpm worker:deploy |
Deploy Worker + Durable Objects |
pnpm web:deploy |
Build + deploy Pages |
pnpm test:policies |
Run worker policy tests (see scripts/) |
| App | File | Keys |
|---|---|---|
| Web | apps/web/.env / .env.production |
VITE_API_URL (local default http://localhost:8787) |
| Worker | apps/worker/wrangler.jsonc |
ALLOWED_ORIGINS, ENVIRONMENT |
| Secrets | .dev.vars / wrangler secret put |
OPERATOR_PIN, optional SESSION_SECRET |
Operator PIN (prod): cd apps/worker && wrangler secret put OPERATOR_PIN
| Customer | Optional display name, live position, ETA, call dialog; ticket restored after reload (device UUID) |
| Operator | PIN sign-in, call next / skip / remove / reset, capacity, rolling stats, CSV/JSON/Markdown export, copy board link |
| Board | /board/:queueId live monitor |
| Policies | Login 10 fails/min/IP · join 5/min/IP/queue · one ticket per device · capacity — see docs/product/policies.md |
Default queue id: main. Routes: /student/{id} · /operator/{id} · /board/{id} · /docs/{page}.
- Web: React + Vite SPA, PWA, SVG icons
- API: Cloudflare Workers + Hono
- Live queue: Durable Object per
queueId(QueueDO) - Rate limit:
RateLimitDO(login + join, per-IP, DO storage) - Updates: SSE
- Auth: Operator PIN → signed session (Bearer + cookie)
- Database: None — state in Durable Objects
- Clone this repo,
pnpm install cd apps/worker && wrangler secret put OPERATOR_PINpnpm worker:deploy- Set
VITE_API_URLinapps/web/.env.production→pnpm web:deploy - Add Pages domain to
ALLOWED_ORIGINSinapps/worker/wrangler.jsonc, redeploy worker
BASE_URL=https://queueless.zamdevio.workers.dev pnpm test:policiesapps/web/ React SPA + PWA (customer, operator, board, docs)
apps/worker/ Hono API + QueueDO + RateLimitDO
docs/ Course, product, architecture, policies
maintainer/ Focus, systems, agents, shipped
scripts/ Policy/rule test harness
Agents: AGENT.md · Focus: maintainer/phases/focus.md