2D PWAs

2D PWAs behave similarly to the website’s appearance in browser, but launch as a standalone app separate from the browser. Below are specific customizations and expectations for 2D PWAs.

PWAs launch as single-instance, standalone applications with their own entry in the Library. By default, there is no tab or navigation bar on the panel, and the website data and cookies are shared between the Browser and the application.

Out of scope links will open in the PWA by default unless specified to open in a new tab or window, in which case they will open in the regular browser.

The theme color is used when a user is outside the scope of the main application. The color value will be theme_color or theme_color_dark depending on the system theme and will only affect the custom tab bar on the panel.

Add each additional origin that should remain in scope to additional_trusted_origins in the PWA manifest:

{
  "additional_trusted_origins": [
    "https://account.example.com",
    "https://store.example.com"
  ]
}

Publish /.well-known/assetlinks.json on the primary origin and every additional trusted origin. Each file must authorize the PWA’s Android package and signing certificate.

For all media needs, PWA media capabilities match those of the Browser.

Once you have set up and hosted your web app manifest, check out the PWA Packaging page to build your installable application.