Skip to content

Platform support ​

Current as of November 2026. The package always detects a capability in the browser, never the browser brand, and silently skips whatever a platform lacks.

CapabilityiOS / iPadOSAndroidDesktop ChromiumSafari macOSFirefox
Installationmanual (Share → Add to Home Screen), "Open as Web App" by default since iOS 26promptprompt, navigator.install()Add to DockWindows: taskbar (143+)
Display mode from the manifeststandalonestandaloneminimal-uistandaloneown window
display_overridenoyes (without minimal-ui)yesnono
Service worker, offlineyesyesyesyesyes
Navigation Preloadyesyesyesyesyes
Background Syncno → the queue is sent when the user returnsyesyesnono
Badge16.4+yesyesyesno
Web Pushinstalled app only (16.4+)yesyesyesyes
shortcuts, share_targetnoyesyesnono
file/protocol handlers, WCO, tabbed, launch_handlernonoyesnono
Persistent storagethe app has its own day counteryesyes7-day ITP outside the Dockyes

iPhone and iPad ​

  • Installation is manual only; <x-pwa::install/> shows a hint.
  • iOS ignores theme_color from the manifest; the package sends apple-mobile-web-app-* meta tags.
  • iOS has no generated splash screen: without startup images the app opens on a white screen. php artisan pwa:icons --splash creates one per screen size and <x-pwa::head/> links them. iOS uses an image only when the media query matches the device exactly; new models need a package update.
  • Notch and Dynamic Island: viewport-fit=cover + env(safe-area-inset-*).
  • The Home Screen app can have different cookies than Safari.
  • The iOS Simulator doesn't support push; test on a device.

Android ​

  • Tablets and foldables run the same Chrome; drive your layout with media/container queries.
  • Samsung Internet has its own install UI; test it separately.
  • A maskable icon is required; otherwise the system shrinks your icon into a white circle.

Desktop ​

  • Edge and Chrome: minimal-ui with Back and Reload buttons, optionally WCO and tabs.
  • Safari in the Dock: standalone; <x-pwa::nav/> provides the buttons.
  • Firefox (Windows): web apps without manifest integrations; push and offline work.

Pre-release test matrix ​

DeviceBrowsers
iPhone (iOS 26+)Safari, Home Screen app
iPadSafari, Home Screen app, Stage Manager
Android phoneChrome, Samsung Internet
Android tabletChrome
WindowsEdge, Chrome, Firefox
macOSChrome, Safari in the Dock
ChromeOSChrome

For each one, test: installation, window mode, the offline page, a cached page, the queue, maintenance mode, service worker updates, and login after several days.

Released under the MIT License.