Skip to content

docs-app: restore site styling layer, add page-walking a11y tests - #22

Merged
NullVoxPopuli merged 2 commits into
universal-ember:mainfrom
NullVoxPopuli-ai-agent:docs-app-polish
Jul 20, 2026
Merged

docs-app: restore site styling layer, add page-walking a11y tests#22
NullVoxPopuli merged 2 commits into
universal-ember:mainfrom
NullVoxPopuli-ai-agent:docs-app-polish

Conversation

@NullVoxPopuli-ai-agent

Copy link
Copy Markdown
Contributor

Fixes the broken CSS/behavior on https://ue-form.pages.dev/ and adds the docs-app test suite in ember-primitives' style.

The bug

docs-support's Shell imports the structural site CSS itself, but the app owns the layer primitives defines in its own app.css — the CSS reset, the --font-sans stack and body { font-family }, prose/typedoc overrides, and crucially the .theme-light / .theme-dark custom-property definitions the chrome reads. I had only carried over the typedoc/demo styles, so the deployed site fell back to browser-default serif typography ("CSS broken") and the theme toggle toggled classes that defined nothing ("behavior broken").

Ported that layer and verified in a real browser against the production build: sans-serif typography everywhere and the toggle now visibly flips light/dark.

Tests (ported from ember-primitives)

  • One application test walks every page in the kolay manifest, and for each: visits it, runs an axe-core audit in default/dark/light themes (color-contrast disabled, matching primitives), and asserts no [data-page-error] — kolay renders that marker when a live demo fails to compile, so broken demos now fail CI.
  • testem with ember-a11y-testing's middleware reporter; vite build --mode development && testem ci.
  • Root pnpm test now runs all workspace test tasks, so the Default Tests and Floating Deps jobs cover docs-app; the try-scenarios job stays scoped to --filter test-app (scenarios only vary test-app's dependencies).

All pages currently pass the audit (163-assertion run, ~7s locally).

Full turbo build lint test typecheck: 16/16 green.

🤖 Generated with Claude Code

NullVoxPopuli-ai-agent and others added 2 commits July 20, 2026 11:50
The deployed site rendered with browser-default (serif) typography and a
theme toggle that changed nothing visible: docs-support's Shell brings
the structural site CSS, but the app itself is responsible for the layer
ember-primitives' docs-app defines in app.css — the reset, the
--font-sans stack + body font-family, prose/typedoc overrides, and the
.theme-light/.theme-dark variables the chrome reads. Ported that layer
(verified in a browser: sans-serif typography and a working visible
theme toggle).

Also port ember-primitives' docs-app test setup:
- an application test walks every page in the kolay manifest, runs an
  axe-core audit per page in default/dark/light themes
  (color-contrast off, matching primitives), and asserts no
  [data-page-error] — which is exactly the signal for a live demo
  failing to compile/render
- testem with ember-a11y-testing's middleware reporter,
  vite build --mode development + testem ci
- root `pnpm test` now runs all workspace test tasks; the try-scenario
  job stays scoped to test-app (scenarios only vary its deps)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The middleware reporter writes a JSON report per test run; two of them
were swept into the previous commit and failed prettier in CI.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor
Project Preview URL
Docs https://e2a25f66.ue-form.pages.dev

Logs

@NullVoxPopuli NullVoxPopuli added the documentation Improvements or additions to documentation label Jul 20, 2026
@NullVoxPopuli
NullVoxPopuli merged commit e48e9a8 into universal-ember:main Jul 20, 2026
13 of 14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants