Repository navigation
0015 fastify api
github-actions[bot] edited this page Nov 18, 2026
·
2 revisions
Status: accepted · Implementation: done · Date: 2026-11-18
From LibreLifts ADR 0021, and from how its API was built. Built 2026-11-18: buildApp, one file that listens, settings checked at start, the health check and the private account part. The public data API is not built; that is 0010.
Something has to stand between the apps and Postgres (0014): to say who is asking, to take and give a person's changes, and later to serve the open database to others (0010).
-
The API is a Fastify service in
apps/api, written in TypeScript and run by Node directly, without a build step. - LibreBars has its own accounts, and the API owns them.
-
One service has two parts, kept apart:
- a private part for accounts and sync, used only by LibreBars' own app and website;
- the public data API, the paid product, which serves reference data only. It does not exist yet.
-
buildApp()builds the app without starting it and takes its settings and its database as arguments. One file listens, and one file reads the environment. -
Routes are plugins, and every route has a schema for what it takes and what it returns.
The shapes come from
packages/contracts; neither side restates one. -
Settings are environment variables, checked against a schema when the API starts, and
mirrored in
.env.example. No secret is committed. - The logger hides the headers that carry a session.
- Who is asking comes from the session only, never from the body, the path or a header the caller sets.
- One service to run, and one place where an account is defined.
- Tests can build the whole API in memory and call it without a network (0021).
- The line between the two parts has to stay visible in the code and in the documentation, so that what is sold stays reference data. The app must work without the paid part.
- Node running TypeScript directly allows only syntax that can be erased: no enums and no
parameter properties, and imports name the
.tsfile.
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