Candy Cascade — Complete Match-3 Puzzle Game in Flutter + Flame

Candy Cascade is a fully-featured, production-ready Match-3 puzzle game built entirely with Flutter and the Flame 2D game engine. It is designed to be purchased, customized, and published to the Google Play Store or Apple App Store with minimal effort. No backend server, database, or API key is required — the game runs fully offline using SharedPreferences for all persistence.

The source code follows a clean, layered architecture (Presentation → Domain → Core) with no third-party state management libraries. Everything is in pure Dart, making the codebase easy to understand, extend, and maintain.

Key Features

• 500+ Campaign Levels — Procedurally generated via a deterministic seed algorithm across 5 progressive worlds. No hardcoded level data to maintain.
• Endless Mode — Infinite play with score multiplier cascades and persistent high-score tracking.
• 4 Special Candy Types — Striped Horizontal, Striped Vertical, Wrapped, and Color Bomb, each with distinct activation rules and combo chain reactions.
• 6 Obstacle Types — Jelly, Ice, Chocolate, Chain, Crate, and Stone. Each obstacle has unique clearing mechanics and interaction rules.
• 8 Booster Types — Hammer, Shuffle, Bomb, Extra Moves, Color Bomb, Rainbow Candy, Double Score, and Time Freeze.
• In-Game Economy — Full coin system with a purchasable booster shop and 7-day daily login reward streak.
• Rewarded Ad Integration Ready — A clean AdService stub is included. Swap the body with your Google Mobile Ads SDK calls to go live.
• BGM + SFX Audio System — Fully procedural audio synthesized at runtime (no external audio files required). Includes volume sliders, mute toggles, and proper app lifecycle pause/resume handling.
• Persistent Progress — All coins, booster inventory, level stars, and settings are saved locally via SharedPreferences. No server needed.
• 60fps Flame Board Rendering — The 8×8 game board is rendered using the Flame game engine for smooth animations, tap/drag input handling, and particle effects.
• Full Rename Guide Included — A complete step-by-step guide (HTML documentation) is included to rename the app, change the bundle ID, and rebrand all assets for your own product.
• Android and iOS Ready — Portrait-only orientation lock configured for both platforms. Android signing setup and iOS provisioning steps are fully documented.

Game Modes

• Campaign Mode — Players progress through 500+ levels with increasing difficulty. Each level has a specific objective (score target, jelly clear, ice clear, chocolate clear, candy collection, or timed challenge) and awards 1 to 3 stars based on performance.
• Endless Mode — No level limit. Players make moves until they run out. Score multipliers increase with combo chains. Personal best is saved automatically.

Technical Specifications

• Language: Dart 3.x
• Framework: Flutter 3.10.0 or higher
• Game Engine: Flame 1.35.1
• Minimum Android SDK: API 21 (Android 5.0 Lollipop)
• Target Android SDK: API 34
• iOS Minimum Deployment Target: iOS 12
• Xcode Required (iOS builds): Xcode 15 or higher (macOS only)
• State Management: Pure Dart ChangeNotifier — no external state management library
• Storage: SharedPreferences only — fully offline, no backend
• Audio: Procedurally generated WAV at runtime using audioplayers ^6.7.1

Dependencies

• flame ^1.35.1 — 2D game engine for board rendering
• shared_preferences ^2.5.5 — local persistent storage
• audioplayers ^6.7.1 — BGM and SFX playback
• google_fonts ^6.2.1 — custom typography
• cupertino_icons ^1.0.8 — iOS-style icons

What Is Included

• Complete Flutter project source code (all Dart files, assets, and configuration)
• Full HTML developer documentation covering architecture, all game systems, rename guide, Android and iOS signing setup, and troubleshooting
• App icon source file (1024×1024 PNG) with flutter_launcher_icons configuration
• Android and iOS platform folders, pre-configured and ready to build
• pubspec.yaml, pubspec.lock, and analysis_options.yaml

What Is NOT Included

• Live AdMob ad unit IDs — the AdService is a ready stub. You must supply your own AdMob account and unit IDs.
• Backend server or database — intentionally excluded. The game is fully offline by design.
• External audio or image assets — all audio is synthesized at runtime; all visuals are rendered in Flutter/Flame.

Documentation

A complete HTML documentation file is included in the download. It covers:

• Quick start and installation steps
• Full project rename and rebrand guide (automated and manual methods)
• File structure and architecture overview
• In-depth explanation of all game systems (mechanics, levels, special candies, obstacles, boosters, economy, audio, storage)
• Controllers API reference and data model reference
• Android signing and release build setup
• iOS signing and provisioning setup
• Android Studio GUI guide
• Troubleshooting common build issues

Support

Support is provided via email. If you have questions about setup, customization, or encounter any issues, contact us at smllbrnstdspprt@gmail.com. Please include your purchase code when reaching out.

We typically respond within 24 to 48 hours on business days.

Credits

• Game audio is procedurally synthesized at runtime — no third-party audio assets used.
• All visual components are rendered using Flutter widgets and Flame canvas — no third-party image assets used.
• Fonts are loaded from Google Fonts via the google_fonts package (Inter and Roboto families).