Cloud Sync

Cloud sync is entirely optional. TappRFID is fully functional without an account. Enable sync when you want data across multiple devices or Home Assistant access.

Requirements

• Active cloud subscription (trial or paid)
• iOS 16 or later

Setting up cloud sync

1. Open Settings → Cloud Account.
2. Tap Sign In.
3. Complete the OAuth sign-in flow in Safari.
4. Return to the app — your account shows as connected.
5. Enable Cloud Sync in Settings.

The first sync will upload all your existing local data. This may take a moment if you have a long history.

How sync works

Local-first

Your device holds the canonical copy of your data. Sync is additive — it brings changes from other devices in, and pushes your changes out. If you’re offline, the app works normally and syncs when you reconnect.

Sync direction

All five modules sync: tasks, completions, logs, log entries, and events. Settings (like accent colour and enabled modules) also sync.

Conflict resolution

If two devices update the same record at different times, TappRFID uses last-write-wins — the most recent change takes effect. For a single-user app where you’re typically the only writer, this works correctly in the vast majority of cases.

Deletions

Deleted items use soft-delete — a tombstone is recorded so other devices know to remove the item rather than treating it as missing data. This prevents deleted items from reappearing after sync.

Incremental sync

Only changes since your last sync are transferred. Full syncs do not happen on every launch. This keeps sync fast and battery-efficient.

Multi-device setup

TappRFID syncs across any iPhone or iPad connected to the same account. To add a second device:

1. Install TappRFID on the second device.
2. Complete the free trial or purchase on that device.
3. Go to Settings → Cloud Account → Sign In using the same account.
4. Enable Cloud Sync.

Data will merge automatically. Existing local data on the second device is preserved and merged with cloud data.

Signing out

Signing out of your cloud account stops sync. Your local data is unchanged — all tasks and history remain on the device. You can sign back in at any time to resume syncing.

Troubleshooting

Sync appears stale or stopped:

1. Confirm the account is still connected: Settings → Cloud Account.
2. Confirm the subscription is active.
3. Tap Manual sync to force an immediate sync.
4. Check Settings → Debug → Sync log for errors.

Data appears on one device but not another:

1. Open the app on the device that’s missing data — this triggers a sync.
2. Wait 30 seconds and pull-to-refresh.
3. If data is still missing, tap Manual sync.

Conflict: a task shows old data after sync:

• The last write wins. If device A and device B both edited the same task while offline, whichever synced last is the current version.
• This is expected behaviour. It’s rare in practice because most users are the only editor on each device.

---

For Home Assistant integration (which requires cloud), see the Home Assistant guide.