Skip to content

v1.50.0 — the demo page standard, checked

Choose a tag to compare

@esanacore esanacore released this 30 Sep 04:44
· 60 commits to main since this release
485b5df

The demo page standard, checked rather than assumed. 1.47.0 made demo.html
a product-facing expectation, but the only mechanical check was that the file
existed; the framework's own page failed the standard it shipped, and nothing
noticed.

Added

  • scripts/check_demo_page.sh checks the Demo Page standard, not just the
    file's presence.
    check_compliance.sh can only see that demo.html
    exists, so a demo that pulled its fonts from a CDN or called an API on
    localhost passed. The new checker reports remote resource loads (scripts,
    stylesheets, preconnects, images, frames, media, SVG <use>/<image>, a
    remote <base>, CSS url()/@import, and JavaScript import/fetch/
    Worker/WebSocket calls with a literal URL), scripts or stylesheets kept
    in separate files, references into build output (dist/, node_modules/,
    ...), URLs in markup or scripts naming localhost or a private network
    address, and a README.md that never links the page. Navigation links,
    local images, and page text are allowed, so a labeled simulated transcript
    can still show curl http://localhost:8080; HTML comments are ignored. Warn
    by default, --strict to block; paired with
    scripts/test_check_demo_page.sh (9 tests, including one regression case
    per finding from the change's own critique pass).
  • constitution-compliance.yml runs the demo page check in warn mode
    whenever demo.html exists, and skips cleanly on constitution pins that
    predate the checker. Adopters see findings as annotations before anything
    turns red.

Changed

  • The constitution's own demo.html no longer loads Google Fonts. The new
    checker's first finding was the framework's own page: three requests to
    fonts.googleapis.com/fonts.gstatic.com, the exact dependency the
    standard forbids. It now uses system font stacks, and tests.yml's
    self-governance job runs check_demo_page.sh --strict against it.