Mikkeli Matlock
66bdd35995
- Add OverlayError enum (permission, creationFailed, communicationDegraded) - Add OverlayService dependency via constructor injection - Add onError callback field for error surfacing (set by SpeedometerScreen) - Refactor showOverlay to check permission before showing overlay - Refactor showOverlay to verify overlay creation via isActive check - Only set _isOverlayActive after verification succeeds - Replace all FlutterOverlayWindow calls with OverlayService methods - Add GPS grace period timer (30s) in _handleOverlayClose - Cancel grace period if overlay reopens within 30s - Register OverlayService in MultiProvider before OverlayProvider - Inject OverlayService into OverlayProvider constructor Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
GPS Speedometer
A GPS Speedometer aimed at Android on Motorcycle / Bicycle applications. Created with the help of Claude Code
Features
Core Functionality
- Real-time speed display using GPS
- Maybe also direction display using GPS
- Good floating window / split screen support(hopefully)
Customizable Settings
- Speed Units: mph, km/h, knots (with convenient unit selector buttons)
- Theme: Light/Dark mode (expandable for custom themes)
Technical Specifications
- Target Platform: Android (primary)
- Target Device: Mobile phones and tablets
- GPS Requirements: Location permissions required
- Offline Capability: Full functionality without internet
Architecture Design
To be updated
Permissions Required
ACCESS_FINE_LOCATION- For high-precision GPS trackingACCESS_COARSE_LOCATION- Fallback location access
Getting Started
Prerequisites
- Flutter SDK
- Android development environment
- Physical device recommended (GPS simulation limited in emulator)
Installation
- Clone the repository
- Run
flutter pub get - Connect Android device or start emulator
- Run
flutter run
Development
flutter run- Run the app in development modeflutter build apk- Build APK for Androidflutter test- Run unit tests