Candy Cascade | Flutter Match-3 Puzzle Game

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