docs: add end-user notification troubleshooting guide (iOS/Android)

- Add docs/NOTIFICATION_TROUBLESHOOTING.md for daily reminder/check-in
- Cover in-app settings, iOS (notifications, Focus), Android (notifications, exact alarms, battery)
- Include checklist table and note to backup identifier seed before uninstall
This commit is contained in:
Jose Olarte III
2026-03-06 18:14:07 +08:00
parent 94f31faacc
commit de486a2e23

View File

@@ -0,0 +1,94 @@
# TimeSafari — Daily notifications troubleshooting (iOS & Android)
**Last updated:** 2026-03-06 17:08 PST
**Audience:** End-users
**Applies to:** TimeSafari iOS/Android native app (daily notifications scheduled on-device)
If your **Daily Reminder** or notification doesnt show up, follow the steps below.
## Before you start
- These notifications are **scheduled on your device** (no browser/web push).
- If you previously followed an older “web notifications” guide, those steps no longer apply for iOS/Android builds.
## 1) Check your in-app notification settings
- Tap **Profile** in the bottom bar
- Under **Notifications**, confirm:
- **Daily Reminder** is **enabled**
- The **time** is set correctly
- The message looks correct
- If its already enabled, try to:
- Turn it **off**
- Turn it **on** again
- Re-set the time and message
## 2) iOS troubleshooting
### Allow notifications for TimeSafari
1. Open **Settings****Notifications**
2. Tap **TimeSafari**
3. Turn **Allow Notifications** on
4. Enable at least one delivery style (recommended):
- **Lock Screen**
- **Notification Center**
- **Banners**
5. Optional but helpful:
- **Sounds** on (if you want an audible reminder)
### Focus / Do Not Disturb
If youre using **Focus** or **Do Not Disturb**, notifications may be silenced or hidden.
- Open **Settings****Focus**
- Check the active Focus mode and ensure **TimeSafari** is allowed (or temporarily disable Focus to test)
### After restarting your phone
If you recently restarted iOS and dont see the notification, open **TimeSafari** once. (You dont need to change anything.)
## 3) Android troubleshooting
### Allow notifications for TimeSafari
1. Open **Settings****Apps**
2. Tap **TimeSafari****Manage notifications** (wording varies)
3. Turn notifications **on**
4. If Android shows notification categories/channels for the app, ensure the relevant channel is allowed.
### Exact alarms (Android 12+ / some devices)
Daily notifications may require **Exact alarms** to fire at the precise time.
- Open **Settings****Apps****TimeSafari**
- Look for **Alarms & reminders** / **Exact alarms** (wording varies)
- Turn **Allow** on
If you dont see that option:
- Search Android settings for **Exact alarms**, **Alarms & reminders**, or **Special app access**
### Battery / background restrictions
Battery optimization can delay or block scheduled notifications.
- Open **Settings****Apps****TimeSafari****Battery usage** (wording varies)
- If available:
- Set **Battery usage** to **Unrestricted**
- Turn **Allow background usage** on
- Disable optimization for TimeSafari
- If your device has lists like **Sleeping apps** / **Restricted apps**, remove TimeSafari from them
### After restarting your phone
Depending on the device manufacturer, Android can clear scheduled notifications during a reboot. If you restarted recently:
- Open **TimeSafari** once (you dont need to change anything)
## 4) If it still doesnt work
- Ensure youre on the latest TimeSafari app version.
- If you denied permission earlier, re-enable notifications in system settings (above).
- As a last resort, uninstall/reinstall the app (youll need to enable notifications again and reconfigure the daily reminder). **Important:** Before uninstalling, back up your identifier seed so you can import it back later: **Profile → Data Management → Backup Identifier Seed**.