NiceGUI Minesweeper

A classic Minesweeper game built with the awesome NiceGUI framework. This project provides a simple and clean implementation of the beloved logic puzzle, ready to run in your browser.

Features ✨

• Classic game play: Enjoy the timeless logic puzzle of Minesweeper.
• Clean interface: A simple and intuitive UI powered by NiceGUI.
• Easy to install: Get up and running with a single command.
• Lightweight: Runs efficiently as a web-based application.

Getting Started 🚀

Getting the game running on your local machine is quick and easy.

Prerequisites

Make sure you have Python 3.12+ installed on your system.

Installation & Usage

You can install and run the game using pip, a standard Python package manager.

1. Install the package:

   pip install nicegui-minesweeper
   

2. Run the game:

   minesweeper
   

Alternatively, if you use uv, you can run it with:

uv run --with nicegui-minesweeper minesweeper

Once you run the command, your web browser should open to the game automatically.

About NiceGUI 🤖

NiceGUI is an easy-to-use, Python-based UI framework for building web frontends. It allows developers to create web applications, dashboards, and interactive UIs without needing to write any HTML, CSS, or JavaScript.

This Minesweeper game serves as a simple example of what can be accomplished with the power and simplicity of NiceGUI.