How cloud sync works
Short guide. The full contract for engineers lives in docs/sync-contract.md in the repository.
What turns on
With cloud sync enabled and you signed in, mtrac keeps a copy of your data on the server and refreshes your browser's local database from that copy. Day-to-day edits are written through to the server when you are online.
First sync from this browser
If this device had data created before cloud sync was ever enabled, the first upload replaces everything already stored for your account on the server with what is in this browser. If you are not sure, export a JSON backup from Settings first.
Using more than one device
- Prefer one device at a time for making changes. The server resolves conflicts using last-write-wins — there is no merge of two different offline sessions.
- After switching devices, open Settings and use Re-sync if numbers look stale.
- Row deletions may not propagate instantly to every browser over incremental sync; a full refresh path exists when you pull a complete snapshot again.
What this is not
Cloud sync is not bank linking or live UPI import. It is your mtrac data model mirrored to your account on the server you trust (self-hosted or otherwise).