Push Notifications Not Arriving
- Check browser permission: click lock icon → Notifications → Allow
- Check OS notifications: System Settings → Notifications → Browser app
- Check Do Not Disturb / Focus mode is off
- iOS: must be opened from Home Screen icon, not Safari tab
- Dev mode: push doesn't work with
make dev — use make dev-pwa
- Check backend logs for push send errors
- Verify
TEST_MODE=true if using test button
- Check subscription exists:
GET /api/v1/push/subscriptions
Theme Not Switching
- Clear localStorage key
"theme"
- Hard reload:
Ctrl+Shift+R (or Cmd+Shift+R on Mac)
- Check browser dev tools Console for errors
- Verify
<html> element has correct class (dark or light)
Offline Banner Won't Go Away
- Check actual network connection
- Service worker may have cached an error response