A11y Contrast Badge
Check in the browser whether the theme palette meets AA before opening the PR.
Choose the primitives library your project already uses. Both look the same: your theme, not the variant, controls colors, shape, type and motion.
About this block
What it's for
- Check in the browser whether the theme palette meets AA before opening the PR.
- Fail the CI build when someone darkens a token and breaks secondary text contrast.
- Audit a brand theme against AAA without changing the application code.
Includes
- Wcag contrast ratio
- Oklch color parsing
- Lab color parsing
- Token sheet audit
- Live computed style audit
- Theme reactive remeasure
- Build time gate
- Marginal pass detection
Works with
- Radix UI and Base UI primitives (pick the one your project uses)
- React 19, Next.js App Router and Tailwind CSS 4, installed with the shadcn CLI
- Your theme tokens, in light and dark mode
Install
Included with Agentic UI Kit (one-time license). Install needs your license key: see pricing · connect your project.
Agentic UI CLI
agentic-ui add a11y-contrast-badgeInstalls through shadcn and adapts the component to your design tokens.
shadcn CLI
npx shadcn@4.17.0 add @agentic-ui/a11y-contrast-badgeUsed in
A standalone component: drop it into any screen.
- Type
- Block
- Variants
- Radix UI and Base UI
- Themes
- Light and dark
- Widths
- Preview it at desktop, tablet and mobile widths above.
- npm packages
- None beyond your project's React and Next.js
- Registry dependencies
- None
- Files
5 files
- components/agentic-ui/a11y-contrast-badge/a11y-contrast-badge.tsx
- components/agentic-ui/a11y-contrast-badge/pairs.ts
- components/agentic-ui/a11y-contrast-badge/contrast.ts
- components/agentic-ui/a11y-contrast-badge/use-contrast-audit.ts
- components/agentic-ui/a11y-contrast-badge/report.ts
Related components
A11y Focus Manager
Confirmation dialog that returns focus to the button that opened it.
Details and live previewA11y Live Announcer
Announce the number of results when filtering a table without reloading the page.
Details and live previewA11y Skip Links
Skip the side navigation and header to reach the main content.
Details and live previewAI Action Confirmation
Operations agent that asks to drop production tables and shows the rows, size and last use of each one.
Details and live preview