Minesweeper

A minesweeper game written in Crystal, built on the CrymbleUI declarative GUI framework.

The game logic (src/minesweeper.cr) is fully separated from the view/input layer (src/minesweeper-gui.cr): the GUI only talks to the game through its public API and its win/lose callbacks.

Download

Prebuilt binaries are attached to each GitHub Release:

• Linux — minesweeper-linux-x86_64.AppImage (portable; chmod +x then run, or --appimage-extract-and-run if you have no FUSE).
• Windows — minesweeper-windows-x64.exe (fully static — no DLLs or VC++ redistributable needed).

Controls

• Left click — reveal a cell. On an already-revealed number, it "chords": reveals all neighbours when the number's markers are satisfied.
• Right click — toggle a bomb marker. On a revealed number, it also chords.
• Space / m — keyboard equivalents of a left / right click on the cell under the mouse cursor (Space reveals/chords, m toggles a marker).
• Autosolver? — when checked, the solver repeatedly applies the obvious deductions until it gets stuck (or wins/loses).
• On game over, a popup offers Yes (play again) or No (quit).

Build & run

CrymbleUI bundles its own SFML 3.0 / CSFML 3.0 native libraries, so no system-wide SFML install is needed.

shards install          # fetches CrymbleUI (+ its bundled native libs)
source setup.sh         # wires up LD_LIBRARY_PATH etc. to the bundled libs
shards build minesweeper
bin/minesweeper

During development you can also run directly:

source setup.sh
crystal run src/minesweeper-gui.cr

Windows build (cross-compiled from Linux)

A fully-static minesweeper.exe (no DLLs / VC++ redistributable) can be cross-built from Linux via the MSVC toolchain:

shards install
./scripts/win-setup-deps.sh     # one-time: Windows SDK + Crystal Windows libs
./scripts/linux_cross_build_win32.sh   # → build/win/minesweeper.exe

See docs/WINDOWS_BUILD.md for details.

Tests

The game logic has specs:

crystal spec

License

MIT — see LICENSE.