Readied Docs
Guide

Cloud Sync

Optional cloud sync via Supabase — backup and sync notes across devices

Cloud Sync

Readied works 100% offline by default. Cloud sync is an optional feature for backing up your notes and syncing them across multiple devices. You never need to create an account or connect to the internet to use Readied.

Authentication

Readied uses magic link email authentication powered by Supabase. There are no passwords to remember.

  1. Open Settings > Account
  2. Enter your email address
  3. Check your inbox for the magic link
  4. Click the link to sign in

Once authenticated, sync begins automatically.

How Sync Works

  • Notes are synced to Supabase cloud storage (PostgreSQL)
  • Sync runs automatically in the background while you work
  • When you go offline, changes are queued locally and pushed when your connection returns
  • Conflict resolution uses a last-write-wins strategy with local priority — your local edits always take precedence if the same note was modified on two devices simultaneously

Because Readied is offline-first, you will never lose work due to a network issue. The local SQLite database is always the primary source of truth.

Sync Status

The sync status indicator in the sidebar footer shows the current state at a glance:

StatusMeaning
SyncedAll notes are up to date with the cloud
SyncingA sync operation is currently in progress
OfflineNo internet connection; changes are queued locally
ErrorSomething went wrong; check troubleshooting below

Privacy

  • Your data is stored in Supabase (PostgreSQL) when sync is enabled
  • All data transfer uses HTTPS
  • You can delete your cloud data at any time from Settings > Account
  • Sync is entirely optional — you can use Readied without ever signing in
  • If you sign out, your local notes remain untouched on your machine

Troubleshooting

Sync appears stuck

Open Settings > Account and use Force Sync to trigger a full re-sync.

Sync shows an error state

  1. Check your internet connection
  2. Try signing out and signing back in to refresh your authentication token
  3. If the issue persists, check the Readied logs for details

Notes not appearing on another device

Make sure you are signed in with the same email on both devices. After signing in, allow a moment for the initial sync to complete.