Troubleshooting

Notifications not arriving

Go to iOS Settings → TappRFID → Notifications and confirm Allow Notifications is on.
Check for active Focus modes that might be filtering TappRFID.
Open the app to trigger notification rescheduling.
In TappRFID, go to Settings → Debug → Notifications to see all pending notifications.

See Notifications for full details.

NFC tag not detected

Hold the phone near the top third of the back — that’s where the NFC antenna is.
Remove thick or metal cases — they can block NFC.
Confirm NFC is enabled: iOS Settings → General → NFC → iPhone NFC Reader.
Try a different sticker — the original tag may be locked or damaged.

See NFC Tags for full troubleshooting.

Cloud sync appears stale

Confirm your cloud account is connected: Settings → Cloud Account.
Confirm your cloud subscription is active: Settings → Subscription.
Tap Manual sync in Settings.
Force-quit the app and reopen it on all devices.
Check Settings → Debug → Sync log for specific errors.

See Cloud Sync for full details.

Home Assistant integration not working

Confirm your cloud subscription is active (HA requires cloud).
In TappRFID: Settings → Home Assistant → Verify Connection.
In Home Assistant: check the Tap integration under Devices & Services for errors.
Re-authenticate: remove and re-add the integration in HA.

See Home Assistant for the full setup guide.

Widgets showing stale data or ”—”

Open TappRFID briefly — this refreshes widget data.
Long-press the widget → Edit Widget → reselect the data source.
Delete the widget and re-add it from the widget picker.

See Widgets for details.

App shows a paywall after the trial

After 3 days, TappRFID requires a plan selection to continue. Choose Local Lifetime for one-time access or a Cloud Plan for sync and Home Assistant.

If you already purchased and the paywall reappears after reinstalling:

Go to Settings → Subscription → Restore Purchases.
Sign in to your Apple ID if prompted.

Tasks appear with incorrect status

Task status (overdue / due soon / on track) is calculated from the time of your last completion and the interval. If the status looks wrong:

Check that your device time zone is correct: iOS Settings → General → Date & Time → Set Automatically.
Open the task detail to see the exact last-done timestamp.

Data appears missing after restoring an iPhone backup

If you restored from an iCloud or Finder backup, your local data should be present. If tasks are missing:

Check iCloud → Manage Storage → TappRFID to confirm the app’s data was backed up.
If you use cloud sync, a manual sync from Settings → Cloud Account → Manual sync will restore any cloud-synced data.

Still stuck?

Open an issue or discussion at the project’s GitHub repository, or reach out via the contact details in the App Store listing.