Repository navigation
0006 product
Status: accepted · Implementation: done · Date: 2026-11-18
The place LibreLifts ADR 0003 holds there. LibreLifts copies one fixed program; LibreBars has no program and no progression rule. Built 2026-11-18: the five steps of the loop, with a setting for the unit. As built, finishing a workout drops the sets that were never ticked off, a new set starts as a copy of the one before it, and only one workout can be in progress at a time. A set can be ticked off with nothing entered.
LibreLifts is a tracker for one barbell program: it knows what comes next and tells the lifter. Calisthenics has no such single program. People train pull-ups, dips, push-ups, holds and skills in routines of their own making, counting reps for some exercises and seconds for others, sometimes with added weight and sometimes with help from a band.
The apps people already use for this work the same basic way, and Hevy is the best-known of them: make a routine, start a workout from it or from nothing, log each set, finish, and look back at what was done. That loop is the smallest thing that is useful every training day.
- LibreBars is a workout log for calisthenics and bodyweight training.
-
The first version is that basic loop and nothing else:
- Routines: a named list of exercises, each with its planned sets.
- Start a workout, from a routine or empty, and add exercises to it.
- Log sets. A set is reps or a hold time, depending on the exercise, with an optional load. Each set shows what was done last time beside it.
- Finish the workout.
- History: past workouts and what was in them.
- A load is optional and can be negative. Added weight is a positive number, help from a band or a machine is a negative one, and no load means bodyweight alone.
- The app does not decide what comes next. There is no built-in program and no progression rule. It shows the last values and the person chooses.
- Everything in the app is free: no paywall, subscription, trial, locked feature or ads.
- Only the way the loop works is taken from other apps. No text, exercise list, media, layout or look is copied from Hevy or from any other product.
- Not in the first version: exercises a person adds themself, a rest timer, charts and records, guided progressions, body measurements, and anything social.
- The rules the app has to get right are few: what a set is, what "last time" means, and how
a routine becomes a workout. They live in
packages/engine(0012). - Without a progression rule the app is less helpful to a beginner than LibreLifts is. That is accepted for a first version, and guided progressions can be added on top of the log.
- The exercise list is fixed by the project until people can add their own. Someone whose exercise is missing cannot log it yet.
- Free for everyone leaves the app with no income. The project's income is planned to come from a hosted API (0010).
Generated from docs/ on dev. Edit the docs there; changes made on the wiki are overwritten.
- Development
- Workflow
-
Decisions
- 0001 Decisions are recorded
- 0002 Apache License 2.0
- 0003 Changes land on dev by fast-forward; main is the last release
- 0004 Conventional Commits, Keep a Changelog and Semantic Versioning
- 0005 docs/ is for developers and is mirrored to the wiki
- 0006 LibreBars is a free workout log for calisthenics
- 0007 The tracker is an iOS and Android app; its web build stays until the store release
- 0008 LibreBars is an app and a crowd-sourced open database
- 0009 The database is ODbL, media is CC BY-SA, and neither can be closed later
- 0010 A hosted API with a free tier is the paid product
- 0011 The workspace is app, web and api, with engine, ui, data and contracts
- 0012 The engine is small pure functions, in the style of date-fns
- 0013 Web and app share a Tailwind theme, not components
- 0014 Postgres is the source of truth for all data
- 0015 The API is Fastify, and it owns LibreBars accounts
- 0016 Every install is a guest account, made in the background
- 0017 Accounts use Better Auth
- 0018 The on-device database is SQLite with Drizzle, on every platform
- 0019 Sync is our own push and pull
- 0020 The app says it backs up, and backup can be turned off
- 0021 Postgres 18, run with Docker Compose and tested on two databases
- 0022 expo-sqlite is patched so the web build reuses one buffer
- 0023 Seed data is TypeScript modules in packages/data, with permanent ids
- 0024 The first tables
- 0025 One TanStack Start app is the website, on GitHub Pages
- 0026 The catalog reaches the app as a snapshot plus updates, and the website through the API
- 0027 The app's first components are its own