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

LibreLifts developer docs

Documentation for people working on LibreLifts. If you want to know what the app is, start at librelifts.app.

These files live in docs/ in the repository and are mirrored to the project's wiki on every push to main. Edit them in docs/; changes made on the wiki are overwritten.

Start here

  • Development: what you need installed, and how to run the app, the desktop shell, the website and the tests.
  • Parity with StrongLifts: what LibreLifts will and won't include, and in what order.
  • Decisions: the architecture decision records, one per decision.

How the repository is laid out

Path What it is
apps/app The Expo app: iOS, Android and web.
apps/desktop The Electron shell around the web build of the app.
apps/website The website, librelifts.app. Static Astro.
packages/core The rules of the program, in plain TypeScript, with tests.
docs These docs.
scripts Repository scripts, such as the one that builds the wiki.

Conventions

Clone this wiki locally