Sync Guide

OwnSpace stores all your notes locally in your browser. Cloud sync allows you to:

• Back up your notes to the cloud

• Restore your data if you clear browser storage

Supported Providers

Setting Up Sync

1. Go to Settings
2. Scroll to the Cloud Providers section
3. Select a provider from the dropdown
4. Enter your credentials (or authenticate via OAuth)
5. Click Connect

For OAuth providers (Yandex Disk, Google Drive), you will be redirected to the provider's login page. After granting access, you will return to the app.

How Sync Works

• Changes are queued locally and synced when a connection is available
• Sync runs automatically after each change (create, edit, delete, rename)
• Both .md notes and attachments/ images are synced
• The sync status indicator in the sidebar shows the current state

Sync Queue

The sync queue shows pending operations. You can view it in Settings under Sync queue:

• Clear queue — removes all pending operations
• Retry errors — retries failed operations
• Clear errors — removes only failed operations

Local Export / Import (ZIP)

If you prefer not to use a cloud provider, you can export all your notes as a ZIP file from the Settings page Export ZIP button. This creates a complete backup including your notes and attached images that you can save anywhere.

To restore your notes, use the Import ZIP button on the same page:

1. Select a .zip file from your device
2. An import progress modal appears with a progress bar
3. .md files inside PARA folders (projects/, areas/, resources/, archive/, inbox/) and attachments/ files are imported — other entries are skipped
4. If a .md file already exists, it gets renamed (e.g. note-2.md, note-3.md) automatically; attachment files are imported directly (duplicates handled by hash)
5. You can cancel the import at any time
6. After completion, sync is automatically triggered if a cloud provider is connected

Troubleshooting

Sync indicator shows "Offline": Check your internet connection.

Changes not syncing: Verify the provider is connected in Settings. Check the sync queue for errors.