Cars Manager is a local-first vehicle companion for tracking fuel, maintenance, insurance, taxes, fines, repairs, deadlines, and ownership costs from one calm dashboard.
- Features
- Screenshots
- Architecture
- Getting Started
- Builds and Release
- Configuration
- Project Structure
- License
- Vehicle dashboard — active car hero, monthly summary, recent activity, quick actions, and upcoming deadlines.
- Garage management — add, edit, delete, and switch vehicles with image-led cards and status indicators.
- Vehicle detail pages — overview, fuel, expenses, and timeline tabs for each car.
- Fuel tracking — fuel entries, total spend, liters/kWh, average prices, and year-based charts.
- Expense tracking — insurance, inspection, tax, repair, and fine records with category-specific views.
- Reminders — local notifications for insurance, inspection, and tax due dates.
- Analytics — total cost overview, category breakdown, cost per car, monthly trend table, and CSV export.
- Search — global search across vehicles and tracked records.
- Settings — theme, language, units, currency, notification preferences, export, reset, and app info.
- Internationalisation — English and Italian UI through Flutter gen-l10n.
- Responsive layout — bottom navigation on mobile, navigation rail on tablet, sidebar on desktop.
- Cross-platform — Android, iOS, web, Windows, macOS, and Linux project targets.
| Dashboard | Garage | Analytics |
|---|---|---|
 |
 |
 |
 |
 |
 |
┌─────────────────────┐
│ Flutter App │
│ Material + Router │
└────────┬────────────┘
│ GoRouter routes
┌────────▼─────────┐ ┌────────────────────┐
│ Feature Screens │ ◄───► │ Riverpod Providers │
│ Home/Garage/etc.│ │ App state + logic │
└────────┬─────────┘ └─────────┬──────────┘
│ │
┌────────▼─────────┐ ┌─────────▼──────────┐
│ Shared UI System │ │ Local Persistence │
│ Widgets + tokens │ │ JSON / localStorage│
└──────────────────┘ └────────────────────┘
Cars Manager keeps the app local-first: vehicle data is stored on-device, while the UI is built around Riverpod state, GoRouter navigation, Freezed models, and shared design tokens.
| Tool | Version |
|---|---|
| Flutter | stable channel |
| Dart | bundled with Flutter |
| Node.js | >= 20, only for repository tooling |
| npm | >= 10, only for repository tooling |
git clone https://github.com/thisispivi/CarsManager.git
cd CarsManager
npm install
cd cars_manager
flutter pub get
flutter runFor web:
cd cars_manager
flutter run -d chrome# From repository root
npm run verify
npm run analyze
npm run test
npm run build:android
npm run build:web# From cars_manager/
flutter pub get
flutter gen-l10n
dart run build_runner build --delete-conflicting-outputs
flutter analyze
flutter testBuild release APKs split by device architecture:
cd cars_manager
flutter build apk --release --split-per-abiOutput files:
| ABI | APK |
|---|---|
| ARM 64-bit | build/app/outputs/flutter-apk/app-arm64-v8a-release.apk |
| ARM 32-bit | build/app/outputs/flutter-apk/app-armeabi-v7a-release.apk |
| x86 64-bit | build/app/outputs/flutter-apk/app-x86_64-release.apk |
Build one universal APK instead:
cd cars_manager
flutter build apk --releaseUniversal APK output:
build/app/outputs/flutter-apk/app-release.apk
cd cars_manager
flutter build web --releaseOutput:
build/web/
The repository has a release workflow that runs tests, builds APKs, builds web, and publishes APK files to a GitHub Release when a version tag is pushed.
# 1. Update version in cars_manager/pubspec.yaml
# Example:
# version: 2.0.1+2
git add cars_manager/pubspec.yaml CHANGELOG.md
git commit -m "chore(release): v2.0.1"
git tag v2.0.1
git push origin main --tagsBeta tags are supported:
git tag v2.0.1-beta.1
git push origin main --tagsAfter the workflow finishes, download APKs from the GitHub Release page or from the workflow artifacts.
| File | Purpose |
|---|---|
cars_manager/pubspec.yaml |
Flutter dependencies, assets, version, package metadata |
cars_manager/flutter_launcher_icons.yaml |
Launcher icon generation settings |
cars_manager/flutter_native_splash.yaml |
Native splash screen generation settings |
cars_manager/l10n.yaml |
Localization generation settings |
cars_manager/assets/data/cars.json |
Seed/sample vehicle data |
cars_manager/lib/l10n/app_en.arb |
English strings |
cars_manager/lib/l10n/app_it.arb |
Italian strings |
Regenerate launcher icons:
cd cars_manager
dart run flutter_launcher_iconsRegenerate splash screens:
cd cars_manager
dart run flutter_native_splash:create --path=flutter_native_splash.yamlCarsManager/
├── .github/
│ └── workflows/ # CI, release, and web deploy workflows
├── cars_manager/
│ ├── android/ # Android runner project
│ ├── ios/ # iOS runner project
│ ├── linux/ # Linux runner project
│ ├── macos/ # macOS runner project
│ ├── web/ # Web runner assets and manifest
│ ├── windows/ # Windows runner project
│ ├── assets/
│ │ ├── data/ # Seed data
│ │ └── icons/ # App logo and SVG category icons
│ ├── lib/
│ │ ├── app/ # App root, router, app-level state
│ │ ├── core/ # Theme, services, storage, utilities
│ │ ├── design_system/ # Shared atoms, molecules, charts, organisms
│ │ ├── features/ # Home, garage, analytics, settings, onboarding
│ │ ├── l10n/ # ARB files and generated localizations
│ │ ├── models/ # Domain models
│ │ ├── presentation/ # Shared presentation widgets and migrated pages
│ │ └── main.dart # Application bootstrap
│ ├── test/ # Unit and widget tests
│ └── integration_test/ # Integration smoke tests
├── scripts/ # Repository helper scripts
├── package.json # Root automation scripts
└── README.md
MIT - Copyright (c) 2025 Andrea Piras