What problem does it solve?
It prevents inconsistent UI styling by enforcing a token-first workflow in Tailwind CSS v4, reducing pixel-level drift and fragile arbitrary values across the codebase.
Core Features & Use Cases
- Token-first design flow: Recommends checking existing @theme tokens before using arbitrary values, and extending @theme when the design exceeds current token ranges.
- Controlled customization: Uses @utility and @custom-variant (e.g., dark mode) to create reusable, consistent styling behaviors instead of ad-hoc class strings.
- Project-safe constraints: Enforces a rule that literal pixel arbitraries like text-[13px] are banned, aligning component typography, spacing, and visual density with the project’s axis system.
Quick Start
Apply Tailwind v4 by starting from existing @theme tokens in App.css, creating new tokens in @theme only when needed, and otherwise using semantic utilities or @utility for reusable effects.