Repository navigation
0001 decision records
github-actions[bot] edited this page Nov 17, 2026
·
1 revision
Status: accepted · Implementation: done · Date: 2026-11-17
librelifts starts from an empty repository. The choices made now (license, scope, platforms, where data lives) shape everything after, and the reasons are easy to lose once code exists.
Every decision that shapes the project gets a short record in docs/decisions/, in the format
Spotcraft uses:
- One file per decision, named
NNNN-kebab-title.md, numbered in order. - Frontmatter:
title,number,status,implementation,date,supersedes,superseded_by,notes. - Three sections: Context, Decision, Consequences.
- A changed decision gets a new record that supersedes the old one. Old records are never
rewritten; only their
statusandsuperseded_bychange. -
docs/decisions/README.mdlists every record with its status.
- A decision costs a few minutes of writing before it is acted on.
- The history of why things are the way they are stays in the repository, next to the code.
- Superseded records stay, so the folder also shows what was tried and dropped.
Generated from docs/ on dev. Edit the docs there; changes made on the wiki are overwritten.
- The open database and the API
- Development
- Parity with StrongLifts
- Workflow
-
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
- 0012 Changes land on dev by fast-forward; main is the last release
- 0013 LibreLifts is an app and a crowd-sourced open database
- 0014 The database is ODbL, media is CC BY-SA, and neither can be closed later
- 0015 Data contributions start as pull requests; a web editor comes later
- 0016 A hosted API with a free tier is the paid product