MileWage
Self-hosted mileage and earnings tracking for delivery and ride-hail drivers. An Android app records the shift, and a server you own keeps the data. No third party stores your location history.

Note: Version 0.3.0 is a complete build that has not had a field test. No real shift has been recorded on the road, and the Android app has not run on a real phone. The open items are in the repository's CHANGELOG.md and TODO.md.
Long story short
Comma kept the data on the phone and synced it through Google Drive. The phone and web apps kept disagreeing.
Comma syncMileWage makes a home server the single source of truth. The phone only records and sends.
ArchitectureThe same GPS filter runs in Kotlin on the phone and TypeScript on the server, so both get the same miles.
Mileage engineOn day seven the Expo app was replaced with native Kotlin, with no Google Play Services.
DecisionVersion 0.3.0 runs in Docker on a tailnet. It has not recorded a real shift on the road yet.
Install
What it does
Records the shift
The Android app tracks GPS with the screen off and works offline for weeks. It needs nothing from Google.
Counts the miles
Shifts, trips and stops are derived from the GPS track, with active and deadhead miles as an estimate.
Keeps the money
Earnings, expenses with receipt photos, vehicles, odometer readings, parking and tolls.
Prepares tax records
Mileage deductions for Canada, the United States and Great Britain, or a rate you set, with a PDF report and CSV files.
Backs up the data
Nightly encrypted backups, with a recovery key that only the owner holds.
Facts
- Version
- 0.3.0, released 2026-11-11
- Licence
- AGPL-3.0
- Server
- Fastify and SQLite in Docker, behind Caddy
- Web app
- React, Material Design 3
- Phone app
- Kotlin, Jetpack Compose, Android 8.0 or later
- Network
- Tailscale, or plain HTTP on the home LAN
- Tenancy
- One driver per server
- Predecessor
- Comma, retired
In this section
Install on a home server
Start the Docker stack, publish it on a tailnet and pair the phone.
Architecture
The server, the web app, the Android app and the engine they share.
Mileage engine
What the phone records, what is filtered out, and how two implementations agree.
Brand
The Coin Road mark, the palette and the ten concepts that were not chosen.
Decisions
Architecture decision records for the phone app, tracking and the distance gate.