Create and share polls in seconds.
 |
 |
- Create polls instantly — Build a poll with a title, description, and as many options as you need, then share it with a single link.
- One vote per IP — Protection ensures each person only votes once, keeping results fair without requiring accounts.
- Live results — Vote counts update in real time for everyone viewing the poll simultaneously, powered by WebSockets and Django Channels.
- Public results — Toggle whether results should be visible to voters after they cast their vote, with a live chart breakdown.
- Scheduled polls — Set a start and end date for your poll. It will automatically go live and close at the specified times.
- Authentication — Sign in with email/password or Google to manage your polls.
- User dashboard — Manage all your polls in one place — view responses, update poll settings, and track poll details.
| Layer | Technology |
|---|---|
| Backend | Python, Django |
| Real-time | Django Channels, WebSockets |
| Task Queue | Celery, Celery Beat |
| Broker/Cache | Redis |
| Frontend | TypeScript, React, Inertia.js |
| Styling | Tailwind, Shadcn/ui |
| Database | PostgreSQL |
| Resend |
- Python 3.12+
- Node.js 24+
- uv
- pnpm
- Redis
-
Clone the repository and navigate into the project directory.
-
Install Python dependencies:
uv sync
-
Install frontend dependencies:
pnpm install
-
Copy the environment file and fill in your values:
cp .env.example .env
-
Run migrations and start the development servers:
uv run manage.py migrate uv run manage.py runserver
pnpm dev
-
Ensure Redis is running. See the Redis documentation for installation and startup instructions.
-
Start the Celery worker (handles background tasks):
uv run celery -A simple-poll worker -l info
-
Start the Celery Beat scheduler (handles scheduled poll activation/deactivation):
uv run celery -A simple-poll beat -l info --scheduler django_celery_beat.schedulers:DatabaseScheduler
MIT