`theme-kit validate`

theme-kit validate <file> [options]

Options

Examples

theme-kit validate theme.json
theme-kit validate themes/berry.json
theme-kit validate themes/

The file may be a single theme or a { light, dark } pair; both are validated.

What it checks

validate asserts:

• the root is a theme object (or a light/dark pair),
• required semantic tokens are present (e.g. colors.background, colors.foreground, colors.primary, …),
• theme structure and inheritance are well-formed,
• token references resolve without circular chains,
• contrast pairs meet the accessibility floor.

Output

On success:

✓ Theme is valid: indigo-light + indigo-dark

On failure, it lists every missing token or issue and exits 3:

✗ Theme is invalid: x
  - Missing token: `colors.background`
  - Missing token: `colors.foreground`
  ...
(validation failed for 1 theme)

Exit codes

Because failure is a real nonzero exit code, validate works in any build tool:

theme-kit validate themes/ || exit 1

Next: inspect.