Skip to Content
Front pageLabsLabs, projects & CCNA notes

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.


MileWage
A phone sends shift data over a private Tailscale link to a server at home

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

  1. Comma kept the data on the phone and synced it through Google Drive. The phone and web apps kept disagreeing.

    Comma sync
  2. MileWage makes a home server the single source of truth. The phone only records and sends.

    Architecture
  3. The same GPS filter runs in Kotlin on the phone and TypeScript on the server, so both get the same miles.

    Mileage engine
  4. On day seven the Expo app was replaced with native Kotlin, with no Google Play Services.

    Decision
  5. Version 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

Back to top