🔔 iOS Notification Setup

Getting notifications to work on iOS requires a few specific steps. This guide will walk you through the complete setup process and troubleshoot common issues.

📋 Prerequisites

Before setting up notifications, make sure you have:

• iOS 16.4 or later (Check: Settings → General → About → Software Version)
• Safari browser (Other browsers like Chrome won't work for PWA installation)
• Sufficient storage space (The app is small, but iOS needs some free space)
• Network connection (Required for initial setup only)

📱 Step 1: Install to Home Screen

1. Open in Safari
   Navigate to the Aiding Migraine web app using Safari. Make absolutely sure you're using Safari - not Chrome, not Firefox, not any other browser.
2. Tap the Share Button
   Look for the Share button at the bottom of the Safari window (it's a square with an arrow pointing upward).
3. Select "Add to Home Screen"
   Scroll down in the share menu and tap "Add to Home Screen". You may need to scroll down to find this option.
4. Confirm the Name
   You'll see a preview. The name should be "AidMigraine" or "Aiding Migraine". Tap "Add" in the top right.
5. Close Safari
   Navigate back to your home screen. You should see the Aiding Migraine icon.

🔔 Step 2: Enable Notifications in App

1. Launch from Home Screen
   Tap the Aiding Migraine icon on your home screen (NOT from Safari bookmarks).
2. Go to Settings
   Tap the ⚙️ Settings icon in the bottom navigation bar.
3. Enable Daily Check-Ins
   Toggle on "Daily Check-In" notifications. You should immediately see an iOS permission prompt.
4. Allow Notifications
   When iOS prompts "Aiding Migraine Would Like to Send You Notifications", tap Allow.
5. Set Your Time
   Choose what time you want your daily reminder (we recommend 8-9 PM).
6. Save Settings
   Your preferences are automatically saved.

⚙️ Step 3: Verify iOS System Settings

Double-check that iOS system settings are configured correctly:

1. Open iOS Settings
   Go to your iPhone/iPad Settings app (the gray gear icon).
2. Navigate to Notifications
   Scroll down and tap "Notifications".
3. Find Aiding Migraine
   Scroll through the app list and find "Aiding Migraine" (or "AidMigraine"). Tap it.
4. Verify Settings
   Make sure these are enabled:
   • Allow Notifications: ON
   • Lock Screen: ON (to see notifications when locked)
   • Notification Center: ON
   • Banners: ON (choose Temporary or Persistent)
   • Sounds: ON (if you want audio alerts)

🧪 Step 4: Test Your Notifications

The best way to confirm notifications are working:

1. Set a Test Time
   In the app Settings, set your daily check-in time to 2-3 minutes from now.
2. Close the App
   Swipe up from the bottom (or double-click home button) and close Aiding Migraine completely.
3. Lock Your Phone
   Press the power button to turn off the screen.
4. Wait and Check
   At the scheduled time, you should receive a notification on your lock screen.

🔧 Troubleshooting

❌ "I didn't get the permission prompt"

Most common cause: You previously denied notification permission.

Fix:

1. Go to iOS Settings → Notifications
2. Find "Aiding Migraine" in the list
3. Toggle "Allow Notifications" ON
4. Return to the app and toggle notifications on

❌ "I don't see Aiding Migraine in iOS Settings → Notifications"

Most common cause: The app wasn't properly installed to the home screen.

Fix:

1. Delete the current home screen icon (long press → Remove App)
2. Clear Safari cache (Settings → Safari → Clear History and Website Data)
3. Re-install using Safari's "Add to Home Screen" feature
4. Make sure you open it from the home screen icon (not Safari)

❌ "Notifications were working, but stopped"

Possible causes:

• Focus Mode/Do Not Disturb: Check if you have Focus mode enabled (Settings → Focus)
• Low Power Mode: Can delay notifications (Settings → Battery)
• App needs update: Check if an update notification appears in the app
• Notification settings changed: Verify iOS Settings → Notifications → Aiding Migraine

❌ "Notifications arrive late or inconsistently"

iOS manages background tasks aggressively to save battery. This is normal behavior. Notifications might arrive a few minutes late, especially if:

• Your device is in Low Power Mode
• You have many apps sending notifications
• Your internet connection is weak

This is an iOS limitation, not an app bug. Notifications will arrive, just potentially a few minutes after the scheduled time.

❌ "I'm getting notifications at the wrong time"

Check your timezone settings:

1. Go to iOS Settings → General → Date & Time
2. Make sure "Set Automatically" is ON
3. Verify the displayed time zone is correct
4. In Aiding Migraine Settings, toggle notifications off and on to resync

❌ "Notifications work in Test, but not for Daily Check-Ins"

Daily check-in notifications are scheduled server-side. If test notifications work but dailies don't:

1. Make sure you have an active internet connection when enabling notifications
2. Try toggling Daily Check-Ins off, waiting 10 seconds, then back on
3. Check that your set time hasn't already passed today
4. Wait until tomorrow's scheduled time to see if they resume

📞 Still Having Issues?

If you've tried all the troubleshooting steps and notifications still aren't working:

1. Make a note of:
   • Your iOS version
   • What specific steps you've tried
   • Whether test notifications work
   • Any error messages you see
2. Contact our support team with the details above
3. Or report an issue on GitHub

💡 Quick Reference