Number Puzzle – Android Game Source Code

Premium sliding puzzle game • Wooden UI • Multiple modes • Power-ups • Full AdMob monetization • 100% Kotlin + Jetpack Compose

Number Puzzle is a polished, feature-rich sliding puzzle game for Android with beautiful wooden aesthetics, multiple board sizes, and complete monetization through AdMob. This fully documented source code is perfect for developers who want to publish a professional puzzle game quickly—or learn modern Android development best practices.

Slide numbered tiles to arrange them in order—a classic brain-teaser that’s easy to learn but challenging to master! With multiple modes, daily challenges, power-ups, rewards, themes, and a complete in-app economy, this project delivers hours of engaging gameplay.

✨ Key Features

Game Modes

• Classic Mode — solve puzzles at your own pace (no time pressure)
• Time Attack — race against the clock for bonus rewards
• Daily Challenge — a new puzzle every day
• Marathon Mode — continuous puzzles with increasing difficulty

Board Sizes

• 3×3 (Beginner)
• 4×4 (Intermediate)
• 5×5 (Advanced)
• 6×6 (Expert)

Complete In-App Economy

• Coin system with rewards for completing puzzles
• Shop with power-ups and hints
• Daily login rewards with streak bonuses
• Rewarded ads to earn coins
• Theme unlocking system

Beautiful Themes

• Classic Wood (Default)
• Dark Walnut
• Candy
• Neon Cyber
• Space Galaxy
• Minimal

All themes are fully customizable with simple color configuration.

⚡ Power-Ups & Hints

• Hint System — suggest move, auto-step, preview path
• Undo — take back your moves
• Safe Shuffle — reshuffle without breaking solvability
• Swap Tiles — swap any two tiles
• Auto Play — automatically solves the next five moves
• Freeze Time — pause the timer in Time Attack mode

Monetization (AdMob)

• Banner Ads — displayed in the shop screen
• Interstitial Ads — smart frequency control (shown after games)
• Rewarded Ads — watch ads to earn coins
• Supports both test and production ad units
• Easy AdMob setup via AppConfig.kt

Statistics & Progress

• Total games played and won
• Win rate calculation
• Average moves and time
• Daily streak tracking
• Best scores for each board size
• Complete history stored with Room database

Polish & UX

• Smooth tile sliding animations
• Confetti celebration on win
• Haptic feedback (vibration)
• Sound effects
• Pause / resume functionality
• Edge-to-edge modern Android UI

️ Technical Specifications

Architecture & Code Quality

• 100% Kotlin — modern, type-safe code
• Jetpack Compose — declarative UI
• MVVM Architecture — clean, maintainable structure
• Room Database — local persistence
• DataStore — preferences management
• Coroutines & Flow — async operations and reactive state
• Material Design 3 — modern UI components

Comprehensive Documentation

• ✅ Every function commented for easy understanding
• ✅ AppConfig.kt — centralized configuration file with detailed notes
• ✅ RESKIN_MANUAL.md — step-by-step customization guide
• ✅ Inline explanations designed for learning while customizing

Android Compatibility

• Minimum SDK: 24 (Android 7.0)
• Target SDK: 36 (Android 14+)
• Devices: phones and tablets
• Orientation: portrait
• Localization: translation-ready (easy to add languages)

What’s Included

Source Code

• Complete Android Studio project
• All Kotlin source files with comprehensive comments
• Gradle build scripts
• ProGuard configuration

Documentation

• RESKIN_MANUAL.md — complete customization guide
• README.md — quick start guide
• Inline code comments for every class and function
• AppConfig.kt — centralized configuration with explanations

Assets

• Adaptive + legacy app icons
• Sound effects
• Wooden texture graphics
• All UI resources

Implemented Features

• Four game modes
• Six themes
• Complete shop system
• Daily rewards system
• Statistics tracking
• AdMob integration
• Power-ups and hints
• Smooth animations

Perfect For

• ✅ Developers who want to publish a puzzle game quickly
• ✅ Learning modern Android development (Compose, MVVM, Room)
• ✅ Creating passive income apps with ads
• ✅ Building a portfolio project
• ✅ White-label customization and reselling

Easy Customization

Change in Minutes

• App name and branding
• App icon
• Colors and themes
• AdMob IDs
• Coin rewards and economy
• Game difficulty
• Enable/disable features

Centralized Configuration

