Mini Minesweeper Lite

**Mini Minesweeper Lite — Retro Puzzle Challenge**

Mini Minesweeper Lite brings the timeless logic puzzle to mobile with a distinctive Pixel Classic visual theme. The core gameplay is pure Minesweeper: reveal safe cells, flag mines, and clear the board without triggering explosions.

**Gameplay**
- Three difficulty levels: Easy (9×9, 10 mines), Medium (12×12, 20 mines), Hard (16×16, 40 mines)
- First-tap safety: your first reveal and its 8 neighbors are guaranteed mine-free
- Number hints indicate mines in surrounding 8 cells
- Empty cells auto-expand adjacent safe areas (flood fill)
- Switch between REVEAL mode (tap to dig) and FLAG mode (tap to mark)
- Win by revealing all safe cells; lose by hitting a mine

**Goals & Limits**
- No move or time limits — focus on accuracy over speed
- Timer tracks elapsed time from first tap
- Challenge yourself to beat your personal best for each difficulty
- Unlimited retries; each game is a fresh randomly-generated board

**Assist Systems**
- Hint: watch a rewarded ad to auto-reveal one safe cell (1 per game)
- Mode toggle buttons at the bottom for REVEAL/FLAG switching
- Long-press any cell to quick-toggle flag without changing mode

**Visual Design: Pixel Classic Theme**
- 0dp rounded corners (all square buttons and cards)
- 3D beveled buttons with highlight and shadow
- 2–4dp pixel borders on all UI elements
- Monospace font for numbers and labels
- Dark background (#0D0D0D) with bright green accents (#00E436)
- ALL CAPS bold text throughout
- Emoji icons (💣 ⏱ 💡 🚩) for instant recognition
- Press feedback: 3D buttons flatten on tap

**Pages & Navigation**
- HomeActivity: 6 pixel buttons (PLAY, SETTINGS, HOW TO PLAY, HISTORY, STATS, ACHIEVEMENTS)
- GameActivity: centered square board, HUD with mine/timer counters, mode toggle, hint button
- DifficultyDialog: choose Easy/Medium/Hard before starting
- GameResultDialog: shows time, best time, new record badge
- SettingsActivity: sound, vibration, retro FX toggles
- HowToPlayActivity: 4 tutorial cards explaining numbers, flags, modes, hints
- HistoryActivity: scrollable record list with clear-all button
- StatsActivity: 11 statistics (games played, win rate, best times, perfect games)
- AchievementsActivity: 8 achievements in 2-column grid (FIRST WIN, SPEED DEMON, PERFECTIONIST, WIN STREAK 3/5, VETERAN, MASTER, HARD MODE)
- Secondary pages return to home via pixel back button; main page uses double-back to exit

**UX Notes**
- Pure multi-Activity navigation, no bottom tab structure
- Custom Pixel toolbar on all secondary pages (deep black background, 4dp green pixel border at bottom, 3D back button with ◀ arrow)
- Edge-to-edge adaptation for status bar and bottom navigation area
- Dynamic cell size calculation to center square board on screen
- Pause confirmation when backing out of an active game

**Ad Integration**
- TradPlus SDK integrated through an independent tradplus-sdk module
- Rewarded ads: Hint boost (1 per game)
- Interstitial ads: game-end return-to-home transition, capped at 3 per session
- Ad unit IDs configured in MinesweeperApp.kt and AndroidManifest.xml
- GDPR consent collection on first launch

**Data Persistence**
- SharedPreferences + Gson for history (max 100 records), statistics (11 metrics), achievements (8 unlockable), settings (3 toggles)
- No Room database; all data stored as JSON strings
- History tracks difficulty, result (win/loss), time, date
- Statistics include total/win/loss counts, win rate, best times per difficulty, tiles revealed, flags placed, perfect games
- Achievements auto-unlock based on gameplay milestones

**Technical Notes**
- Kotlin
- XML Layout
- ViewBinding
- MVVM-style state management (LiveData + ViewModel for GameActivity)
- Multi-Activity architecture
- SharedPreferences persistence (no Room)
- Java 17
- minSdk 26 / targetSdk 36 / compileSdk 36
- Android 16KB memory page alignment (`useLegacyPackaging = false`)
- Pixel Classic theme fully implemented