Pokémon Bingo 🎮

A Pokémon-themed bingo caller board for hosting bingo games. Randomly draws Pokémon from a customizable pool and displays them on a master board — perfect for parties, classrooms, or PTA events.

Features

• Custom Presets — Create named Pokémon pools (e.g. "Gen 1 Classic", "Kids Party") and save them for reuse
• Pokémon Selector — Filterable gallery across Gen 1–3 (386 Pokémon); filter by generation, type, or name search
• BINGO Mode — 5-column BINGO grid with sprite + name per cell; highlights when drawn
• Match Mode — A simplified mode for the little ones - simply match the Pokémon drawn to the card
• Draw Overlay — Full-screen spotlight animation showing the column, sprite, and Pokémon name on each draw
• 3 Themes — Cerulean (blue), Cinnabar (red), and Pallet (white) using official Pokémon brand colors
• Keyboard Shortcuts — Space to draw, R to reset, F for fullscreen
• Persistent Storage — Presets, active preset, theme, and win pattern all saved via localStorage

Getting Started

No build step, no dependencies. Just open index.html in a browser.

git clone https://github.com/your-username/pokemon-bingo.git
cd pokemon-bingo
open index.html

Or deploy to any static host (GitHub Pages, Netlify, Vercel) by pointing it at the repo root.

How to Play

1. Go to Presets and create a new preset
2. Use the gallery to select which Pokémon to include (minimum 25)
3. Name and save your preset
4. Back on the home screen, select your preset as active and hit Play
5. Press DRAW (or hit Space) to randomly call a Pokémon
6. The full-screen overlay shows the drawn Pokémon — press Space or click to dismiss and continue
7. Drawn Pokémon highlight on the master board for easy tracking

Keyboard Shortcuts

Key	Action
Space / Enter	Draw a Pokémon / dismiss overlay
R	Reset the board
F	Toggle fullscreen
Esc	Dismiss overlay or close modal

File Structure

pokemon-bingo/
├── index.html          # All screens and markup
├── assets/
│   ├── css/
│   │   └── style.css   # Themes, animations, layout
│   └── js/
│       ├── main.js     # Game logic, presets, draw engine
│       └── pokedata.js # Pokémon data (Gen 1–3) + sprite URLs
├── .gitignore
├── LICENSE
└── README.md

Sprites

Sprites are loaded from the PokeAPI sprites repository via the unpkg CDN. A 3-level fallback chain ensures images load reliably:

1. Official artwork PNGs (unpkg)
2. Dream World SVGs (unpkg)
3. Raw GitHub PNGs
4. Inline Pokéball SVG placeholder

Credits

• Inspired by bingo-master-board by Games by Tim
• Pokémon data and sprites via PokéAPI
• Pokémon is © Nintendo / Game Freak — this project is unofficial and not affiliated with or endorsed by Nintendo

License

MIT