Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.turso.tech/llms.txt

Use this file to discover all available pages before exploring further.

This particular usage uses the Turso Cloud to sync the local Turso databases and assumes that you have an account.

Last Push Wins

Turso sync uses a last push wins strategy. When two clients modify the same data and push, the last push determines the final state on the remote.
TimeClient AClient B
T1UPDATE users SET name='Alice' WHERE id=1
T2UPDATE users SET name='Bob' WHERE id=1
T3push()
T4push()
Result: The name is 'Bob' because Client B pushed last.

What Happens During Pull

When you pull and have unpushed local changes:
  1. Your local database is rolled back to the last synced state
  2. Remote changes are applied
  3. Your unpushed local changes are replayed on top
This rollback-and-replay happens atomically — if anything fails, your database remains in its previous state.