Welcome to Pug Garden Minesweeper! A classic Minesweeper game with a whimsical twist, inspired by pugs and gardens. Help our pug avoid the dangers hidden beneath the garden tiles.
- Customizable Game Grid: Responsive and perfectly square grid for a smooth gameplay experience on all devices.
- Smart Mine Placement: Mines are placed after the first click to ensure the first tile clicked is always safe.
- Flag Management: Mark the tiles you suspect of containing a mine.
- Integrated Timer: Keep track of the elapsed time to improve your performance with each game.
- Modern Design: Clean user interface with soft colors and smooth transitions.
Make sure you have Node.js installed on your machine.
-
Clone this repository:
git clone https://github.com/yourusername/pug-garden-minesweeper.git cd pug-garden-minesweeper
-
Install dependencies:
npm install
-
Start the server:
node app.js
-
Open your browser and navigate to: http://localhost:3000
- Start the Game: Click on a tile to begin. The first tile clicked is always safe.
- Mark a Tile: Right-click on a tile to flag it.
- Reveal a Tile: Click on an unmarked tile to reveal it. If the tile contains a mine, the game is over.
- Win the Game: Reveal all the tiles that do not contain mines to win.
public/
: Contains static files like CSS styles, images, and JavaScript scripts.views/
: Pug (templates) files for rendering HTML dynamically.app.js
: Main entry point of the Node.js application.script.js
: Main game logic, handling clicks, mines, and the timer.
- Node.js: Server to handle requests and serve the application.
- Express: Minimalist framework for Node.js.
- Pug: Template engine to dynamically generate HTML.
- CSS Grid: Used to build a responsive grid.
Contributions are welcome! Whether it's bug fixes, new features, or improvements, feel free to make a pull request. Here’s how you can contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-name
). - Commit your changes (
git commit -m 'Add some feature'
). - Push to the branch (
git push origin feature-name
). - Open a pull request.
Please make sure to update tests as appropriate.
Join the conversation! We’re excited to hear your feedback and ideas:
- Issues: Found a bug? Have a feature request? Open an issue.
- Discussions: Share your thoughts or ask questions in our Discussions forum.
This project is licensed under the MIT License. See the LICENSE file for more details.
Have fun and help our pug safely navigate the garden! 🐾