No description
  • Dart 96.2%
  • Swift 3.2%
  • Kotlin 0.5%
  • Objective-C 0.1%
Find a file
2026-05-10 09:23:58 +02:00
android Made simple baloon game 2026-05-03 16:15:46 +02:00
ios Made simple baloon game 2026-05-03 16:15:46 +02:00
lib Improved the game 2026-05-10 09:23:58 +02:00
test Made simple baloon game 2026-05-03 16:15:46 +02:00
.gitignore Made simple baloon game 2026-05-03 16:15:46 +02:00
.metadata Made simple baloon game 2026-05-03 16:15:46 +02:00
analysis_options.yaml Made simple baloon game 2026-05-03 16:15:46 +02:00
GEMINI.md Made simple baloon game 2026-05-03 16:15:46 +02:00
guidelines.md Made simple baloon game 2026-05-03 16:15:46 +02:00
pubspec.lock Made simple baloon game 2026-05-03 16:15:46 +02:00
pubspec.yaml Made simple baloon game 2026-05-03 16:15:46 +02:00
README.md Made simple baloon game 2026-05-03 16:15:46 +02:00

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 Semantics support 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

  1. Clone the repository.
  2. Run flutter pub get to install dependencies (including go_router).
  3. Launch the app using flutter run.

Developed with modern Flutter best practices.