Trivia Game

A realtime trivia game themed like a USPS post office, supporting up to 30 concurrent users.

https://www.val.town/x/bmitchinson/factoid-trivia

• USPS post office themed design
• Real-time user presence (see who's online)
• Name entry and user management
• Support for up to 30 concurrent players
• NEW: Complete trivia game functionality:
  • Fact submission by each player
  • Random fact selection for rounds
  • Voting system where players guess whose fact it is
  • Real-time vote tracking and display
  • Answer reveal with vote results
  • Scoring system and leaderboard
  • Skip functionality for rounds

1. Join the Game: Enter your name to join the post office
2. Submit a Fact: Each player submits an interesting fact about themselves
3. Wait for Others: Game can start when at least 2 players have submitted facts
4. Vote on Facts: When a fact is displayed, guess which player it belongs to
5. See Results: After voting, reveal answers to see who was correct
6. Earn Points: Get 1 point for each correct guess
7. Climb the Leaderboard: Track your score against other players

Join Game → All Players Submit Facts → Facts Get Queued →
Vote on Random Facts → See Results → Earn Points →
Next Round → Repeat Until All Facts Used

• Everyone Submits Facts: All players can and should submit facts
• Random Queue System: Facts are randomly selected from the queue for each round
• Flexible Start: Game can start with 2+ facts, or wait for everyone
• Real-time Progress: See who has/hasn't submitted facts yet
• Complete Fact Usage: All submitted facts will eventually be used in rounds

├── backend/
│   ├── index.ts           # Main Hono server with game API endpoints
│   ├── database/
│   │   ├── migrations.ts  # SQLite schema for users, facts, votes, rounds
│   │   └── queries.ts     # Database query functions for game logic
│   └── routes/
│       └── websocket.ts   # WebSocket connection handling (future)
├── frontend/
│   ├── index.html         # Main HTML template
│   ├── index.tsx          # React frontend entry point
│   ├── components/
│   │   ├── App.tsx        # Main app component with game state management
│   │   ├── NameEntry.tsx  # Name entry form
│   │   ├── FactEntry.tsx  # Fact submission form
│   │   ├── GameLobby.tsx  # Waiting area showing fact collection progress
│   │   ├── GameRound.tsx  # Active round with voting interface
│   │   ├── Leaderboard.tsx # Score tracking display
│   │   └── UserList.tsx   # Online users display
│   └── style.css          # USPS-themed styles
└── shared/
    └── types.ts           # Shared TypeScript types for game objects

1. The backend runs on Hono with WebSocket support for real-time features
2. Frontend uses React with WebSocket client for real-time updates
3. SQLite stores user sessions and game state
4. USPS-themed styling with postal colors and typography

• ✅ User name entry and management
• ✅ Real-time user presence (up to 30 players)
• ✅ USPS theming and design
• ✅ Fact submission system
• ✅ Random fact selection for rounds
• ✅ Voting system with real-time updates
• ✅ Answer reveal and vote result display
• ✅ Scoring system and leaderboard
• ✅ Skip round functionality
• ✅ Complete game flow from start to finish

• GET /api/game-state - Get current game state including users, rounds, leaderboard
• POST /api/join - Join the game with a name
• POST /api/leave - Leave the game
• POST /api/submit-fact - Submit a personal fact
• POST /api/start-round - Start a new round with a random fact
• POST /api/vote - Cast a vote for who you think the fact belongs to
• POST /api/reveal - Reveal the answer and award points
• POST /api/skip - Skip the current round
• POST /api/admin/kick-all - [ADMIN] Clear all game data and kick all players

The game includes an admin panel accessible through a discrete "Admin" link at the bottom of the page. This provides:

• Kick All Players: Immediately disconnects all connected players and clears all game data including:
  • All user sessions
  • All submitted facts
  • All votes and rounds
  • All scores and leaderboard data
  • Current game state

⚠️ Warning: The kick all function is irreversible and will completely reset the game to its initial state.