NYE Quiz App

A real-time multiplayer quiz application for hosting New Year's Eve trivia with friends. Built with Django and designed for local network play.

Features

• Host Dashboard: Create games, manage question sets, control game flow
• QR Code Join: Players scan to join instantly on their phones
• Multiple Question Types: Text answers, multiple choice, and intro slides
• Real-time Scoring: Live scoreboard updates as host marks answers
• Reusable Question Sets: Create question sets once, use across multiple games

Quick Start

# Install dependencies
uv sync

# Run migrations
uv run python manage.py migrate

# Start the server (accessible on local network)
uv run python manage.py runserver 0.0.0.0:8000

Then visit http://localhost:8000/host/ to create a game.

How It Works

1. Host creates a game and adds questions (or uses an existing question set)
2. Players scan the QR code to join with their team name
3. Host starts the game and controls question flow
4. Players submit answers on their phones
5. Host reveals answers and awards points
6. Final scoreboard shows the winners

Tech Stack

• Python 3.12+
• Django 6.0
• SQLite
• HTMX for real-time updates
• qrcode for QR generation
• Pillow for image handling

Project Structure

nye2025/
├── quiz/           # Main app (models, views, templates)
├── quizapp/        # Django project settings
├── static/         # CSS and static files
├── media/          # Uploaded question images
└── manage.py

License

MIT