No description
- Dart 96.2%
- Swift 3.2%
- Kotlin 0.5%
- Objective-C 0.1%
| android | ||
| ios | ||
| lib | ||
| test | ||
| .gitignore | ||
| .metadata | ||
| analysis_options.yaml | ||
| GEMINI.md | ||
| guidelines.md | ||
| pubspec.lock | ||
| pubspec.yaml | ||
| README.md | ||
Balloon Tagging
A fast-paced, interactive Flutter game where you tag rising balloons to score points and stay in the game!
🎮 Game Overview
In Balloon Tagging, your goal is simple: tag as many balloons as you can before the timer runs out. But be careful—not all balloons are friendly, and missing them has consequences!
🎈 Balloon Types
| Type | Color | Icon | Effect |
|---|---|---|---|
| Normal | Blue | - | +1 Point |
| Time Bonus | Amber | timer |
+1 Point, +5 Seconds (capped at max time) |
| Punishing | Dark Red | warning |
-5 Seconds penalty, No points |
| Freeze | Cyan | ac_unit |
+1 Point, Freezes timer for 5 seconds |
⚙️ Mechanics
- Scoring: Tap any non-punishing balloon to increase your score.
- Penalties: Letting a Normal, Time Bonus, or Freeze balloon reach the top of the screen costs you 2 seconds.
- Collisions: Balloons interact with each other! When they collide, the top one gets a speed boost while the bottom one slows down.
- Scaling Difficulty: As you level up (every 20 seconds), balloons rise faster and punishing hazards become more frequent.
🚀 Features
- Layered Architecture: Follows a clean separation of concerns (Domain, Presentation).
- Material 3 Design: Beautiful UI with harmonious color schemes, smooth animations, and responsive layouts.
- Declarative Navigation: Powered by
go_router. - Accessibility: Full
Semanticssupport for screen readers. - High Performance: Smooth 60fps simulation driven by Flutter's
Ticker.
🏗 Project Structure
lib/
├── domain/ # Business logic, models, and state management
├── presentation/ # UI layer
│ ├── screens/ # Full-page widgets (Start, Game)
│ └── widgets/ # Reusable components (BalloonArea, BalloonView, etc.)
└── main.dart # Entry point and routing
🛠 Getting Started
Prerequisites
- Flutter SDK (latest stable version recommended)
- Android Studio / VS Code with Flutter extensions
Installation
- Clone the repository.
- Run
flutter pub getto install dependencies (includinggo_router). - Launch the app using
flutter run.
Developed with modern Flutter best practices.