# Bomb It — Complete Knowledge Base & Documentation

> Bomb It is a free, instant-play browser multiplayer party game for 2 players plus unlimited spectators. No sign-up, no downloads, no app store required.

Website: https://bomb-it.com/
Daily Puzzle: https://bomb-it.com/daily
Contact: support@bomb-it.com

---

## 1. Overview & Core Mechanics

Bomb It is a tactical 1v1 party game inspired by Minesweeper and the viral Bomb Chip Challenge, enhanced with psychological bluffing and defuse economics.

### Key Highlights:
- **Zero Friction:** Open URL, choose a nickname and emoji, start or join a game with a 6-letter room code or link.
- **Turn-based:** 15-second timer per turn prevents stalling.
- **3 Hearts:** Both players start with 3 hearts. Hitting an opponent's bomb detonates it, costs 1 heart, and yields the turn.
- **Defusal System:** Your own bombs are 100% safe to tap. Tapping your own bomb publicly defuses it. This gives you a guaranteed safe move while intentionally misleading your opponent about bomb placements.
- **Victory Condition:** Last player with hearts remaining wins. If the board is cleared, the player with the most hearts wins (or a draw if tied).

---

## 2. Game Formats

1. **Duel Mode (2-Player Default)**
   - Two separate 3x3 grids (9 cells each).
   - Each player places 3 bombs secretly on their grid.
   - Players take turns hunting on the opponent's grid while tracking their own.
   - Fast, tight, highly tactical.

2. **Quick Mode (Shared Board)**
   - One shared 4x4 grid (16 cells).
   - 4 bombs per player (8 bombs total, half the board mined).
   - Fast-paced and intense risk management.

3. **Classic Mode (Shared Board)**
   - One shared 5x5 grid (25 cells).
   - 5 bombs per player (10 bombs total).
   - More open room for maneuvers and layered bluffing.

4. **Daily Bomb (Solo Mode)**
   - URL: https://bomb-it.com/daily
   - One shared 6x6 grid with 8 hidden bombs.
   - Identical puzzle layout for all players worldwide every day, resetting at 00:00 UTC.
   - Push-your-luck mechanic: tap safe cells to multiply score, cash out before hitting a bomb.
   - Shareable spoiler-free emoji grid (like Wordle) to challenge friends.

---

## 3. Advanced Strategy & Tactics

- **Placement Psychology:** Avoid clustering all bombs along edges or corners. Mix center traps with isolated edge bombs.
- **Defuse Economics:** Do not burn all self-defuses in early turns. Saving a defuse for the endgame provides a guaranteed safe turn when the board becomes statistically dangerous.
- **Health Management:** Play aggressively with 3 hearts; pivot to conservative deduction when at 1 heart.
- **Information Asymmetry:** Every cell you reveal gives information to your opponent. Defusing your own bomb sends a deceptive signal about where remaining bombs are placed.
- **5 Beginner Mistakes:**
  1. Hiding all bombs in corners.
  2. Defusing own bombs too early.
  3. Guessing blindly in the endgame without calculating remaining bomb probabilities.
  4. Playing with the same risk tolerance at 1 heart as at 3 hearts.
  5. Repeating the same placement layout in rematches.

---

## 4. Group Play, Spectators & Events

- **Unlimited Spectators:** Anyone with the room link or code can join as a spectator.
- **Zero-Latency Emoji Reactions:** Spectators react in real time with emoji bursts on screen.
- **Anti-Cheat Security:** Spectator clients NEVER receive hidden bomb locations over the network, ensuring zero leaks or screen-peeking exploits.
- **Ideal For:** Game nights, Discord hangouts, Twitch streams, classroom icebreakers, and corporate team building.

---

## 5. Technical & Privacy Architecture

- **No Accounts / No Passwords:** Identity is ephemeral (localStorage holds only nickname and emoji preference on the client).
- **Ephemeral State:** All room states live exclusively in server RAM and are immediately purged when the room closes.
- **No Database:** No gameplay history, match logs, or private data are persisted to disk.
- **PWA Ready:** Fully installable on iOS and Android via "Add to Home Screen" for a full-screen, native-like experience.
- **GDPR Compliant:** Designed from the ground up for minimal data footprint.

---

## 6. Support & Contact

- Email: support@bomb-it.com
- Contact Page: https://bomb-it.com/contact