Skip to content

Support "Add to Home Screen" + push notifications for iOS #306

Description

@JanWelker

Add PWA support so the app can be used like a native app on iOS, including system-level push notifications.

Requirements:

  • Add a manifest.json (name, icons, display: "standalone")
  • Serve over HTTPS (required for both PWA install and push)
  • Implement Web Push API (Notification, PushManager, service worker) for push notifications
  • Notification permission request triggered by explicit user gesture, not on page load
  • Small backend/serverless piece to store push subscriptions and send payloads via the push service

Constraints (iOS 16.4+):

  • Push only works once the app is added to the Home Screen — Safari tabs cannot request push permission
  • Removing the Home Screen icon kills the subscription; user must re-add and re-subscribe
  • No silent/background push triggering app logic — visible notifications only
  • Badge counts supported via navigator.setAppBadge()

Acceptance criteria:

  • Manifest + icons added, app installable from Safari share sheet
  • Service worker registered, push subscription flow implemented
  • User can opt in to notifications via in-app button
  • Notifications received on iOS 16.4+ after Home Screen install

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions