Skip to content

Sync setup

Open Sync in the sidebar or the status chip in the header. The chip is always visible: it reads Sync off, Cloud or Private, pending count, or Sync error.

First-time setup

  1. Choose Cloud sync or Private sync (E2EE).
  2. Choose Start Cloud sync or Start Private sync.
  3. If you chose Private, copy the recovery key and choose I have saved this key. The app will not show the key again.
  4. Choose Push and pull after you work offline.

This checkout talks to a local sequencer (the same protocol as Supabase/Postgres). A live project is not required yet.

Status

LabelMeaning
Sync offThis device has no household cursor.
Cloud · up to dateOutbox is empty and the cursor matches the server.
Cloud · N pendingLocal mutations are waiting to push.
Private · offlineThe device is not sending. Work stays in the outbox.
Sync errorThe last push was rejected; open Sync for the reason.

A clock more than five minutes off the server is warned and clamped. Ordering is still server_seq.