Search packages, repositories and app categories

GitHub repositorymrgnhnt96/minesweeper

Minesweeper

Classic Minesweeper recreated for the command line

Minesweeper project cover
Stars
16
Forks
1
Last push (UTC)
Dec 5, 2025
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

Minesweeper

A classic Minesweeper game for the terminal, built with Dart and nocterm.

███╗   ███╗██╗███╗   ██╗███████╗███████╗
████╗ ████║██║████╗  ██║██╔════╝██╔════╝
██╔████╔██║██║██╔██╗ ██║█████╗  ███████╗
██║╚██╔╝██║██║██║╚██╗██║██╔══╝  ╚════██║
██║ ╚═╝ ██║██║██║ ╚████║███████╗███████║
╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝
Minesweeper Minesweeper Minesweeper Minesweeper ## Features
  • Terminal-based UI with keyboard controls

  • Three difficulty levels:

    Difficulty Grid Size Mine Density
    Easy 9×9 12%
    Medium 16×16 24%
    Hard 24×24 36%
  • Animated game over sequence

  • Flag system to mark suspected mines

Requirements

  • Dart SDK >=3.9.0 <4.0.0

Installation

dart pub get

Usage

dart run

Controls

Key Action
Arrow Keys Move cursor
Space Reveal cell
F Flag/unflag cell
Enter Confirm selection

How to Play

  1. Select a difficulty level on the intro screen
  2. Navigate the grid using arrow keys
  3. Press Space to reveal a cell
  4. Press F to flag cells you suspect contain mines
  5. Reveal all non-mine cells to win
  6. Hit a mine and it's game over!

Project Structure

lib/
├── main.dart           # Entry point
└── src/
    ├── app.dart        # Root application component
    ├── models/         # Data models (Difficulty, Place, etc.)
    ├── provider/       # State management
    └── screens/
        ├── intro/      # Difficulty selection screen
        ├── mine_sweeper/  # Main game screen
        └── game_over/  # Game over screen

Dependencies

Morgan Hunt GitHub avatar
GitHub author

Morgan Hunt ↗

Flutter, Fluttering, Fluttered Blue heart · Avid coder Man technologist · Biggest freaking Legend of Zelda fan 🗡

Mesa, AZ USA
LanguagesDart

Flutter dependencies

Dependencies used

Dependency list 3 items

App categories

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