Welcome to Bubble Game! A fun and interactive game built with modern web technologies. Test your reflexes and number recognition skills by popping the right bubbles before time runs out!
- Responsive Design: Works seamlessly on all screen sizes.
- Difficulty Levels: Choose from Easy, Medium, or Hard modes.
- Dynamic Gameplay: Bubbles regenerate with new numbers after each correct hit.
- Scoring System: Earn points for correct hits and receive time bonuses.
- Penalties: Incorrect clicks deduct points, adding a challenge.
- Sound Effects: Enjoy feedback with correct and incorrect sounds.
- High Score Tracking: Your highest score is saved locally.
- User-Friendly Interface: Clean design with intuitive controls.
- Separate Components: Organized codebase with reusable components.
- Select Difficulty: On the home screen, choose your desired difficulty level—Easy, Medium, or Hard.
- Start the Game: Click on the "Start Game" button to begin.
- Objective: Find and click on bubbles containing the Hit Number displayed at the top.
- Score Points:
- Correct Hit: Earn 10 points and gain +2 seconds on the timer.
- Incorrect Click: Lose 5 points.
- Game Over: The game ends when the timer reaches zero. Try to beat your high score!
- Controls During Game:
- Exit Game: Return to the home screen.
- Restart: Start a new game with the current difficulty.
- Node.js (v12 or above)
- npm (comes with Node.js)
- Clone the Repository:
git clone https://github.com/neuralsorcerer/bubble-game.git
- Navigate to the Project Directory:
cd bubble-game
- Install Dependencies:
npm install
npm run dev
Open your browser and navigate to http://localhost:5173
to play the game.
npm run build
The optimized production build will be in the dist
folder.
- React - A JavaScript library for building user interfaces.
- TypeScript - A typed superset of JavaScript.
- Vite - A fast build tool and development server.
- Tailwind CSS - A utility-first CSS framework.
- use-sound - A React hook for playing sound effects.
This project is licensed under the MIT License.