Distribution Surfaces

Treat distribution as a product choice. Browser install is the default. Store wrappers are extra release channels with policy and signing work.

flowchart TD
    web[Web app URL] --> browserInstall[Browser install]
    web --> desktopInstall[Desktop app surface]
    web --> mobileHome[Mobile home screen]
    web --> msStore[Microsoft Store package]
    web --> twa[Android TWA]
    web --> iosWrapper[iOS wrapper]

    msStore --> partner[Partner Center]
    twa --> play[Play Store]
    iosWrapper --> appStore[App Store review]

Surface Comparison

SurfaceWhat shipsGood forMain risk
Browser tabNormal websiteUniversal accessNo app icon or app switcher presence
Browser installSame website plus manifest identityFast install, desktop/mobile retentionBrowser-specific prompts and criteria
Microsoft StorePackage generated from PWA metadataWindows discovery and enterprise install flowsPartner Center, package identity, metadata updates
Android TWAAndroid shell that opens verified PWA URLPlay Store distribution for web-first appsDigital Asset Links, signing, Play policy, browser dependency
iOS wrapperNative shell or WebView appApp Store presence when justifiedReview policy and native-value expectations

Packaging Rule

Package only after the web app passes browser PWA quality gates. A wrapper amplifies app quality; it does not fix broken offline, bad icons, poor performance, or unclear permissions.