Automated testing

Unit, component, e2e, and accessibility automation for the design system. Run locally in CI — and try axe live on the lab below.

One-command suite

npm run test runs unit tests, then e2e route smoke against the running preview (or BASE_URL). Use npm run test:a11y for axe scans.

Unit & component tests
cn(), hooks, Button, registry contracts

npm run test:unit

DOM assertions
roles, labels, disabled state

used by Vitest

Accessibility engine
WCAG rule violations in the browser

npm run test:a11y

E2E smoke + axe runner
Critical routes load with content, no page errors

npm run test:e2e

Static types
Route and component type safety

npm run typecheck

Commands

Scripts live in package.json. Scanners: scripts/e2e-routes.mjs, scripts/a11y-scan.mjs.

E2E smoke hits these paths. Expand the list in src/lib/testing.ts.

/installation

/accessibility

/components

/components/button

/patterns/forms

/experience

/devices

/testing

/integrations

See src/components/ui/button.test.tsx and src/lib/utils.test.ts.

Runs axe-core in the browser against the sample panel. Intentional issues can be toggled for demos — fix them and re-scan.

CI recipe