item-34 - Serve every /public/ asset under a content-versioned URL with an immutable Cache-Control

2026-10-31 10:00:03 +01:00
parent 910ac18798
commit 3d757d4726
18 changed files with 340 additions and 88 deletions
@@ -6,6 +6,15 @@ at boot. Entries start at 0.3.0.

 ## Unreleased

+### Browsers cache stylesheets instead of downloading them on every page
+
+Every `/public/` URL the host renders carries `?v=<hash of the file>` and is cached for a year as
+immutable: the shell's stylesheets, favicon and logo, the `styles` a plugin passes to the shell, and
+the standalone error and consent pages. A release changes the hash, so browsers fetch a changed file
+at once. A plugin names its stylesheets exactly as before. Any other `/public/` URL, such as a script
+a plugin's own markup links, is cached for five minutes, then revalidated with `ETag` or
+`Last-Modified`. A cache or CDN in front of Plainpages may now store `/public/` responses.
+
 ### A language chosen on a sign-in link no longer drops an absolute return target

 `/login?return_to=<absolute URL>&locale=sv-SE` passed the visitor to the dashboard after sign-in and