Fuel Stats

Fuel Stats is a Flutter application for tracking vehicle fuel consumption and service history. It lets you record refuels and maintenance, manage multiple vehicles, and visualise trends in cost and efficiency.

Features

• Email-based authentication with login and sign-up flows
• Manage vehicles and choose a default one
• Log refuels with liters, price, mileage and notes
• Record maintenance/service events, including cost and optional photos
• Stats dashboard with consumption figures and kilometers driven
• Charts for gas price and fuel consumption trends

Platform Support

The app is tested only on Android. A web build should also work, but iOS, macOS, Windows, and Linux have not been tested.

Configuration

The app communicates with a Node.js backend maintained in a separate project: Fuel Stats Server. Provide the server's base URL at build time using a compile-time define:

flutter run --dart-define=API_BASE_URL=https://api.example.com

Getting Started

1. Install Flutter (3.7 or later).
2. Fetch dependencies:

   flutter pub get
   

3. Launch the application:

   flutter run --dart-define=API_BASE_URL=http://localhost:6060
   

CI/CD

A GitHub Actions workflow builds a profile APK on each push to the dev branch. The workflow reads the version from pubspec.yaml, uses the repository commit count as the build number, and uploads the APK as an artifact.