Minesweeper Game

A classic Minesweeper game built with JavaScript, HTML, and CSS.

Table of Contents

• About the Project
• Game Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Game Rules
• Contributing
• License
• Contact

About the Project

This is a web-based implementation of the classic Minesweeper game. It was developed as a practice project to improve skills in JavaScript, HTML, and CSS.

Game Features

• Three difficulty levels: Beginner, Intermediate, and Expert.
• Implemented using plain JavaScript for game logic.
• Sound effects for game interactions.
• Displays remaining lives as heart icons.
• Timer to track the time taken to complete the game.
• Hints for uncovering cells temporarily.
• Real-time updates and dynamic gameplay.

Getting Started

Prerequisites

• A modern web browser (e.g., Chrome, Firefox, Edge).
• Basic knowledge of HTML, CSS, and JavaScript (optional for contributors).

Installation

1. Clone the repository to your local machine:

   git clone https://github.com/natiapa/minesweeper.git

2. Open the project directory:

   cd minesweeper

3. Open index.html in your web browser to start the game.

Usage

• Choose the difficulty level (Beginner, Intermediate, Expert).
• Click on cells to reveal them.
• Right-click to place flags on suspected mines.
• Use hints if needed.
• The game ends when all non-mine cells are revealed or when a mine is clicked.

Game Rules

• The goal is to clear a board containing hidden mines without detonating any of them.
• Each number in a revealed cell represents how many mines are adjacent to it.
• Use logic and reasoning to avoid mines and clear the board.

Contributing

Contributions are what make the open-source community such an amazing place to learn and create. Any contributions you make are greatly appreciated.

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/YourFeature).
3. Commit your changes (git commit -m 'Add some YourFeature').
4. Push to the Branch (git push origin feature/YourFeature).
5. Open a Pull Request.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Natia Cohen - natiapa

Project Link: https://natiapa.github.io/minesweeper/