How-to
Website
Web app
Offer a new version
Tell the reader of an offline site that a new version has been deployed, and let them reload into it when they choose. This needs offline support turned on (Make a site work offline). This home page offers a reload when a new version is ready, and shows how many changes are waiting to be sent:
Needs: offline in webfluent.app.json (Make a site work offline) and a host that serves the site over HTTPS. It claims /: paste it into a new project, or replace the starter's src/pages/Home.wf with it.
page Home(path: "/", title: "Home", description: "The front page.") {
if update.available {
Button("A new version is ready — reload") { on click { update.apply() } }
}
if network.queued > 0 {
Text("{network.queued} change(s) will be sent when you are back online").muted
}
Heading("Home").h1
}
How it works
- Every deploy is a version. The worker is versioned by a hash of everything the build wrote, so any deploy that changes a byte is a new version.
- The new version waits. It installs beside the old one and waits.
update.availableturns true when it is ready. update.apply()takes it and reloads the page once. It never reloads on the first install, which only takes over a page that already works, and never twice for one update. The old version's cached files are deleted when the new one takes over.network.queuedis how many writes made offline are waiting (Keep writes made offline).