In
- 0
- 576 words

<!DOCTYPE html>
<html lang=”en”>
<head>
<meta charset=”UTF-8” />
<title>Bubble Blast | Flutter Mobile Game</title>
</head>
Bubble Blast | Flutter Mobile Game
Bubble Blast is a premium, fully-featured Bubble Shooter mobile game
built entirely with Flutter and pure Dart — no third-party game engine required.
It ships with 225 procedurally generated levels, a real-time programmatic
audio engine, 4 power boosters, an in-game coin shop, 3 bubble skin themes,
and a daily lucky spin wheel. The project is clean, well-commented, and
publish-ready for both Google Play and the Apple App Store.
Features
Core Gameplay
- 225 Procedurally Generated Levels — 5 difficulty tiers from Easy to Expert. Every level is generated at runtime from a deterministic seed, so there is zero storage overhead and the layouts are always consistent.
- Precision Aim & Shoot — Smooth touch-drag aiming with a real-time aim-line guide and physics-accurate wall bouncing.
- 3-Star Rating Per Level — Stars are awarded based on remaining moves. Win and Lose overlays display stars earned, coins collected, and Retry / Next Level options.
- Combo & Strike Score System — Chaining large pop sequences builds score multipliers. Real-time score popup labels fly from the grid to communicate combo magnitude.
- Particle Burst & Gravity Drop Animations — Bubble pops trigger smooth particle-burst effects. Disconnected clusters fall with physics-based gravity animations at a buttery-smooth 60fps via Flutter’s Ticker.
Power Boosters
- Bomb — Explodes on impact and destroys all bubbles within a large radius. (150 coins)
- Fireball — Burns through every bubble in a straight line with no stopping. (200 coins)
- Rainbow — Removes all bubbles of any single color from the entire grid. (250 coins)
- Laser — Fires a precision beam that destroys a complete row of bubbles. (100 coins)
Progression & Rewards
- In-Game Coin Shop — Two-tab shop: Boosters and Bubble Skins. Players earn coins by completing levels and can spend them on power-ups or cosmetic skins.
- Daily Lucky Spin Wheel — 8-sector wheel rewarding 50–500 coins or a random booster (Bomb, Fireball, Rainbow, Laser). One free spin per day to encourage daily retention.
- 3 Bubble Skin Themes — Jewel (800 coins), Neon (1200 coins), and Candy (1500 coins). Each skin changes the visual style of all bubbles in the game.
- Persistent Player Progress — All data (level progress, coins, owned boosters, active skin, mute state, last spin date) is saved via SharedPreferences and restored on every launch.
Audio & UI
- Programmatic Synthesized Audio — All sound effects and background music are generated in real-time using Dart WAV synthesis. No audio asset files needed — lightweight and low-latency on physical devices.
- Mute / Unmute Toggle — Accessible on both the Home screen and the Game screen. State is persisted across sessions.
- Animated Home Screen — Floating candy-bubble background, animated logo with glow pulse, smooth button slide-in transitions, and a coins indicator.
- Responsive Portrait Layout — Works on all phone screen sizes from 5-inch Android phones to 6.7-inch Pro Max iPhones. Locked to portrait mode for consistent gameplay.
Level Breakdown
| Tier | Levels | Grid | Colors | Max Moves | Difficulty |
|---|---|---|---|---|---|
| Starter | 1 – 15 | 8×7–10 rows | 4 | 28–32 | Easy |
| Beginner | 16 – 40 | 9×8–13 rows | 4–5 | 24–30 | Easy – Medium |
| Intermediate | 41 – 80 | 9×9–16 rows | 5–6 | 18–28 | Medium |
| Advanced | 81 – 130 | 10×10–16 rows | 6–7 | 15–22 | Hard |
| Expert | 131 – 225 | 10×12–18 rows | 7 | 12–18 | Expert |
What’s Included
- Full Flutter source code for Android and iOS
- Well-commented, clean, layered architecture
- High-resolution app icon
- Pre-configured
build.gradle.ktswith release signing support - App Store compliant
Info.plist(portrait-only) - Detailed documentation covering: package name change, Android keystore setup, iOS provisioning, and troubleshooting common errors
Technology
- Framework: Flutter 3+ / Dart 3+
- Packages: audioplayers, shared_preferences, path_provider, google_fonts
- Rendering: Custom Flutter Canvas API — no game engine
- Audio: Programmatic WAV synthesis in pure Dart
- Grid Logic: Hex grid algorithm in pure Dart
- State: Ticker-based physics loop + setState
Requirements
- Flutter SDK 3.x or higher
- Dart SDK 3.x or higher
- Android: minSdk 21+, compileSdk 36, JDK 17
- iOS: Xcode 15+, iOS 12+
