Skip to content
Tutorials Center
My learning

Topics

Lesson 33 of 37 ยท Installability and Distribution

Store Distribution: TWA, PWABuilder and More

Put a PWA in app stores: Trusted Web Activity, Bubblewrap, Digital Asset Links, PWABuilder, Microsoft Store, Samsung, iOS wrappers with Capacitor and what stores expect.

A PWA does not need an app store: users can install it straight from the browser. But many people look for apps in stores, and a store listing brings search visibility, reviews, in-app purchase options and a sense of legitimacy. The good news is that you do not rewrite the app. Stores accept a thin native wrapper around your web app, and in some cases the PWA itself.

This lesson explains the packaging options for each store, how Android verifies that you own the site, what the stores check, and how to decide if store distribution is worth the extra effort. The commands are read-only because they run on your machine, but small runnable checks help you validate the files stores depend on.

The options at a glance

Store How a PWA gets there Format
Google Play Trusted Web Activity (TWA) Android App Bundle (.aab)
Microsoft Store Package from the URL with PWABuilder MSIX
Samsung Galaxy Store TWA/APK, same as Android .apk
Apple App Store Native wrapper (WKWebView), for example Capacitor Xcode project, .ipa
Meta Quest, Huawei AppGallery and others Store-specific; often TWA-like wrappers varies
flowchart LR
  P["Your PWA on HTTPS"] --> T["Bubblewrap / PWABuilder"]
  T --> A["Android App Bundle (TWA)"]
  T --> M["MSIX package"]
  P --> C["Capacitor / Xcode wrapper"]
  C --> I["iOS app"]
  A --> G["Google Play"]
  M --> W["Microsoft Store"]
  I --> S["App Store"]

One web app, several thin packages.

Google Play: Trusted Web Activity

A Trusted Web Activity is an Android activity that opens your website in full-screen Chrome with no address bar. It is not a WebView: it shares Chrome's engine, storage, service workers and permissions, so the app behaves like your installed PWA. To keep the address bar hidden, Android must verify you own both the app and the site.

Tools:

  • Bubblewrap (command-line, from the Chrome team) generates the Android project from your manifest: npx @bubblewrap/cli init --manifest https://example.com/manifest.webmanifest, then bubblewrap build.
  • PWABuilder (pwabuilder.com) wraps the same idea in a web interface: paste your URL, review the report and download a ready package.

Verification uses a file at https://example.com/.well-known/assetlinks.json that lists the Android app's package name and the SHA-256 fingerprint of its signing certificate:

JSON
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.notes",
      "sha256_cert_fingerprints": [
        "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
      ]
    }
  }
]

Google Play re-signs your app with its own key when you use Play App Signing, so you must add the fingerprint from the Play Console App signing page too (and keep the upload key fingerprint if you test locally). A missing or mismatched fingerprint is the most common reason a TWA shows a browser address bar.

JS Validate an assetlinks.json file

Press Run (or Ctrl + Enter) to see the console output here.

No output.

The file must be served over HTTPS at the exact path with a 200 status, no redirects, and a JSON content type.

Microsoft Store

PWABuilder can package your PWA as an MSIX and walk you through submitting it. Windows apps run in an Edge WebView with access to your service worker. Windows also installs PWAs directly from Edge. Store listing rules: a clear description, screenshots, privacy policy, and an age rating questionnaire.

Apple App Store

Apple does not run PWAs in the store directly. The route is a native wrapper project: Capacitor (or Cordova, or a hand-written WKWebView app) bundles your built web files inside an Xcode project and gives you access to native plugins. Things to plan for:

  • A Mac, Xcode and an Apple Developer Program account (paid yearly).
  • Apple's guideline 4.2 rejects apps that are "just a website"; include real native value such as push via APNs, widgets, in-app purchase, or deep integration with the share sheet or camera.
  • WKWebView does not use Safari's service worker caching the same way, so test offline behavior carefully inside the wrapper.

What every store checks

  • Privacy policy link, and accurate data-collection disclosures.
  • Content and age ratings.
  • Working sign-in for reviewers: give them a demo account.
  • Digital goods rules: Google and Apple expect in-app purchases for digital content consumed inside the app, with specific exceptions. Read the current policy before building payments into a wrapped app.
  • Quality: crashes, offline behavior and broken links get apps rejected.

Is it worth it?

JS A rough decision helper

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Start with the browser install, then add the Play Store (cheapest and most similar to a PWA), then Microsoft, and only then decide whether an iOS wrapper is worth maintaining. Each store adds review work and an update channel, so measure installs from the browser first. Keep one source of truth: updates to the website reach TWA users instantly, with no store re-submission for web changes.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. What is a Trusted Web Activity?

    TWAs use Chrome itself, sharing its storage and service workers.
  2. 2. What proves site and app ownership to Android?

    Digital Asset Links connect the domain to the app's signing certificate.
  3. 3. Why might a TWA show an address bar?

    Without verified ownership Chrome falls back to a Custom Tab with a URL bar.
  4. 4. Which is the typical route for iOS App Store distribution?

    Apple needs a native app binary; wrappers like Capacitor host your web code.

Summary

  • Store distribution is optional packaging; the PWA stays the single source of truth.
  • Google Play uses Trusted Web Activity with Bubblewrap or PWABuilder and a correct assetlinks.json.
  • Microsoft Store packages through PWABuilder; Apple needs a native wrapper with real native value.
  • Prepare privacy policy, reviewer access, payment-rule compliance and offline quality.

Next: Advanced PWA Capabilities