From de486a2e23571c211e8c8c173e0c8db010e42e6c Mon Sep 17 00:00:00 2001
From: Jose Olarte III <jose.anomalist.design@gmail.com>
Date: Fri, 6 Mar 2026 18:14:07 +0800
Subject: [PATCH] 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
---
 docs/NOTIFICATION_TROUBLESHOOTING.md | 94 ++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 docs/NOTIFICATION_TROUBLESHOOTING.md

diff --git a/docs/NOTIFICATION_TROUBLESHOOTING.md b/docs/NOTIFICATION_TROUBLESHOOTING.md
new file mode 100644
index 00000000..07a73395
--- /dev/null
+++ b/docs/NOTIFICATION_TROUBLESHOOTING.md
@@ -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 doesn’t 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 it’s 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 you’re 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 don’t see the notification, open **TimeSafari** once. (You don’t 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 don’t 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 don’t need to change anything)
+
+## 4) If it still doesn’t work
+
+- Ensure you’re 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 (you’ll 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**.
+