Push notifications not working

How to fix push notification issues on iOS and other devices, including the "Service worker not ready" error

Push Notifications Not Working

If push notifications won't enable or you see them spinning forever with "enabling" status, this is usually a PWA (Progressive Web App) issue on iOS devices.

Complete Reinstall Process

The most reliable fix is to fully uninstall and reinstall the Vexly PWA:

  1. Uninstall the PWA: Long press the Vexly app icon on your home screen, then select "Remove App" or "Delete App"
  2. Close Safari completely: Swipe up to close all Safari tabs, then force quit Safari from the app switcher
  3. Wait a few minutes to ensure all cached data is cleared
  4. Reopen Safari and navigate to vexly.app
  5. Reinstall the PWA: Tap the Share button (square with arrow), select "Add to Home Screen", then tap "Add"
  6. Open from home screen (not from Safari browser)
  7. Try enabling push notifications again

Check Device Settings

If reinstalling doesn't work, check these iOS settings:

Disable Screen Time/Content Restrictions: Settings > Screen Time > Content & Privacy Restrictions

Turn Off Low Power Mode: Settings > Battery > Low Power Mode

Disable iCloud Private Relay: Settings > Apple ID > iCloud > Private Relay

Use Strong WiFi: Avoid cellular connections during notification setup

Clear Safari Cache: Settings > Safari > Clear History and Website Data

Check Storage: Make sure you have adequate free storage - iOS evicts PWA cache when storage is low

"Service Worker Not Ready" Error

If you see "Service worker not ready (after 10000ms)" in technical details, follow the complete reinstall process above. Make sure you're opening the PWA from the home screen, not from the Safari browser.

Still Not Working?

If you're still experiencing issues, please reach out:

Include your device model, iOS version, and any error messages you're seeing.