Repository navigation
Home
github-actions[bot] edited this page Nov 18, 2026
·
10 revisions
Documentation for people working on LibreBars, a free workout log for calisthenics. If you want to know what the app is, start at librebars.app.
These files live in docs/ in the repository and are mirrored to the project's wiki on every
push to dev. Edit them in docs/; changes made on the wiki are overwritten.
- Development: what you need installed, and the commands.
- Workflow: branches, commits, the changelog, how a change lands and how a release is made.
- Decisions: one record per decision. What the product is: 0006.
The layout is decided in 0011.
| Path | What it is | Now |
|---|---|---|
apps/app |
The Expo app: iOS and Android, and a web build for now. | here: the workout loop, with backup |
apps/web |
The website. TanStack Start. | here: published from main
|
apps/api |
The API. Fastify on Postgres. | here: guest accounts and sync |
packages/engine |
The rules of the log, as pure functions, with tests. | here |
packages/ui |
The look shared by the website and the app: the theme. | here |
packages/data |
Seed and reference data: the first exercises. | here |
packages/contracts |
The shapes the API shares with the web and the app. | here |
docs |
These docs. | here |
scripts |
Repository scripts, such as the one that builds the wiki. | here |
- Commits follow Conventional Commits and are signed.
- The changelog follows Keep a Changelog, and versions follow Semantic Versioning.
- Every change lands on
devthrough a pull request;mainis the last release. See Workflow. - A decision that shapes the project gets a record in decisions before it is acted on.
- The project is licensed under the Apache License 2.0.
The architecture and the workflow are taken from LibreLifts, a sibling project, where they were decided and built first. Each record here that came from there says so in its notes.
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