GPS Speedometer

A customizable Flutter speedometer app using GPS location services to display real-time speed.
Created with the help of Claude Code

Features

Core Functionality

• Real-time speed display using GPS
• High-precision location tracking
• Works offline (no internet connection required)
• Automatic portrait/landscape orientation support

Customizable Settings

• Speed Units: mph, km/h, knots (with convenient unit selector buttons)
• Display Style: Digital speedometer, analog gauge (tap gauge to switch)
• Theme: Light/Dark mode (expandable for custom themes)
• Metrics Display: Toggle additional metrics on/off
  • Current location coordinates
  • Distance traveled
  • Trip duration
  • Current speed accuracy

Technical Specifications

• Target Platform: Android (primary)
• Screen Orientation: Auto-rotate (portrait/landscape)
• Target Device: Mobile phones and tablets
• GPS Requirements: Location permissions required
• Offline Capability: Full functionality without internet

New Features in v1.1

• Auto-rotate Support: App now supports both portrait and landscape orientations
• Interactive Gauge: Tap the speedometer to switch between digital and analog modes
• Extended Units: Added knots as a speed unit option
• Unit Selector: Quick access unit selection buttons next to the speedometer

Architecture Design

The app is designed with customization and extensibility in mind:

• Settings system supports multiple options per category
• Modular design allows easy addition of new speedometer styles
• Theme system supports unlimited themes
• Metrics system allows toggle individual data points

Permissions Required

• ACCESS_FINE_LOCATION - For high-precision GPS tracking
• ACCESS_COARSE_LOCATION - Fallback location access

Getting Started

Prerequisites

• Flutter SDK
• Android development environment
• Physical device recommended (GPS simulation limited in emulator)

Installation

1. Clone the repository
2. Run flutter pub get
3. Connect Android device or start emulator
4. Run flutter run

Development

• flutter run - Run the app in development mode
• flutter build apk - Build APK for Android
• flutter test - Run unit tests