Skip to content
Docs

Command palette

Jump to a page or view, or find a todo by name.

Changelog

Device-first archive, account optional

The repository's architectural decision, rationale and consequences.

Markdown

The Athlete's Archive (Belt Ranks, Stripes, Results, Trips, Breaks) lives in an encrypted SQLite database on the phone (expo-sqlite built with SQLCipher, key in expo-secure-store). The mobile app opens, onboards and shows the timeline without a User or network; Better Auth is used only for the optional backup and the web dashboard. This reverses the template's signed-in-first mobile shell.

Chosen over server-first (Neon as system of record) because athletes use the app at venues without signal, because the product promise is that the Archive belongs to them (product ADR-01, RNF02) and because health-adjacent data (Breaks, weight) must never reach a server.

Consequences

  • The mobile root layout no longer guards the tabs with Stack.Protected on a session.
  • Sync (S7) is push/pull of changes from the device; conflicts are resolved on the device.
Edit on GitHubDocumentation is in English.
Cookie settings
We use essential cookies to make our app work. With your consent, we also use optional cookies to improve your experience.

Read our Cookie Policy and Privacy Policy.