Color Sort Puzzle is a complete, ready-to-publish Android game built with modern Kotlin and Jetpack Compose. Players sort colored balls into tubes across 200 handcrafted levels with increasing difficulty.

The game features stunning 3D ball rendering using Canvas API, with realistic lighting, shadows, and specular highlights. Each level introduces new challenges including frozen balls that can't be moved, mystery balls with hidden colors, and move limits that force strategic thinking.

The difficulty curve is carefully designed — colors increase from 3 to 12, empty tubes decrease, and special mechanics are introduced progressively. The game includes 8 chapters with unique themes.

Monetization is built-in with AdMob integration: banner ads, interstitial ads every 3 levels, and rewarded ads for extra tubes and undo moves. Players get 2 free undos per level and 1 free extra tube per day, then must watch ads — a proven monetization model.

The game supports both English and Arabic languages with full RTL support. Clean architecture makes it easy to reskin, add languages, or modify levels.

Built entirely from scratch with no third-party game engines — pure Kotlin and Jetpack Compose.

• 200 handcrafted levels with progressive difficulty
• Beautiful 3D ball rendering with Canvas API (no game engine needed)
• 12 maximally distinct ball colors
• Frozen balls mechanic — balls that can't be moved
• Mystery/hidden balls — tap to reveal the color
• Move limit challenges on advanced levels
• 5 difficulty levels: Easy, Normal, Hard, Expert, Insane
• 8 themed chapters with descriptions
• Tube completion animation with sparkle particles and glow effects
• 2 free undos per level, then rewarded ad
• 1 free extra tube per day, then rewarded ad
• AdMob integration: Banner, Interstitial & Rewarded Ads
• Bilingual: English & Arabic with full RTL support
• Dark neon theme with glass tube effects
• Animated main menu with floating bubbles
• Level select screen with star ratings and chapter tabs
• Settings screen: language, sound, vibration
• Level progress saved locally with SharedPreferences
• Reverse-solve algorithm guarantees every level is solvable
• Clean MVVM architecture
• Easy to reskin and customize
• Ready to publish on Google Play Store

• Android Studio Hedgehog or newer
• Kotlin 2.0+
• Minimum SDK: Android 8.0 (API 26)
• Target SDK: Android 15 (API 35)
• Jetpack Compose BOM 2025.02.00
• Google Play Services Ads 23.6.0
• Gradle 8.10.2
• JDK 17 (included in Android Studio)

Step 1: Extract the ZIP file and open the project in Android Studio.

Step 2: Wait for Gradle sync to complete (may take 2-3 minutes on first open).

Step 3: Replace AdMob IDs with your own:
- Open app/src/main/java/com/colorsort/puzzle/ads/AdManager.kt
- Replace INTERSTITIAL_AD_UNIT_ID with your interstitial ad unit ID
- Replace REWARDED_AD_UNIT_ID with your rewarded ad unit ID
- Open app/src/main/AndroidManifest.xml
- Replace the com.google.android.gms.ads.APPLICATION_ID value with your AdMob App ID

Step 4: Change the package name:
- Right-click on com.colorsort.puzzle → Refactor → Rename

Step 5: Replace the app icon:
- Replace files in app/src/main/res/mipmap-* folders

Step 6: Build and run:
- Click Run or use: ./gradlew assembleRelease

The game is ready to publish on Google Play Store!