justaino/Omo-Naija

# Omo Naija A Nigerian party word-guessing game for mobile, desktop, and web. Pass one device around the room: teams take turns describing Nigerian slang and phrases while their teammates guess as many as possible before the timer runs out. Won cards pile up per team, and the winner is revealed when you end the game. > *Omo Naija* — "child of Nigeria." How well do you really sabi your slang? ## Status Playable. Phases 0–3 of `ROADMAP.md` are complete plus a buildless PWA — a full pass-and-play game that's installable and works offline. Phase 4 (online multiplayer, etc.) is deferred. See `CLAUDE.md` → Status and `documentation/RUNBOOK.md` for details. ## How to play (the game) 1. Set up teams, timer length, mode, skip rule, and win condition. 2. Pass the phone to the active team's clue-giver. 3. **Green mode:** clue with 3 words + gestures only. **Grey mode:** describe however you like. **Mixed:** both. 4. Tap **Got it!** for each correct guess (+1), **Skip** to pass. 5. When the timer ends, the phone moves to the next team. 6. Tap **End game** anytime to reveal the final stacks and the winner. ## Tech - Vanilla HTML / CSS / JavaScript (no UI framework, no build step). - GSAP (+ Flip) for animation, Howler.js for sound, canvas-confetti for the win — all vendored locally in `assets/vendor/` (no CDN), so the app works offline. - `localStorage` for game state + settings (no backend, no accounts). - Buildless PWA: hand-written `manifest.json` + `service-worker.js` — installable and fully offline. ## Run it Serve the folder over HTTP (ES-module imports and the word-bank `fetch` don't work from `file://`): ``` npx serve # or: python3 -m http.server ``` Then open the printed `http://localhost:…` URL. The PWA installs over **HTTPS or localhost** (browsers block service workers on plain `file://`/LAN-HTTP). ### Test on your phone Deploy to **GitHub Pages** (Settings → Pages → deploy from a branch). Pages serves over HTTPS, so on your phone you can open the U …