F Kitchen Sink

UX audit rules

Studio visible H1

Rule handbook metadata

Rule
DET.STUDIO.H1 · lane deterministic
Page status
current
page_version
0280725bc69635b7a8821e8d2776e49243f48742e5bf6b3a589ad9c1d71e7e79
generated_at
2026-08-13T00:00:00.000Z
registry_fingerprint
aef1de6082cf0f50d463783c843dee0ffb9132fbd5ed4ea6e5bb3f031f359c72

How this rule is fixed

Not in the deterministic fixer pilot registry (stub or not yet wired). Use the After example below as the target state and remediate manually or extend pilot-registry.json.

Detection module: docs/design/ux-audit/deterministic-design-rules.md#det-studio-h1. Scroll down for Before / After examples and Evidence and remediation steps.

Purpose

Every Studio workspace route must expose exactly one visible h1 in main (or the Cap header slot). Missing H1 breaks page_identity scoring, screen-reader outline, and DET.STUDIO.TITLE_NAV_MATCH.

Passing signals

  • One h1 with non-empty text inside main.fc-main or .fc-page-header.
  • Visually hidden h1 is allowed only when a visible labelled equivalent exists (prefer visible H1 for operators).

Failing signals

  • No h1; only h2 or rail label carries the page name.
  • Empty h1 or icon-only header.

Before example

Before (failing example)

Operations

Facts

After example

After (passing example)

Facts

Inspect normalized financial facts for the selected issuer.

Evidence and remediation

  • tools/studio-ux-pdca/score-page.mjs — major finding when h1 missing.