Skip to content
github-actions[bot] edited this page Nov 18, 2026 · 10 revisions

LibreBars developer docs

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.

Start here

  • 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.

How the repository is laid out

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

Conventions

Where it comes from

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.

LibreBars

Clone this wiki locally