How Sync Works 🔄

SpudSuite syncs your data to your own cloud storage. We never see it, store it, or have access to it. Here's how.

The Architecture

SpudSuite is local-first:

1. Local storage: All your data lives on your device first
2. Background sync: Changes push to your cloud storage automatically
3. Pull on open: When you open SpudSuite, it fetches any remote changes
4. Conflict resolution: If two devices edited the same note, we merge intelligently

Supported Cloud Providers

What Gets Synced

• ✅ Notes (content, title, metadata)
• ✅ Folders structure
• ✅ Tags
• ✅ Todos and lists
• ✅ Kanban boards and cards
• ✅ Settings and preferences
• ✅ Pro status

Where Data is Stored

SpudSuite creates a folder in your cloud storage:

Google Drive: /SpudSuite/
Dropbox: /Apps/SpudSuite/
iCloud: /SpudSuite/

Inside, you'll find:

SpudSuite/
├── notes/
│   ├── note-abc123.json
│   ├── note-def456.json
│   └── ...
├── folders/
│   └── folders.json
├── todos/
│   └── todos.json
├── boards/
│   └── board-xyz789.json
└── settings.json

Files are plain JSON. You can read them directly if you want — they're yours.

Sync Frequency

• Real-time: Changes sync within seconds when online
• Offline: Changes queue locally and sync when you reconnect
• Manual: Pull down to refresh on mobile, or click the sync icon

Conflict Resolution

If you edit the same note on two devices before they sync:

1. SpudSuite detects the conflict
2. By default, last-write-wins — the most recent edit is kept
3. If both edits are within 60 seconds, you'll see a conflict banner
4. Click the banner to view both versions and choose which to keep

OAuth & Security

When you connect a cloud provider:

1. You're redirected to Google/Dropbox login (not our servers)
2. You authorize SpudSuite to access only its app folder
3. We receive an access token stored locally on your device
4. The token is used to read/write directly to your cloud

SpudSuite requests minimal permissions:

• Google Drive: drive.appfolder (app-specific folder only)
• Dropbox: files.content.write (app folder only)

We cannot see your other files. Ever.

Disconnecting

To stop syncing:

1. Go to Settings → Cloud Sync
2. Click Disconnect
3. Your local data stays. Cloud data stays. They just stop talking.

To delete cloud data, manually remove the SpudSuite folder from your cloud storage.