Fruit Crush

🍓 Fruit Crush — Swipe, Match & Clear! 🍓

Fruit Crush is a bright and playful match-3 puzzle game. Pick a level, swap neighboring fruits on a 6×6 board, and create lines of 3 or more matching fruits. Clear the target score before your moves run out and enjoy smooth swap, clear, drop, and spawn animations.

🎮 Gameplay
• Choose a level before entering the game board
• Swipe a fruit into a neighboring spot to swap positions
• Match 3 or more fruits horizontally or vertically to clear them
• Cleared fruits fall down, new fruits enter from the top, and cascades continue automatically
• Reach the target score before running out of moves

✨ Special Fruits
• Match 4 to create a Line fruit
• Match 5 or more to create a Rainbow fruit
• Multiple match groups can create a Bomb fruit
• Special fruits expand the clear area and help create bigger cascades

⚡ Animation System
• Entrance animation when the board first appears
• Smooth swap animation for valid moves
• Swap-back animation for invalid moves
• Scale and fade animation for cleared fruits
• Drop animation after fruits are cleared
• Spawn animation for new fruits entering from the top
• HUD micro-interactions for score, moves, and messages

🛠️ Helpers
• Hint highlights a possible move
• Shuffle refreshes the board
• Bomb clears a local area after selecting a fruit
• +5 Moves grants extra moves after a rewarded ad

🏆 Level Flow
• Home opens the Levels page
• Locked levels become available after previous levels are cleared
• Victory dialog offers Next Level or Levels
• Game Over dialog offers Retry or Levels

📚 Supporting Pages
• How to Play explains rules, special fruits, and tips
• Runs stores past game records
• Clear Runs uses a custom confirmation dialog
• Stats shows best score, runs played, and cleared levels
• Best Scores displays leaderboard results
• Settings keeps Sound and Vibration toggles

📺 Ad Integration
• TradPlus SDK is included as a standalone module
• Rewarded ad trigger: +5 Moves
• Interstitial ad triggers: Home exit and Game exit
• Remove Ads and Shop entries have been removed from the current app UI
• TradPlus App ID and ad unit placeholders must be replaced before release

⚙️ Technical Features
• Kotlin + Android View/XML
• MVVM with ViewModel and LiveData
• Room Database for history and progress
• DataStore Preferences for settings
• GridLayout-based game board
• RecyclerView-based Levels / Runs / Best Scores lists
• DialogFragment-based custom dialogs
• Material Components styling
• Edge-to-edge system bar adaptation with WindowInsetsCompat
• Android 16KB page size compatible
• minSdk 26 / targetSdk 36 / compileSdk 36
• Java 17 / Kotlin JVM target 17

📱 Current Screens
• Home: app entry, Play button, secondary feature shortcuts
• Levels: selectable level cards with stars and locked state
• Game: score, moves, stars, 6×6 fruit board, message area, power-up buttons
• How to Play: structured gameplay guide
• Runs: history list with Clear Runs confirmation dialog
• Stats: best score, runs played, cleared levels
• Best Scores: leaderboard view
• Settings: sound and vibration toggles

🏆 Game Highlights
✅ Match-3 fruit gameplay
✅ 6×6 GridLayout board
✅ Automatic 3/4/5+ match clearing
✅ Cascading clears and refill loop
✅ Line / Bomb / Rainbow special fruits
✅ Smooth swap, clear, drop, and spawn animations
✅ Level selection before gameplay
✅ Next Level / Retry / Levels result flow
✅ Runs history with custom clear confirmation
✅ Structured How to Play guide
✅ TradPlus ad integration for rewarded and interstitial scenes
✅ Candy Pop visual style
✅ Android 16KB compatible