Sitrep: spike-html-hosting

· covering to · goal experiment.html.spike-html-hosting · six of eleven tasks shipped

spike-html-hosting asks what Standards Lab's GitHub Pages sites and its hosted, persistent artifacts look like when published as native web on experiment.html's stack. Three JaimeStill project sites stand in for the organization: this one for org, one for the architecture repository, and one for sqlate's docs/ guide. This entry is for a reader catching up on the spike: what its first six tasks shipped, what they decided, and what comes next.

In short

Task Pull request Merged Proved
layers #1 evidence 1, 7
content #2 evidence 3, 4
screenshots #3 the review's captures
template #4 one SDK by tag
highlighting #5 code per palette
components #6 evidence 4, 6

What shipped

layers

PR #1, merged 2026-11-03. Four repositories: this root as the org stand-in, the architecture and sqlate stand-ins, and spike-html-hosting-components, the layer the components task filled. Each site's base is read from its package name, so a copied site changes only its name and its text. Each site's Pages workflow runs the full check on a push to main before it deploys, and its CI runs the same check on pull requests. The check that no CSS module script is left in a build is ESLint over the build output, proven on six leftover forms and on clean look-alikes.

content

PR #2, merged 2026-11-04. The architecture site renders its 29 front-matter pages, copied at 8706d04, and sqlate its README and docs/ at v0.6.1, each Markdown file a page Vite builds like a file, with no generated files in the tree. Each copy stays byte for byte, held to a record of its source's git blob hashes by a unit test. A .md link becomes its page's link, a link to a file not copied goes to github.com at the pin, and the build fails on any other relative link. A crawl of every page checks each link and fragment. The architect's review redirected the shell: the theme menu now offers every profile, T opens it, and main is a centered reading column.

screenshots

PR #3, merged 2026-11-04. mise run screenshots on every site, through spike-html-apps-tooling's capture bin: every built page, named by its path, whole, at 1280 and 390 wide, light and dark, and split across runs with --page. A test in each site's check runs it and fails if it leaves a capture file behind.

template

PR #4, merged 2026-11-04. spike-html-hosting-sdk v0.1.0 replaced the hand copies across the sites: the Vite plugins, the lint configuration, site.css, the content check, the shell checks, the crawl, the capture description, the currency bin, and reusable Pages and CI workflows. Its release carries a template, and pnpm dlx github:JaimeStill/spike-html-hosting-sdk#v0.1.0 <repo> scaffolds a new site from it. The three sites adopted it by scaffolding into a scratch directory and copying over, keeping their notes, history, and copied trees. One mistake is on the record: the SDK's first pull request merged with its CI red, its failing exit hidden by a pipe; no tag was cut, and a fix-forward release went out green.

highlighting

PR #5, merged 2026-11-05. SDK v0.2.0 highlights code at build with Shiki 4.6.0, with no script on the page. Each palette's code takes the colors of the editor theme the palette comes from, light and dark: Flexoki's own VS Code themes, its green moved to the foundation's hue 142°, and Shiki's bundled primer, catppuccin, and everforest. A site appends a theme for an outside palette. A browser check fails a palette whose code isn't recolored to its theme.

components

PR #6, merged 2026-11-06, with spike-html-hosting-components #3 to #6 and spike-html-hosting-sdk #4 and #5. Components v0.1.0 through v0.2.2 and SDK v0.3.0 and v0.3.1 were released, and the three sites pin SDK v0.3.1 and components v0.2.2. Every page now has the site nav across the three sites, a page header from its front matter, a section tree with reading progress and H and L moving between sections, and a site index that docks as a column where it fits and is a Pages drawer, opened by P, where it doesn't. The SDK's checks now hold every page to no sideways scroll at 390px, no navigation word broken mid-word, main centered and directly under the header, and a keys help dialog that lists every binding. Two of the faults these checks now catch had passed the earlier reviews; the architect found them by viewing the local builds at checkpoint 2.

What was decided

What's next

  1. org, under way: this site's charter, its index of every site, this hosted report, the orientation brief as Markdown and by hand, and the nav fetched live from this site's sites.json, measured against the list built into each components release. Components v0.3.0 and SDK v0.4.0 are released for it.
  2. icons: one icon toolkit, spike-html-hosting-icons, every set available while designing, each build shipping only the icons it uses.
  3. design: the design review of the three sites.
  4. review: the review across every site, a VHS-recorded CLI demo in sqlate's docs, and the cost per site.
  5. answer: the Pages topology, the root URL option, and the components layer's verdict.

Sources

Keyboard shortcuts

Settings