F Kitchen Sink

UX audit rules

Surface Elevation Token

Rule handbook metadata

Rule
DET.SURFACE.ELEVATION_TOKEN · lane deterministic
Page status
current
page_version
aa7f0a4c0ff4aba8b16ed6191e023d1b65ad619cc02db92b03fb8c8ee846087a
generated_at
2026-05-23T13:24:10Z
registry_fingerprint
2ce40848effce579d3e4879f6ca85535183a14db201870a6c007da424624550c

How this rule is fixed

Pilot deterministic fixer: handbook_after · harness mode standalone · verify expect_rule_clean.

  • Harness: apply-harness-fixture-remediation.py copies the After example HTML from this handbook page onto the defect fixture, then invoke-det-ruleset-remediation-verify.sh re-audits and expects zero findings for this rule.
  • Production sites: run-website-ux-remediation-loop.sh runs handbook_html_patch (HTML patches in lib/ux-deterministic-fixers/fixers/patches/) before invoking the Cursor agent when the quality gate still fails.

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

Purpose

Bootstrap page for the DET ruleset harness. Examples are minimal Kitchen Sink markup aligned with design-rules/deterministic/generated/det-surface-elevation-token.check.js.

Passing signals

  • After example satisfies the rule on audit.

Failing signals

Before example

Before (failing example)

Ad-hoc deep shadow.

After example

After (passing example)

Uses design-system elevation tokens only.

Evidence and remediation

Run generator/build_rule_defect_fixtures.py and auditor-tests/invoke-det-ruleset-harness.sh --only-rule DET.SURFACE.ELEVATION_TOKEN.