Pollux¶

Pollux is a real-time polling and quiz server built with Bun. It lets you create live polls, dynamic multi-step polls, and quizzes where results update instantly via WebSockets.

Quick start¶

bun install
bun src/index.ts

Open http://localhost:3000 and start voting.

Key features¶

• Static polls — Simple yes/no or multiple-choice polls with live results
• Dynamic polls — Admin pushes new questions in real time; participants vote step by step
• Quizzes — Timed questions with scoring, speed bonuses, and a podium
• Raffles — Random draw with a spinning wheel, auto-assigned pseudonyms, and real-time winner announcement
• Real-time — WebSocket-based subscriptions push results to all connected clients
• Zero config — SQLite database, no external dependencies

The four modes¶

Every mode is a set of pages sharing one poll UUID, kept in sync over a WebSocket channel.

flowchart TB
  U(["Poll UUIDv7"])
  U --> S["<b>Static poll</b><br/>choices in the URL hash"]
  U --> D["<b>Dynamic poll</b><br/>admin pushes steps live"]
  U --> Q["<b>Quizz</b><br/>timed rounds + scoring"]
  U --> R["<b>Raffle</b><br/>spin the wheel"]

  S --> S1["/vote · /many · /results"]
  D --> D1["/dynamic-vote · /dynamic-many · /dynamic-result"]
  Q --> Q1["/quizz-admin · /quizz-vote · /quizz-result"]
  R --> R1["/raffle-admin · /raffle-vote"]

Documentation structure¶

This documentation follows the Diátaxis framework: