Choctaw Nation EPS Trivia Bingo

A web-based trivia bingo game featuring 27 questions about Choctaw Nation culture, language, history, environmental protection, and water resources. Host and player views run entirely in the browser and synchronize through the BroadcastChannel API.

Live Demo

Once deployed, access the game at: https://<your-username>.github.io/Bingo/

Features

• Host Console: Start a game session, call questions, display QR codes for easy player joining, and reveal answers
• Player View: Get a unique 5x5 bingo board based on your name and game code
• 27 Trivia Questions: Topics include Choctaw language, native trees & plants, wildlife, history, environmental protection, recycling, and water resources
• Automatic Bingo Detection: Get 5 in a row (horizontal, vertical, or diagonal) to win
• No Backend Required: Everything runs in the browser with BroadcastChannel sync
• Mobile Responsive: Works on phones, tablets, and desktops

Question Categories

Category	Questions
Choctaw Language & Nature	9
History & Geography	4
Environmental & Recycling	7
Water Resources & Settlement	7

Quick Start (Local Development)

1. Start a local static server from the project root:

   python3 -m http.server 4173

2. Open the host console at http://localhost:4173/public/host.html

3. Share the QR code or URL shown on the host console; players join at the player URL with the provided game code

Deploying to GitHub Pages

This repository includes a GitHub Actions workflow that automatically deploys to GitHub Pages:

1. Go to your repository Settings > Pages
2. Under "Build and deployment", select GitHub Actions as the source
3. Push to the main branch or manually trigger the workflow
4. Your game will be available at https://<username>.github.io/Bingo/

How It Works

• Deterministic Board Generation: Game code + player name seeds a shuffle algorithm, so every player gets a unique reproducible card
• BroadcastChannel API: Host broadcasts game state (questions, answers, resets) to all player tabs on the same origin
• Client-Side Answer Checking: Case-insensitive matching happens in the browser

Project Structure

public/
├── index.html      # Landing page
├── host.html       # Host console
├── player.html     # Player view
├── styles.css      # Unified styles
├── host.js         # Host logic
├── player.js       # Player logic
├── common.js       # Shared utilities
└── questions.js    # Question bank (27 questions)

Customization

• Questions: Edit public/questions.js to add or modify questions (keep id, category, prompt, and answer fields)
• Styling: Customize colors and layout in public/styles.css
• Deployment: Serve the public/ directory from any static host (Netlify, Vercel, S3, etc.)

Yakoke!

Thank you for playing Choctaw Nation EPS Trivia Bingo!