learn

Cloud account and sync

Google sign-in with Firestore sync, when configured.

Only what the code implements: Google sign-in (native on device, popup on web), per-account SQLite files, an outbox that uploads before any pull, listeners that restore other devices' edits, and deletion that demands a fresh sign-in and server confirmation. Same-record conflicts resolve in the order Firestore accepts writes. None of this runs without Firebase values and a proper build — otherwise the app stays a guest.

What it owns

  • Native Google sign-in feeding Firebase credentials
  • Per-account databases with one-time guest import
  • Outbox uploads, pulls, and live listeners
  • Guarded deletion through the trusted endpoint

Files

File list and purposes from the folder README.

FilePurpose
src/features/account/CloudAccountProvider.tsxAccount lifecycle and sync bridge.
src/services/firebase.tsConfiguration gate.
src/services/cloudSync.tsSync engine and statuses.
src/services/accountBootstrap.tsGuest import for new accounts.
src/services/accountDeletion.tsServer-confirmed deletion call.
Cloud sync slice
ScreensFeaturesLocal dataDeviceCloudon-device datacloud sync

Talks to

Sources: src/features/account/CloudAccountProvider.tsx, src/services/cloudSync.ts, src/services/firebase.ts (documented at commit 99a2c3d)

On this page