{"id":22031876,"url":"https://github.com/chmuhammadasim/betteraim-react","last_synced_at":"2026-05-04T19:32:34.866Z","repository":{"id":258154118,"uuid":"865902928","full_name":"chmuhammadasim/BetterAim-React","owner":"chmuhammadasim","description":"Balloon Pop is a delightful web-based game built using React, where players aim to pop as many colorful balloons as possible while managing a timer and lives","archived":false,"fork":false,"pushed_at":"2024-10-27T10:02:51.000Z","size":490,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-28T18:16:00.784Z","etag":null,"topics":["balloon-popping-game","game","react","reactgame"],"latest_commit_sha":null,"homepage":"https://better-aim-react.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chmuhammadasim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-01T10:21:52.000Z","updated_at":"2024-10-27T10:02:54.000Z","dependencies_parsed_at":"2024-11-30T08:28:14.371Z","dependency_job_id":"1d50f4d5-6b31-40a3-a5b9-31819abd1a0e","html_url":"https://github.com/chmuhammadasim/BetterAim-React","commit_stats":null,"previous_names":["chmuhammadasim/betteraim-react"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmuhammadasim%2FBetterAim-React","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmuhammadasim%2FBetterAim-React/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmuhammadasim%2FBetterAim-React/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmuhammadasim%2FBetterAim-React/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chmuhammadasim","download_url":"https://codeload.github.com/chmuhammadasim/BetterAim-React/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245097852,"owners_count":20560317,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["balloon-popping-game","game","react","reactgame"],"created_at":"2024-11-30T08:24:01.984Z","updated_at":"2026-05-04T19:32:29.826Z","avatar_url":"https://github.com/chmuhammadasim.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎉 Balloon Pop Game\n\n**Balloon Pop** is a delightful web-based game built using React, where players aim to pop as many colorful balloons as possible while managing a timer and lives. The game includes exciting features such as various power-ups, increasing difficulty levels, and engaging sound effects, making it an entertaining experience for users of all ages.\n\n**Live:**\nhttps://better-aim-react.vercel.app/\n\n## Table of Contents\n\n- [Features](#features)\n- [Technologies Used](#technologies-used)\n- [Getting Started](#getting-started)\n- [How to Play](#how-to-play)\n- [Game Mechanics](#game-mechanics)\n- [Customization Options](#customization-options)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n\n- **Engaging Gameplay**: Players pop balloons that rise from the bottom of the screen while trying to prevent them from escaping.\n- **Variety of Balloons**: Different types of balloons, including bonus balloons that provide power-ups.\n- **Power-Ups**: Encounter special balloons that grant players various power-ups, enhancing gameplay.\n- **Levels and Difficulty**: The game becomes more challenging as players advance through levels, with balloons moving faster and becoming smaller.\n- **Sound Effects**: Enjoy realistic sound effects when popping balloons and activating power-ups, creating an immersive experience.\n- **Responsive Design**: The game is playable on various devices, including desktops, tablets, and smartphones.\n- **High Score Tracking**: The game saves the highest score in the browser's local storage for competitive play.\n\n\n## Technologies Used\n\n- **React**: A JavaScript library for building user interfaces.\n- **CSS**: For styling the game components.\n- **JavaScript**: For game logic and interactivity.\n- **Audio**: Used for sound effects (pop sound).\n- **React Icons**: For displaying icons in the user interface.\n\n## Getting Started\n\nTo run this project locally, follow these steps:\n\n### Prerequisites\n\nEnsure you have the following installed:\n\n- [Node.js](https://nodejs.org/) (v14 or higher recommended)\n- [npm](https://www.npmjs.com/) (comes with Node.js)\n\n### Installation\n\n1. **Clone the repository**:\n\n   ```bash\n   git clone [https://github.com/your-username/balloon-pop.git](https://github.com/chmuhammadasim/BetterAim-React.git)\n   cd balloon-pop\n   ```\n\n2. **Install dependencies**:\n\n   ```bash\n   npm install\n   ```\n\n3. **Start the development server**:\n\n   ```bash\n   npm start\n   ```\n\n4. **Open your browser** and navigate to `http://localhost:3000` to play the game!\n\n## How to Play\n\n1. **Objective**: Pop as many balloons as you can within the time limit while managing your lives.\n2. **Controls**:\n   - Click on the balloons to pop them.\n   - Use the pause button to pause the game.\n   - Toggle sound effects with the sound button.\n3. **Scoring**: \n   - Each regular balloon gives you 10 points.\n   - Bonus balloons provide extra points (20 points).\n   - Collect power-ups for additional benefits.\n4. **Game Over**: The game ends when you run out of lives. You can then restart the game.\n\n## Game Mechanics\n\n### Balloons\n\n- **Regular Balloons**: These balloons have no special properties and provide standard points.\n- **Bonus Balloons**: These balloons have a 10% chance of appearing and can grant additional points or power-ups.\n\n### Power-Ups\n\nWhen players pop bonus balloons, they can receive various power-ups:\n\n- **Extra Time**: Adds 5 seconds to the remaining time.\n- **Slow Motion**: Temporarily slows down the balloon movement for 5 seconds.\n- **Freeze**: Freezes balloons in place for 5 seconds, preventing them from escaping.\n- **Double Score**: Doubles the player's score for 10 seconds.\n- **Extra Life**: Grants an additional life, allowing players to continue playing.\n\n### Lives\n\n- Players start with **3 lives**. If a balloon escapes, a life is lost. The game ends when all lives are depleted.\n- Players can collect power-ups that can restore or increase lives.\n\n### Levels\n\n- Players start at level 1. With every 10 combos of balloon pops, they advance to the next level, which increases the difficulty:\n  - **Speed**: Balloons rise faster.\n  - **Size**: Balloons become smaller and harder to click.\n\n## Customization Options\n\n### Themes and Styles\n\n- You can customize the game's visual appearance by modifying the CSS styles:\n  - Change balloon colors, backgrounds, and animations to create a unique visual experience.\n  - Update the balloon emojis or images for different themes (e.g., Halloween, Christmas, etc.).\n\n### Sound Effects\n\n- To customize sound effects:\n  - Replace the existing pop sound (`pop-sound.mp3`) with your own sound file while maintaining the same file format.\n\n### Difficulty Settings\n\n- You can adjust the game's difficulty settings by modifying the speed, balloon size, and power-up probabilities in the game logic.\n\n## Contributing\n\nContributions are welcome! If you have suggestions for improvements or features, feel free to open an issue or submit a pull request.\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-branch`).\n3. Make your changes and commit them (`git commit -m 'Add new feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor any inquiries or feedback, feel free to reach out:\n\n- **Your Name**: [your-email@example.com](mailto:muhammadasimchattha@gmail.com)\n- **GitHub**: [your-github-username](https://github.com/chmuhammadasim)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmuhammadasim%2Fbetteraim-react","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchmuhammadasim%2Fbetteraim-react","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmuhammadasim%2Fbetteraim-react/lists"}