Repository navigation
0016 hosted api
Status: accepted · Implementation: planned · Date: 2026-11-17 · Supersedes: 0003, 0005
Partly supersedes ADR 0003: the app still has no paywall, but the project now sells a hosted API. Partly supersedes ADR 0005: the app is still local-first with no server of its own, but the project will run a server for the database. The rest of both records stands. Hosting, billing, the legal entity, the privacy policy for API accounts, the terms of service and the trademark policy get their own records. Prices are not decided here.
ADR 0003 made everything free and noted that this leaves no budget for hosted services. ADR 0005 followed from that: no server. The open database (ADR 0013) changes the picture. It is useful to other apps, and serving it reliably costs money.
The data is open and its dumps are free (ADR 0014), so the data itself cannot be what is sold. MetaBrainz earns its income this way: the data is free, and companies pay for a current feed, support and not having to run the pipeline themselves. TheSportsDB sells cheap API tiers to hobby developers. TheTVDB charged the open-source apps that sent it contributors, and lost them to a competitor.
One concern was that the API could be used to remake the app. The app is Apache-2.0 and the data is ODbL, so both may be copied by design. What can be prevented is someone running their product on LibreLifts' servers without paying for them.
- The project sells a hosted API to the database. The app stays free, with no paywall, subscription, trial or locked feature.
- The API serves reference data only. It has no endpoints for logging workouts, for personal data or for sync.
- What is paid for is the service, never the data: higher rate limits, fresher data than the dumps, delivery of media, an uptime commitment and support.
- There is a free tier. It needs a key, is rate-limited and requires attribution. It is generous enough for personal and open-source projects.
- Commercial use of the hosted API needs a paid tier. Commercial use of the data does not: the dumps are free to anyone.
- The terms of the hosted API forbid free-riding: reselling or proxying the API, copying the whole database through the API instead of the dumps, and caching beyond what the tier allows. A key can be revoked.
- The name and logo are not licensed by Apache-2.0 or ODbL. A fork or a reuser must not suggest it is LibreLifts or is endorsed by it.
- The app does not depend on the API. It uses its bundled snapshot (ADR 0013).
- The terms stop a product from being run on LibreLifts' servers for free. They do not stop anyone from building a competing app or API from the dumps. What keeps customers is that the hosted service is current, reliable and less work than self-hosting.
- Income is likely to be small and slow until other products depend on the data.
- The project will run a server, hold accounts and take payments. Each needs work that the app alone never did: hosting, a privacy policy, terms and a legal entity.
- "Everything is free" now needs to be said precisely: everything in the app is free, and the
data is free.
docs/parity.mdand the website need a follow-up change. - Free tiers of public APIs are scraped heavily. Keys, per-key limits and free dumps are the defence, and the dumps make the limits fair.
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