Everything is configured in AppConfig.kt with detailed comments:

// Change app branding const val APP_NAME = "Your App Name"  const val DEVELOPER_NAME = "Your Company"   // Adjust coin economy const val INITIAL_COINS = 5000 const val COINS_REWARD_4X4 = 20  // Configure AdMob const val ADMOB_BANNER_ID = "your-ad-unit-id"   // And much more... 

Requirements

To Customize & Build

• Android Studio (Arctic Fox or newer)
• JDK 11 or higher
• Basic Android development knowledge

To Publish

• Google Play Developer Account ($25 one-time fee)
• AdMob account (free)
• Privacy Policy URL (recommended if using ads)

Monetization Potential

This app is designed for monetization from day one:

• Ads — banner, interstitial, and rewarded ads with smart frequency control
• In-App Purchases — easy to add (project structure supports it)
• Premium Version — remove ads option (easy to implement)

Revenue varies based on marketing and traffic, but puzzle games with ads can generate approximately $100–$500/month with a moderate user base.

Learning Value

Even if you’re not publishing, this codebase is an excellent learning resource:

• Modern Android development with Jetpack Compose
• MVVM architecture pattern
• Room database implementation
• AdMob integration
• State management with Flow
• Compose animations
• DataStore preferences
• Clean code practices

Screenshots

Demo includes 8+ screenshots showcasing:

• Home screen with game modes
• Gameplay on different board sizes
• Shop with power-ups
• Themes gallery
• Daily rewards
• Statistics screen
• Settings screen
• Win celebration

Updates & Support

What You Get

• Complete, working source code
• Comprehensive documentation
• Free updates (bug fixes)

Additional Services Available

• ✨ Custom Graphics & Themes — make it truly unique
• ⚙️ Advanced Customization — add custom features
• Play Store Upload — we can publish it for you
• iOS Version — Swift/SwiftUI version available

Contact us:
choochai.t@chatstickmarket.com
www.chatstickmarket.com

❓ FAQ

• Q: Is this easy to customize?
  A: Yes. Most settings are in AppConfig.kt, and the RESKIN_MANUAL.md provides step-by-step instructions.
• Q: Do I need to know Kotlin/Compose?
  A: Basic knowledge helps, but the project is heavily commented and great for learning.
• Q: Can I publish this on Google Play?
  A: Yes. Customize branding, add AdMob IDs, update the package name, and publish.
• Q: Are ads included?
  A: Yes. AdMob banner, interstitial, and rewarded ads are implemented—just add your ad unit IDs.
• Q: Can I resell this?
  A: It’s white-label ready for publishing under your brand. (Follow marketplace/license rules for source code resale.)
• Q: Will this work on tablets?
  A: Yes. The UI is responsive and works on phones and tablets.
• Q: Can I add more languages?
  A: Yes. The reskin manual includes instructions for adding translations.
• Q: Is the code documented?
  A: Extensively—every class and function includes detailed comments.

Why Choose This Source Code?

• ✅ Production-Ready — fully-featured and polished for release
• ✅ Modern Tech Stack — Compose, MVVM, Room, Coroutines
• ✅ Comprehensive Documentation — every function explained
• ✅ Easy Customization — centralized config + reskin guide
• ✅ Monetization Built-In — AdMob fully implemented
• ✅ Clean Code — organized structure and best practices
• ✅ White Label Ready — no hardcoded branding

Changelog

• Version 1.0.0 (Initial Release)
• Complete game implementation with four modes
• Six themes
• Full AdMob integration
• Shop and in-app economy
• Daily rewards system
• Statistics tracking
• Power-ups and hints
• Comprehensive documentation
• AppConfig.kt for fast customization

Contact & Support

Email: choochai.t@chatstickmarket.com
Website: www.chatstickmarket.com

We offer:

• Technical support for customization
• Custom development services
• Graphic design services
• Play Store publishing assistance

Bonus

• ✅ Lifetime access to source code
• ✅ Free bug fix updates
• ✅ Comprehensive documentation
• ✅ Email support for setup questions
• ✅ AppConfig.kt with 100+ customization options

Get Started Today

Transform this beautiful puzzle game into your own branded app and start earning with ads. With comprehensive documentation and easy customization, you can have your app on the Play Store in just a few days.

Download & Build Your Version

Perfect for solo developers, indie studios, app resellers, and anyone who wants to publish a high-quality puzzle game.