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:
- Uninstall the PWA: Long press the Vexly app icon on your home screen, then select "Remove App" or "Delete App"
- Close Safari completely: Swipe up to close all Safari tabs, then force quit Safari from the app switcher
- Wait a few minutes to ensure all cached data is cleared
- Reopen Safari and navigate to vexly.app
- Reinstall the PWA: Tap the Share button (square with arrow), select "Add to Home Screen", then tap "Add"
- Open from home screen (not from Safari browser)
- 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:
- Discord: Join our server and tag @Vu Nguyen or send a DM
- Email: [email protected]
Include your device model, iOS version, and any error messages you're seeing.