PWA Origin Migration — Demo

How it works

The old app’s manifest adds migrate_to (pointing at the new app), and the new app’s manifest adds migrate_from (listing the old app). The browser then offers to move the installed app across, like a normal app update.

Feature flag

edge://flags/#web-app-migration-api (on by default)

Same-site rule

Old and new IDs must share the same registrable domain (eTLD+1).

Inspect

edge://web-app-internals · edge://apps

The two apps

This demo migrates between two paths on the same origin. Install the old app, then follow its steps.

Moving to a new subdomain

The same handshake works across a same-site origin change, such as example.com/app → app.example.com. That case also needs a /.well-known/web-app-origin-association file on the old origin. See the README for the exact snippets.