Repository navigation
0009 open data licences
Status: accepted · Implementation: planned · Date: 2026-11-18
From LibreLifts ADR 0014. The licence texts are added to the repository with the first data. CONTRIBUTING.md covers code only until contributions of data open.
The code is Apache-2.0 (0002). That licence is written for software and does not fit a database or pictures. The database (0008) needs its own licence, and contributors need to know what happens to what they give.
Two histories shaped the choice. CDDB and IMDb were built by volunteers and then closed; the contributors lost their work. OpenStreetMap and Open Food Facts use a share-alike licence and bind themselves to keep the data open, and both kept their communities.
- The database is licensed under the Open Database License (ODbL) 1.0, and its individual contents under the Database Contents License (DbCL) 1.0.
- Media is licensed under CC BY-SA 4.0, file by file. Every file records its author, its source and its licence. A file without all three is not accepted.
- The code stays Apache-2.0.
- Contributions come in under the same licences they go out under, and cannot be withdrawn. There is no contributor licence agreement.
- Nobody, the maintainer included, can relicense the data to a licence that is not free and open.
- Contributions must be the contributor's own work. Text and media are not copied from other apps or websites. Data is imported from another project only when its licence is compatible and its attribution is kept.
- Complete dumps of the database are published, free.
- Anyone can use the data, commercially too, and can build a competing app from the dumps. The licence does not prevent that and is not meant to.
- Someone who publishes a changed copy of the database must share it under ODbL and credit LibreBars. An app built on the data is not a database and can be closed.
- The data cannot be sold under a second, closed licence, so income has to come from a service around the data (0010).
- Media with no clear origin cannot be imported, however good it is.
- The app must show attribution for the data and media it bundles.
Generated from docs/ on dev. Edit the docs there; changes made on the wiki are overwritten.
- Development
- Workflow
-
Decisions
- 0001 Decisions are recorded
- 0002 Apache License 2.0
- 0003 Changes land on dev by fast-forward; main is the last release
- 0004 Conventional Commits, Keep a Changelog and Semantic Versioning
- 0005 docs/ is for developers and is mirrored to the wiki
- 0006 LibreBars is a free workout log for calisthenics
- 0007 The tracker is an iOS and Android app; its web build stays until the store release
- 0008 LibreBars is an app and a crowd-sourced open database
- 0009 The database is ODbL, media is CC BY-SA, and neither can be closed later
- 0010 A hosted API with a free tier is the paid product
- 0011 The workspace is app, web and api, with engine, ui, data and contracts
- 0012 The engine is small pure functions, in the style of date-fns
- 0013 Web and app share a Tailwind theme, not components
- 0014 Postgres is the source of truth for all data
- 0015 The API is Fastify, and it owns LibreBars accounts
- 0016 Every install is a guest account, made in the background
- 0017 Accounts use Better Auth
- 0018 The on-device database is SQLite with Drizzle, on every platform
- 0019 Sync is our own push and pull
- 0020 The app says it backs up, and backup can be turned off
- 0021 Postgres 18, run with Docker Compose and tested on two databases
- 0022 expo-sqlite is patched so the web build reuses one buffer
- 0023 Seed data is TypeScript modules in packages/data, with permanent ids
- 0024 The first tables
- 0025 One TanStack Start app is the website, on GitHub Pages
- 0026 The catalog reaches the app as a snapshot plus updates, and the website through the API
- 0027 The app's first components are its own