Consumer asset bundles — UX audit rules

Rule handbook metadata

Rule: DET.KS.CONSUMER_ASSET_BUNDLE · lane deterministic
Page status: current
page_version: cc60b809f05a02ab5625a13fd46819399a67c572e74bea9750bcc4decf8c3765
generated_at: 2026-05-28T20:30:00.000Z
registry_fingerprint: aef1de6082cf0f50d463783c843dee0ffb9132fbd5ed4ea6e5bb3f031f359c72

How this rule is fixed

Pilot deterministic fixer: plan_only · harness mode live_scenario · verify live_scenario.

See fixer module for plan_only in lib/ux-deterministic-fixers/.

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

Purpose

Pages that mount KS markers or react-primitive roots must ship forge-theme / docs-theme CSS and forge-react-primitives (or a Vite bundle that includes them). Live mode verifies linked URLs return HTTP below 400. Scope: KS-only (skipped_scope on generic sites). Static HTML scan checks <link> hints only.

Passing signals

<link href="...forge-theme..."> and ...forge-react-primitives... present when primitives mount.
No broken module/stylesheet URLs in live crawl.

Failing signals

missingPattern forge-react-primitives-stylesheet — primitives mount without primitive CSS.
Asset 404 — Vite assets/*.js or CSS href fails fetch.

Before example

Before (failing example)

After example

After (passing example)

Deterministic checks

DET.KS.CONSUMER_ASSET_BUNDLE — det-ks-consumer-asset-bundle.check.js.

Remediation

Wire consumer index.html or Vite entry to import KS theme + primitive styles before hydrating react roots.