Web App Origin Migration Sample

Available in Chrome 147+ | View on GitHub | Browse Samples

Background

Installed web apps have an unchangable unique identifier, the manifest id member (MDN). This allows the browser to identify the app uniquely, for operations like updating, discovery, and when APIs need to refer to a specific installed web app.

Sometimes an app needs to change this, for a number of possible reasons, such as:

• Architecture changes - moving from:
  • www.mysite.com/app
  • app.mysite.com
• Fixing when 'id' wasn't set and now two apps are installed in the world - merging:
  • www.mysite.com/index.html?first_start_url&usp=etc into
  • www.mysite.com/index.html
• etc.

To test this, run at least Chrome 147 with chrome://flags/#web-app-migration-api enabled.
The following sites are set up to help demo and test this:

• migrate_from/index.html
• migrate_from_forced/index.html
• migrate_to/index.html