Repository navigation
0007 platforms
Status: accepted · Implementation: planned · Date: 2026-11-18
From LibreLifts ADR 0018. Keeping the web build was a choice made again for LibreBars on 2026-11-18, knowing what it costs: a patch (0022), response headers and a tab lock (0018). As built so far, 2026-11-18: apps/app exists with a placeholder screen, and its web build is exported by pnpm check. The app is in no store, so this stays planned.
A workout log is used on the phone, at the bars. One person builds LibreBars, and each extra platform is one more place for it to break. LibreLifts dropped its desktop app for that reason. Until the app is in the stores, though, a web build is the only way to try it without building it yourself, and it is the quickest way to look at a change during development.
- The tracker is an iOS and Android app, built with Expo.
- There is no desktop app.
- The Expo web build stays until the app is in both stores. It is a stopgap so the tracker can be tried.
-
Once the app is in both stores, the web build is removed, with
react-native-web, in a change of its own. - Nothing is built for the web build alone, and it gets no feature the phones lack. The two exceptions are what it takes to keep its database safe (0018, 0022).
- Account settings open on the website, not in the app. The app links out to them.
- There is one tracker codebase and, in the end, two targets to test.
- The web build needs a host that can send response headers, and SQLite in the browser has only been confirmed in Chromium. Safari and Firefox have to be tested before it is published. Where it is served gets its own record.
- The web build of the app and the website are different things. The website is built from
apps/web(0025). - Someone who wants the tracker on a computer has the web build for now, and nothing after the store release.
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