Documentation navigation

App

Deployment contract

Serve immutable build assets safely across application releases.

Publish one immutable deployment directory at a time and retain the current deployment plus the previous three. Old open tabs may request lazy page chunks after a new release; preserve their asset trees for that window.

Request Required behavior
/assets/* Fingerprinted files: public, max-age=31536000, immutable; missing file is 404, never app HTML.
/, extensionless routes Current index.html, Cache-Control: no-cache.
index.html, sw.js, version.json, manifest.webmanifest Cache-Control: no-cache.
Unknown extensionless route May fall back to current index.html.

The plugin writes version.json with the same build ID compiled into the application. Retention and prompt-before-reload cannot make incompatible APIs or stored data compatible. Plan those independently; an applied update reloads the document and drops in-memory state.