# iCloud Sync

iCloud Sync lets you keep Weavestream in sync across multiple Macs signed into the same Apple ID. Your sources, items, conversations, and settings are automatically kept up to date on every device.

# Enabling iCloud Sync

1. Open Settings (Cmd+Comma) and go to the iCloud tab
2. Toggle on Sync with iCloud
3. If you already have data on this device, a confirmation prompt warns you that data from your other devices will be merged in. Duplicates may appear if the same sources exist on multiple Macs.
4. Restart Weavestream when prompted — the sync change takes effect after a restart

When sync is active, you'll see a blue iCloud icon with the message: "iCloud sync is enabled — data will sync across devices."

# What Gets Synced

Each device keeps its own sync schedule independently — enabling sync on one Mac doesn't cause another Mac to immediately re-sync all sources.

# How Other Devices Pick Up Sync

When you enable iCloud Sync on one Mac, your other Macs detect this automatically on their next launch. They'll show a prompt letting you know sync has been turned on and ask you to restart to activate it.

If you'd prefer a specific device to stay local, just turn the toggle off on that device. Disabling sync is per-device — it doesn't affect other Macs.

# Credential Syncing

API keys and tokens are synced via iCloud Keychain — Apple's encrypted credential sync system — rather than CloudKit. This means credentials are end-to-end encrypted and synced separately from the rest of your data, through the same system that syncs Safari passwords.

# Disabling iCloud Sync

1. Open Settings → iCloud
2. Toggle off Sync with iCloud
3. Confirm in the prompt — your local data is not deleted
4. Restart Weavestream

Turning off sync only affects that device. Your data remains in iCloud and on any other Macs that still have sync enabled. Nothing is deleted from iCloud when you disable on one device.

# Backup & Restore

Before iCloud sync is first activated, Weavestream automatically creates a local backup of your database. If something goes wrong after enabling sync — for example, unexpected duplicates or data issues — you can restore from this backup.

The Restore from Backup option appears in the iCloud settings pane if a pre-sync backup is available:

1. Click Restore
2. Confirm the prompt — this replaces your current database with the pre-sync backup and turns off iCloud sync
3. Restart Weavestream

Note: Restoring from backup replaces all current data on this device with the state from before sync was enabled. iCloud data and other devices are not affected.