Minesweeper Mobile

A modern, mobile-first Minesweeper clone with classic rules and a simple Dig / Flag toggle that feels great on touchscreens.

Features

• Classic Minesweeper gameplay
  • Dig (reveal), Flag, and Chord (quick reveal)
• Mobile-first controls
  • Toggle between Dig and Flag modes
  • No long-press required
• Difficulty presets
  • Beginner / Intermediate / Expert
  • Custom board size + mine count
• Quality-of-life
  • First dig is always safe (no first-move losses)
  • Timer + mine counter
  • Haptics + sound toggles (optional)
  • Pause / resume
• Stats
  • Best times per difficulty
  • Win rate + streaks

Screenshots

Add screenshots or a quick GIF once the UI is stable.

Controls

Mode Toggle

Use the mode button to switch between:

• Dig Mode (default): tap a tile to reveal it
• Flag Mode: tap a tile to place/remove a flag

Chording (Quick Reveal)

When a numbered tile is already revealed:

• If the number of adjacent flags equals the number on the tile, you can tap the number to reveal all remaining adjacent unflagged tiles.

How to Play

• Avoid mines.
• Numbers tell you how many mines are touching that tile (8-direction adjacency).
• Flag suspected mines.
• Reveal all non-mine tiles to win.

Win: all safe tiles revealed
Lose: you dig a mine (first move is always safe)

Game Rules and Behavior

• First-move safe: Mines are placed after your first dig so the first tile is never a mine.
• Mine placement: Randomized placement respecting the first-dig safety rule.
• Flood fill: Digging a 0 expands to adjacent empty tiles until bordered by numbered tiles.
• Flags: Flags prevent accidental digs while in Dig mode (optional behavior, recommended).
• Chord: Tapping a revealed number will reveal neighbors when flags match the number.

Tech Stack

• App: <React Native | Flutter | Swift/Kotlin | etc.>
• State: <Redux / Riverpod / MVVM | etc.>
• Storage: <AsyncStorage / SQLite / SharedPreferences | etc.>

Getting Started

Prerequisites

• <Node 18+ / Flutter SDK / Xcode / Android Studio / etc.>

Install

git clone <your-repo-url>
cd minesweeper-mobile
<your-install-command>