Repository navigation
Home
github-actions[bot] edited this page Nov 17, 2026
·
2 revisions
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.
- 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.
| 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. |
- Commits follow Conventional Commits and are signed.
- 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.
Generated from docs/ on main. Edit the docs there; changes made on the wiki are overwritten.
- Development
- Parity with StrongLifts
-
Decisions
- 0001 Decisions are recorded as ADRs
- 0002 Apache License 2.0
- 0003 Parity with StrongLifts, everything free
- 0004 iOS, Android and web
- 0005 Local-first; accounts and sync later through Spotcraft
- 0006 openweight for import and export, not for storage
- 0007 One Expo app, wrapped in Electron for desktop
- 0008 A pnpm workspace with app, desktop and core
- 0009 The website is static Astro in apps/website
- 0010 The website is hosted on GitHub Pages at librelifts.app
- 0011 docs/ is for developers and is mirrored to the wiki