Skip to content

ShayanAbbas1/kilo

Repository files navigation

Kilo 🏋️

Free, local-first workout, body-weight and calorie tracker for Android.

Built by a lifter who lost 40+ kg tracking all of it by hand across paywalled apps. Kilo puts training, weight and calories on one timeline — free, forever.

📲 Get the app

Download the latest Android APK — install it once; it updates itself over the air on restart.

Installing over an existing Kilo keeps your data — don't uninstall first. All data lives on-device.

Prefer auto-updates? Add the repo to Obtainium: paste https://github.com/ShayanAbbas1/kilo, or tap the one-tap link on your phone. It installs the latest release and updates in place whenever a new one ships.

Why it exists

  • Free forever, no paywall. No backend, no accounts, no sync servers. Data lives on-device in SQLite and exports to JSON — it's always yours. Nothing to host means nothing to charge for.
  • Logging that matches Strong. Sets with last-session ghost values, rest timer, routines, supersets, RPE, plate calculator. Import your Strong or Hevy history from CSV so your analytics aren't empty on day one.
  • Analytics no free app has. Per-exercise progression (est. 1RM / top weight / volume), sets and tonnage per muscle with an anatomical heatmap (muscle mappings audited for accuracy), a PR feed, and the Trendline — body weight, weekly tonnage and calories on one chart.
  • Manual calories, on purpose. No barcode or auto-logging — portion, prep and brand variance make "scan and forget" quietly wrong. A few honest taps instead.

FEATURES.md is the spec of record — shipped, planned, and explicit non-goals.

📸 Screenshots

The Trendline
The Trendline — body weight, weekly tonnage & calories on one chart, each scaled to its own range

Live workout logging
Live logging
sets, rest timer, ghost values
Exercise detail
Per-exercise
progression & muscle targets
Muscle heatmap (sets)
Sets per muscle
anatomical heatmap
Muscle heatmap (tonnage)
Same heatmap
toggled to tonnage
Tonnage & PRs
Tonnage per muscle
+ recent PRs
Workout report
Workout report
every set, logged

Stack

  • Expo / React Native, TypeScript, expo-router
  • expo-sqlite — on-device DB is the single source of truth (kg canonical, converted at display time)
  • Exercise library seeded from free-exercise-db (~870 exercises, public domain) + custom exercises

Development

npm install
npm start          # scan the QR with Expo Go on Android
npm run android    # or launch the emulator

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages