Numpuz

Numpuz is a puzzle game where the player needs to arrange a set of shuffled numbers in ascending order. The game provides an interactive user interface where the player can easily move the numbers around to solve the puzzle. This application is developed using ReactJS.

Features

• The game board can be customized with three different sizes: (3x3, 4x4, 5x5...)
• The player can move numbers around by clicking on the adjacent empty cell.
• The game is won when all the numbers are arranged in ascending order.
• The player can reset the game at any time by clicking the "Reset" button.
• The application is responsive and works well on both desktop and mobile devices.

Installation

To install the application, follow these steps:

1. Clone the repository to your local machine using the command git clone https://github.com/braiekhazem/numpuz_game.git.
2. Navigate to the project directory using the command cd numpuz_game.
3. Install the dependencies using the command npm install.

Usage

To start the application, run the following command in the project directory:

npm start

This will start the development server and open the application in your default browser. You can also access the application by visiting http://localhost:3000 in your browser.

Game Instructions

The objective of the game is to arrange the shuffled numbers in ascending order. To move a number, click on the adjacent empty cell. You can customize the size of the game board by selecting from the options on the main screen. The game is won when all the numbers are arranged in ascending order.

Contributing

Thank you for considering contributing to the development of Numpuz! Here are a few guidelines to follow to make the process smoother:

Issues and Bugs

If you encounter any issues or bugs while using Numpuz, please submit an issue on the project's GitHub page. When submitting an issue, please include a clear and detailed description of the problem, along with any relevant screenshots or error messages.

Pull Requests

If you would like to contribute to the codebase, please follow these steps:

1. Fork the project on GitHub.
2. Create a new branch with a descriptive name.
3. Make your changes and test them thoroughly.
4. Submit a pull request with a clear and detailed description of your changes.

Live Demo : https://numpuz-game.web.app