Mine Rush 💎💣

Discover Mine Rush—where classic puzzle-solving meets modern innovation. A Mines Game with sleek, minimalist design and fluid interactions that will keep you on your toes. Built using cutting-edge tech like Next.js and Tailwind CSS, Express.js, and MongoDB, redefines the challenge, creating an immersive experience that blends nostalgia with modern competition. Ready to outsmart the grid and conquer the mines? Dive into the rush today!

Players can sign in, track their progress, and climb the live leaderboard. With responsive design and immersive sounds, Mine Rush offers a fresh take on minesweeper that’s both fun and challenging.

This open-source project is more than just a game – it’s a collaborative effort to push the boundaries of what a minesweeper game can be. Join us in building something truly unique! PLAY NOW 💎

Table of Contents

• Features
• Demo
• Tech Stack
• Contributing
• Getting Started
• Environment Variables
• Running the Application
• License

Features

• Interactive Gameplay: Enjoy a Minesweeper-like experience with engaging sounds and styling.

• User Authentication: Secure sign-in process using OAuth.

• Score Tracking: Record and display scores for each game session.

• Leaderboard: Compete with other players and see who tops the charts.

• Profile Page: View personal stats, including rank and high score.

• Responsive Design: Fully responsive web application built with TailwindCSS.

Demo

LIVE AT https://mines-game-app.vercel.app/

The application (both client & server) is currently deployed on vercel using the free hosting which The frontend is hosted on https://mines-game-app.vercel.app/ and the backend is hosted on https://mines-backend.vercel.app/ using the same

Tech Stack

• Frontend: NextJS, TailwindCSS

• Backend: Express.js

• Database: MongoDB

• Authentication: OAuth

Contributing

Mine RUSH is an open-source project, and we strongly encourage the community to contribute and help it grow! Whether you're fixing a bug, adding new features, or improving documentation, we would love your help in making this project even better.

How to Contribute

1. Fork the repository

2. Create a new branch: git checkout -b feature/your-feature-name

3. Make your changes and commit them: git commit -m 'Add some feature'

4. Push to the branch: git push origin feature/your-feature-name

5. Submit a pull request

Please make sure to update tests as appropriate and adhere to the existing coding style.

Getting Started

Prerequisites

• Node.js (v14 or later)

• MongoDB

• npm or yarn

Installation

1. Clone the repository:

git clone https://github.com/Parth-G27/mines.git

cd Mine-RUSH

2. Install dependencies for both frontend and backend:

cd client && npm install

cd ../server && npm install

3. Set up environment variables:

• Create a .env file in the server directory for backend configuration.
• Create a .env file in the client directory for frontend configuration.

4. Start the development servers:

# In the server directory
npm start

# In the client directory
npm run dev

5. Open your browser and navigate to http://localhost:3000 to see the application running.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to all contributors who have helped shape Mine RUSH.
• Inspired by the classic Minesweeper game

Contact

If you have any questions or suggestions, please open an issue or contact the maintainer here.

Happy Coding! ❤️