BlockFit | Wood Block Puzzle Flutter Game App

BlockFit – Wood Block Puzzle Flutter Game Template

BlockFit is a complete, commercial-grade 3D Wood Block Puzzle game built with Flutter. Designed with a natural wooden aesthetic, tactile polyomino packing mechanics, smooth animations, and high-retention gameplay, BlockFit is ready for instant monetization and publishing on both Google Play and the Apple App Store.

The project features 200 progressive levels across 9 difficulty tiers, a date-seeded Daily Challenge system, an intelligent backtracking AI solver for hints, a complete Google AdMob monetization suite (Banner, Interstitial, and Rewarded Video ads), organic wooden sound effects, and a comprehensive in-game coin economy.

Key Highlights

• Developed with Flutter 3.x: 100% Null Safety compliant with clean, modular architecture.
• 0 Analyzer Warnings: Fully audited codebase with zero linter errors or warnings (flutter analyze clean).
• 200 Algorithmic Levels: 9 progressive difficulty tiers from Easy to Ultimate, all 100% solvable without piece rotation.
• Daily Challenge Calendar: Date-seeded puzzles that refresh every 24 hours, encouraging daily active users.
• Interactive AI Solver: Smart backtracking algorithm that calculates the next best move and guides players.
• Full AdMob Monetization: Pre-configured Adaptive Banners, frequency-controlled Interstitials, and Rewarded Video ads.
• Single Centralized Configuration: Customize AdMob IDs, economy rewards, hint prices, and store links in one file (app_config.dart).
• Offline Responsive Documentation: Step-by-step HTML documentation covering setup, branding, AdMob, and release builds.

Monetization & AdMob Integration

Generate revenue right out of the box with official Google Mobile Ads integration:

• Adaptive Banner Ads: Seamlessly displayed at the bottom of the Home, Shop, and Gameplay screens.
• Smart Interstitial Ads: Displayed after completing levels with an easily adjustable frequency interval (e.g., every 2 levels).
• Rewarded Video Ads: High eCPM rewarded ads granting players +50 coins and +1 free hint for solving difficult levels.
• Developer Test Mode: One-tap toggle in AppConfig.isAdTestMode to prevent accidental policy violations during testing.

Core Gameplay & Features

• Tactile 3D Wooden Blocks: Realistic wood textures with beveled edges, soft drop shadows, and particle effects.
• 9 Progressive Difficulty Tiers: Easy, Normal, Hard, Expert, Master, Grandmaster, Legend, Elite, and Ultimate.
• In-Game Coin Economy & Hint Shop: Players earn coins on level completions and perfect solves, which can be redeemed for hint packs.
• 7-Day Daily Login Rewards: Modal streak calendar rewarding returning players with coins and hints.
• 8 Unlockable Achievements: Tracks milestones such as First Fit, Speed Demon, Coin Collector, and Grandmaster.
• Interactive How-to-Play Tutorial: Step-by-step illustrated guide explaining mechanics and rules.
• Audio & Haptics: Gentle looping background music, 7 realistic wooden audio sound effects, and tactile vibration on placement.

Screenshots & Live App Previews

• 01. Daily Challenge Mode: Date-seeded puzzles with multi-size grids, countdown timers, and bonus rewards.
  
  
  
  
• 02. Settings & Audio Controls: Complete user toggles for sound effects, music, vibration, and policy links.
  
  
  
  
• 03. Interactive AI Hint System: Backtracking algorithm that calculates optimal piece placements with highlighted cells.
  
  
  
  
• 04. Core Drag & Drop Gameplay: Tactile polyomino board packing, undo moves, instant restart, and timer.
  
  
  
  
• 05. Complex Multi-Color Boards: Higher-tier challenging boards featuring multi-colored wooden polyomino pieces.
  
  
  
  
• 06. Victory Dialog & Rewards: Celebration screen featuring animated confetti, stars, score, moves, and coin rewards.
  
  
  
  
• 07. Home Dashboard & Daily Streak: Clean overview with daily streak counter, continue level card, and quick mode navigation.
  
  
  
  
• 08. 200 Progressive Levels Grid: Difficulty tiers (Easy, Normal, Hard) with 3-star ratings, lock indicators, and star tally.
  
  
  
  

Folder Architecture

 lib/   core/        - AppConfig, Theme, Colors, Audio, Haptics, AdMob Services   models/      - Clean Data Models (Cell, Piece, Level, Achievement)   game_engine/ - Procedural Level Generator & Backtracking AI Solver   state/       - Persistent Game Store (SharedPreferences)   widgets/     - Modular UI Components & Custom Painters   screens/     - 15 Independent, Reusable Screen Widgets   main.dart    - Clean entry point 

What is Included in the Package?

• Complete Flutter source code (Dart).
• Pre-configured Android Studio and VS Code project structure.
• All royalty-free audio files (Background Music loop and SFX).
• High-resolution 1024×1024 App Logo and all mipmap/iOS launcher icons.
• Comprehensive offline HTML user manual.
• Full CodeCanyon marketing package (590×300 preview, 80×80 thumbnail, feature lists).
• Lifetime free updates and dedicated email support.

Technical Requirements

• Flutter SDK: Version 3.10.x or higher (compatible with Flutter 3.24+).
• Dart SDK: Version 3.0.x or higher.
• IDE: Android Studio, VS Code, or IntelliJ IDEA.
• Android Build: Minimum SDK 21 (Android 5.0 Lollipop) – Target SDK 34+.
• iOS Build: iOS 12.0 or higher (requires macOS and Xcode for compiling).

Changelog

Version 1.0.0 – Initial Release

• Initial commercial release on CodeCanyon.
• 200 solvable levels across 9 difficulty tiers.
• Daily Challenge mode with streak tracking.
• Google Mobile Ads (AdMob) Banner, Interstitial, and Rewarded Ads.
• Backtracking AI solver hint system.
• Modular architecture with 0 analyzer issues.
• Complete offline HTML documentation included.