shadcn · UI

`SHAD0003`Avoid arbitrary Tailwind values

Use the design system's existing values instead of arbitrary utilities.

vite-doctor/shadcnuiwarnSuggestion

shadcn/no-arbitrary-values src/rule-packs/shadcn/rules/index.ts Upstream docs

Why it happens

Arbitrary utility values bypass theme tokens and scale values, making appearance harder to change consistently. Exceptions follow the configured class policy.

Fix

Choose an existing theme token or scale utility that matches the intended design. Review suggested replacements before applying them.

Example

Use the spacing scale

Before

<div className="p-[16px]">Account settings</div>

After

<div className="p-4">Account settings</div>

Verify the fix

Run only this rule after editing so the report stays focused on the diagnostic you are closing:

pnpm vite-doctor . --extends shadcn/strict --rules shadcn/no-arbitrary-values

Useful links

Upstream docs

shadcn/no-arbitrary-values

SHAD0003Avoid arbitrary Tailwind values