# Stop At | Version History

This log tracks the development milestones of the Stop At arcade app, from core mechanics to the current refactored architecture.

## Version 6.0
- **Major Feature: Special Modes**
  - Introduced **Speed Run** mode: A fast-paced timing challenge with customizable timers (30s, 60s, 90s, 120s).
  - Each hit in Speed Run is now tracked individually in the Hall of Fame.
  - Added "The Gauntlet" teaser (Coming Soon).
- **Major Feature: Full Landscape Support**
  - All screens now dynamically adapt to landscape orientation.
  - Redesigned gameplay controls for better accessibility on wide screens.
- **Enhanced Hall of Fame**
  - Mode-specific statistics: View your Standard and Speed Run achievements separately.
  - Duration filtering for Speed Run results.
  - Clean share feature: Navigation buttons are automatically hidden during stat sharing for a cleaner image.
- **UI/UX Polish**
  - New "Speed Run Time" selection modal with improved Z-layering and retro styling.
  - Tap guard: 1-second delay after Speed Run ends to prevent accidental session restarts.
  - "Hit Jump" effect: Stopwatch briefly pauses on hit time (even in cheat mode) for better visual feedback.
- **Gameplay Improvements**
  - Cheat charges now persist for an entire Speed Run session (one charge = 60s of perfect timing).
  - Restored legendary share messages ("Architect of Time", "Master of Time", etc.).
- **System**
  - Updated target SDK to 36 (Android 16).
  - Version number bumped to 6.0 in Service Menu.

## Version 5.9
- Initial integration of Special Modes screen.
- Layout optimizations for pixelated components.

## Version 5.8
- Hall of Fame UI refinements.
- Haptic feedback optimizations.

## Version 5.6
**Build 26**
- **Rating & Review Engine:** Integrated the native Google Play In-App Review API with custom trigger logic based on install duration and daily usage.
- **Direct Store Access:** Added a "Rate & Review" link to the landing screen for manual deep-linking to the Play Store.
- **Responsive Layout Engine:** Refactored the core screen architecture to handle diverse aspect ratios (e.g., Tecno Spark 20 Pro and tall devices) using dynamic weight-based layouts.
- **UI Consistency:** Standardized header alignments and bottom action button positions across all screens for a seamless navigational experience.
- **Hall of Fame Refinement:** Renamed daily stats to "Today's Feats" for a more thematic arcade feel.
- **Privacy & Support Hub:** Added dedicated links for Privacy Policy, Terms & Conditions, and a direct Contact Support email channel in the Service Menu.
- **Developer Tools:** Introduced a "Reset Rating Trigger" in the Service Menu for internal verification and beta testing.
- **Visual Polish:** Refined 3D button rendering and shadows to prevent clipping on diverse screen densities.

## Version 5.0
**Build 22**
- **Architecture Refactor (Step 3):** Moved `ServiceMenuScreen` and `HallOfFameScreen` (including `StatTable`) into dedicated files for modularity.
- **Architecture Refactor (Step 2):** Extracted data models and custom shapes into `Models.kt`.
- **Architecture Refactor (Step 1):** Successfully split core UI components into `RetroComponents.kt`.
- **Content Restoration:** Re-implemented full-length "Architect of Time" win messages and detailed difficulty help text.
- **UI Consistency:** Standardized the top-right placement for the Gear (Settings) and 'X' (Close) icons for seamless transitions.
- **Service Menu Update:** Replaced the large bottom back button with a retro pixel-art close icon in the upper right.
- **Optimization:** Adjusted main screen spacing to move the "Insert Coin" button higher for better ergonomics on large devices like the S23 Ultra.

## Version 4.5
**Build 21**
- **Service Menu Addition:** Introduced the Service Menu to allow users to toggle SFX, Chaos Music, Flicker, and Haptics.
- **S23 Ultra Optimization:** Initialized layout scaling for modern high-resolution displays.
- **Analytics Opt-Out:** Added the ability for users to manage their data privacy within the app.

## Version 4.0
- **Chaos Mode:** Introduced `HARD+` and `INSANE+` modes featuring variable timer speeds and visual distractions.
- **Visual FX:** Added the CRT scanline overlay and screen flicker effects.
- **Firebase Integration:** Added Google Analytics tracking for screens and game results.
- **Audio Expansion:** Integrated specialized Chaos stings and "About" screen audio cues.

## Version 3.0
- **Hall of Fame Stats:** Created a persistent scoring system to track "Today" and "All-Time" metrics for every difficulty level.
- **Social Share Engine:** Implemented high-resolution screenshot capture and sharing functionality.
- **Custom Social Messaging:** Tailored share messages based on difficulty (e.g., "Architect of Time" for Insane wins vs. "Bullseye" for Easy wins).
- **Difficulty Tiers:** Finalized the four-tier system (Easy, Normal, Hard, Insane) with precision-tuned tolerance windows.

## Version 2.0
- **Retro Aesthetic:** Implemented the "Press Start 2P" pixel font and neon-weighted color palette.
- **Advanced Haptics:** Integrated distinct vibration patterns for wins (long pulse), misses (stutter), and coin inserts (short tap).
- **SoundPool Integration:** Moved from standard media playback to a low-latency SoundPool engine for frame-accurate arcade audio.
- **Expanded Audio Library:** Integrated a full suite of arcade sound effects including `start`, `stop`, `win`, `lose`, `reset`, `restart`, `coin_insert`, and the `mode_selection` click.
- **CRT Visuals:** Initial implementation of the "PixelCorner" notched shapes and blinking "Insert Coin" button logic.

## Version 1.0
- **Core Logic:** Developed the central stopwatch engine using **Snap Logic** and `SystemClock.elapsedRealtime()` for millisecond precision.
- **Target Logic:** Implemented random target generation between 2.00 and 8.00 seconds.
- **Basic UI:** Created the primary Start/Stop/Reset loop.
- **Precision Check:** Initial math implementation for calculating the difference between target and elapsed time.

---
*Developed by [Stupidly Simple Apps](https://stupidlysimpleapps.cdf-design.com/)*