GitHunt
PE

petrbrzek/bubble-pop

Macaly chat https://www.macaly.com/chat/i4yypy7pqhv9yh1yij3tcct1

๐Ÿซง Bubble Pop

Bubble Pop Game

A relaxing and satisfying bubble popping experience

View on GitHub

โœจ Features

  • Beautiful Translucent Bubbles - Colorful, shimmering bubbles with realistic highlights
  • Two Ways to Pop - Tap directly on bubbles or swipe through multiple bubbles Fruit Ninja style
  • Satisfying Visual Effects - Smooth animations, colorful swipe trails, and satisfying pop effects
  • Immersive Audio - Delightful sound effects that respond to your interactions
  • Challenge Yourself - 60-second timer with score tracking and high score recording
  • Milestone Celebrations - Special notifications when you reach bubble popping milestones

๐ŸŽฎ How to Play

  1. Start the Game - Press the "Start Game" button to begin
  2. Pop Bubbles - Tap directly on bubbles to pop them one by one
  3. Swipe Through Bubbles - Drag your finger or mouse across the screen to create a slicing motion
  4. Combo Pops - Slice through multiple bubbles at once for combo points
  5. Beat Your High Score - Try to pop as many bubbles as possible within 60 seconds

๐Ÿš€ Getting Started

# Clone the repository
git clone https://github.com/petrbrzek/bubble-pop.git

# Navigate to the project directory
cd bubble-pop

# Install dependencies
npm install

# Start the development server
npm run dev

Open http://localhost:3000 in your browser to play the game.

๐Ÿ› ๏ธ Technologies Used

  • Next.js - React framework for the application
  • Framer Motion - For smooth animations and transitions
  • Tone.js - For programmatic sound generation
  • Tailwind CSS - For styling and responsive design
  • shadcn/ui - For UI components

๐ŸŽจ Customization

Feel free to customize the game by modifying:

  • Bubble colors and sizes in components/BubbleGame.tsx
  • Sound effects in lib/audio.ts
  • Game duration and scoring in components/BubbleGame.tsx
  • Visual effects in components/SwipeTrail.tsx and components/ActiveSwipeTrail.tsx

๐Ÿ“ฑ Responsive Design

Bubble Pop is designed to work on both desktop and mobile devices:

  • Use your mouse to pop bubbles on desktop
  • Use your finger to tap and swipe on mobile devices
  • Enjoy the same satisfying experience across all devices

๐Ÿค Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve the game.

๐Ÿ“„ License

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


Created with โค๏ธ for relaxation and fun

Enjoy popping bubbles!

Built with Macaly - The AI-powered web app builder

View on GitHub

petrbrzek/bubble-pop | GitHunt