Overview

Hexa Mosaic is a complete, original hexagonal exact-fill block puzzle built with Flutter, the Flame engine and BLoC. Players drag every piece from the tray onto a hex board to fill it perfectly, with no gaps and no overlaps. Every level is generated from a seed and re-verified by an exact-cover solver, so there are 1,200 campaign levels plus daily, endless, time-attack and hardcore boards that are always solvable. Coins, power-ups, daily rewards, achievements, themes and a shop are included, with AdMob, in-app purchases and Firebase wired in as optional, guarded integrations. The same code runs on Android and in the browser; an iOS project is included.

Key features

Puzzle gameplay

• Drag-and-drop pieces with a live placement ghost, snap-to-grid and shake-back for invalid drops (touch and mouse)
• Hex boards of 19, 37 or 61 cells in hexagon, trimmed-hexagon and triangle shapes; difficulty tiers from Tutorial to Impossible
• Procedural generator + exact-cover solver: 1,200 seeded campaign levels in 30-level chapters with 1–3 stars
• Smart hints that solve the live board and reveal a real next move (or report that the board is stuck)
• Power-ups: Hint, Undo, Shuffle, Bomb (returns a placed piece) and Magic Fill (places a correct piece)
• Responsive tray that switches to 2–3 rows so every piece stays reachable on any phone

Six game modes

• Classic campaign and Adventure (a second seeded campaign)
• Daily Challenge (the same board for every player each day)
• Endless with adaptive difficulty, Time Attack with a countdown, Hardcore without undo or hints

Progression, economy & polish

• Coins, diamonds, stars and XP levels; 7-day daily login rewards and a lucky spin
• 10 claimable achievements, detailed statistics and a profile with avatar and name
• Shop with offers, coin packs, a hint pack, coin-priced power-ups and 8 colour themes
• Local leaderboard against practice rivals (All-Time and This Week)
• Material 3 glass UI, dark/light/system theme, confetti, haptics, synthesised music and sound effects, colour-blind palette and high-contrast mode
• Offline-first save system with Hive; works without any account

What's included

• Full Flutter source code (about 14,000 lines of Dart in 100 files) for Android and Web, plus an iOS project
• 47 unit and widget tests (hex maths, solver, generator, game rules, models), golden tests and an integration boot test
• README with a step-by-step guide: rebranding (package id, name, icon, themes), Firebase, AdMob, in-app products, tuning, signing, web build, known limitations and troubleshooting
• Architecture, game-design, integrations and store-checklist docs; GitHub Actions CI workflow
• Original code-drawn app icon with its generator script, synthesised audio with its generator, a hand-made Lottie animation
• key.properties signing template with a debug-key fallback, LICENSE and CHANGELOG; no private keys, Google test ad IDs only

Tech stack

• Flutter 3.41+ (tested on Flutter 3.47.4), Dart 3.11+, Flame 1.37, flutter_bloc 9, get_it, Hive
• Ads: google_mobile_ads 9; IAP: in_app_purchase 3.3
• Firebase: Core, Analytics, Crashlytics, Remote Config, Cloud Messaging (optional)
• google_fonts, confetti, lottie, url_launcher, package_info_plus
• Android: AGP 8.11, Kotlin 2.2, Gradle 8.14, Java 17

Requirements

• Flutter SDK 3.41 or newer, Android Studio or VS Code, JDK 17
• Optional: your own Firebase project, AdMob account and Google Play Console / App Store Connect account for in-app products
• The iOS project is included but was not built or tested by us (no Mac); Android and Web were built and tested

Setup in minutes

• Run flutter pub get, then flutter run -d chrome or flutter run on Android: it works offline with Google test ads
• Change the placeholder package id com.yourcompany.hexamosaic, the app name and (optionally) recolour the icon with the included script
• Run flutterfire configure and add the Google services Gradle plugin to enable Firebase
• Put your AdMob IDs in the manifest, Info.plist and ad_config.dart, and create the listed product IDs in your store
• Add your keystore to android/key.properties and run flutter build appbundle --release

Monetization (ads/IAP)

• AdMob banner on the home screen and an interstitial after finished levels (every 3 levels, at least 90 seconds apart); rewarded and app-open ad loaders are implemented for you to place
• Ads switch off automatically for players who own Remove Ads or VIP
• In-app purchases: Starter Pack, Remove Ads, VIP, coin packs (500 / 1,500 / 5,000) and a 10-hint pack, with rewards granted in the app
• Coins are also earned by playing and spent on hints, undos, bombs, magic fills and themes

Support & updates

Support is provided through the Aadhya Infotech DevStore: https://www.aadhya-infotech.com/DevStore/contact. Bug-fix updates for this package are published on the DevStore. Firebase, AdMob and in-app products are connected to your own accounts; please read the “Known limitations” section of the README before you publish.