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).
