Repository navigation
0020 backup notice and switch
github-actions[bot] edited this page Nov 18, 2026
·
2 revisions
Status: accepted · Implementation: done · Date: 2026-11-18
From LibreLifts ADR 0035. Deleting the server's copy comes with the privacy work, so the notice does not promise it. Built 2026-11-18. The notice also says what LibreLifts does not: that the copy can only be reached from the install that made it, until there is an account to sign in to. Seen on the iOS simulator and in Chromium: no sync request before the notice is answered, none while backup is off, and what was missed sent when it is turned on again.
Backup is automatic (0016, 0019). A person's log leaving their phone without their knowing is not acceptable, however good the reason.
- The first time the app opens, it shows one screen before anything else that says the log is saved on the phone and copied to LibreBars' server. It has two buttons: carry on, or turn backup off.
- None of the person's data is sent until that screen has been answered. A guest account may already have been asked for; it holds nothing.
- Backup can be turned off and on again at any time, in the app's settings. While it is off the app sends no data and asks for none, and keeps noting changes in its outbox. Turned on again, it sends what it missed.
- Whether backup is on is kept on the device and is not synced. It is a choice about this device.
- The screen promises only what exists. It says backup can be turned off. It does not say the copy can be deleted until it can.
- Someone who never wants their log to leave the phone can say so before a single row is sent.
- Turning backup off does not remove what was already sent. Until deletion exists, the app says so where the switch is.
- The outbox grows while backup is off, which is what makes turning it on again work.
- The notice appears only once sync is built. Before that the app sends nothing and has nothing to announce.
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