CarConso

---

Features

⛽ Fill-ups	Volume, price, odometer or distance, partial fill-ups, blends of compatible fuels (e.g. E10 + E85).
🚗 Several vehicles	Petrol or diesel, tank capacity, fuels offered, default fuel.
🔧 Expenses	Service, insurance, tolls… one-off or recurring (monthly, yearly…).
📊 Statistics	Average consumption, cost per km or mile, comparison by fuel, monthly spending, forecast, period filter.
🌍 Language and country	English, French, German, Spanish, Italian, Portuguese or Dutch, detected automatically. The country sets the local fuel names and list (SP-95 in France, Regular / Premium in the US, Super E10 in Germany, Gasolina comum / Etanol in Brazil…) and the default units.
🎨 Customisation	Light / dark theme, colour, text size, compact layout, units (L/100 km, km/L, mpg, km or miles, litres or US gallons, currency), start screen, visible tabs.
💾 Data	Backup / restore to a file, CSV exports for Excel. In the Android app: automatic backup with the phone's Google backup.

Supported countries: France, Belgium, Luxembourg, Switzerland, Canada, United Kingdom, Ireland, United States, Germany, Austria, Spain, Italy, Portugal, Netherlands, Mexico, Brazil. Other countries use international fuel names.

Privacy

No data is collected: no account, no server, no usage analytics. Everything stays on your device, and the Android app asks for no permission. Details: privacy policy.

Installation

• Android: download the APK from the latest release (installing apps from unknown sources must be allowed). Coming soon to Google Play.
• iPhone, computer, or Android without installing: open the web app, then add it to the home screen (Chrome: menu ⋮ › Install app; Safari: Share › Add to Home Screen).

The web app and the Android app keep separate data: to move from one to the other, use Settings › Data › Full backup, then Restore from a file.

How consumption is calculated

CarConso uses the fill-to-fill method:

• the distance entered is the one driven since the previous fill-up;
• the litres of a full fill-up replace exactly what was burned over that distance; partial fill-ups add up until the next full one;
• the first full fill-up is only a reference (its distance is optional): the first consumption appears at the next one;
• the consumption is credited to the fuel that was in the tank (the previous fill-up's), which makes comparisons between fuels and blends reliable;
• the cost of a trip uses the price paid for that fuel, so the cost per km never counts the fuel still in the tank.

Development

The app is plain HTML, CSS and JavaScript, with no framework and no build step. The same code runs the website (GitHub Pages, from the main branch) and the Android app (through Capacitor).

index.html, style.css      user interface
i18n.js                    languages, countries, fuel names
locales/                   texts of each language (fr, en, de, es, it, pt, nl)
stats.js                   calculations (consumption, blends, forecast)
storage.js                 local storage, settings, import / export
native.js                  Android-only features
app.js, *-view.js          screens (Fill-up, History, Expenses, Stats, Settings)
vendor/                    Chart.js
android/                   Android project (Capacitor)
assets/, store/            icons, splash screen, Google Play images and listing (store/PLAY_STORE.md)

Web app

powershell -ExecutionPolicy Bypass -File serve.ps1

then open http://localhost:8000.

Android app

Requirements: Node.js, JDK 21 and Android Studio (Android SDK).

npm install
npm run android          # runs the app on a connected phone or the emulator
npm run android:bundle   # .aab file for Google Play

Signing uses android/keystore.properties and a .jks key, which are never pushed to GitHub.

Translations

The texts of each language live in locales/<language>.js (MESSAGES and the international FUEL_NAMES), and the static texts of index.html are tagged with data-i18n. Fuel names and default units per country are in COUNTRIES (i18n.js). Corrections from native speakers, and new languages or countries, are welcome.

License

CarConso is free software released under the GNU GPL v3 (or any later version): you may use, study, modify and share it, as long as modified versions stay under the same license.

Credits

Designed by Atrena, built with help from Claude (Anthropic). Charts: Chart.js (MIT license).