stylelint-config-validator#

Validate Stylelint configuration files for correctness, deprecated rules, and best practices.

What it does#

Checks .stylelintrc / .stylelintrc.json / .stylelintrc.yaml for:

• Rules — unknown rules, deprecated rules (70+ deprecated in Stylelint 16), null values, many disabled rules
• Config structure — unknown config keys, extends/plugins arrays, override validation
• Deprecated rules — blacklist→disallowed-list renames, removed formatting rules (use Prettier instead)
• Extends — duplicate entries, prettier config ordering (must be last)
• Plugins — duplicates, plugin-prefixed rules without declared plugins
• Overrides — missing files property, deprecated rules in overrides

Rules (20+)#

CategoryRulesExamplesConfig structure (4)Unknown keys, invalid types, no rules or extends, invalid defaultSeveritycustomConfig: true → unknown keyRules validation (5)Deprecated rules (70+), unknown rules, null values, disabled rule ratioindentation: 2 → deprecated in v16Extends (3)Duplicate entries, non-array type, prettier orderingprettier before standard → wrong orderPlugins (3)Duplicate plugins, non-array type, plugin rules without pluginsscss/no-dollar-variables without pluginOverrides (3)Non-array type, missing files, deprecated rules in overridesOverride without files propertyIgnore files (1)Catch-all patternsignoreFiles: "*" matches everything

Output formats#

• text — human-readable with severity icons (❌ ⚠️ ℹ️)
• json — structured with summary counts
• summary — one-line PASS/WARN/FAIL

Exit codes#

• 0 — no errors
• 1 — errors found (or --strict with any issue)
• 2 — file not found or parse error

Commands#

lint / validate#

Full config validation.

bash

python3 scripts/stylelint_validator.py lint .stylelintrc.json
python3 scripts/stylelint_validator.py validate --format json .stylelintrc

rules#

Check rules only (deprecated, unknown, conflicts).

bash

python3 scripts/stylelint_validator.py rules .stylelintrc.json

deprecated#

List only deprecated rules in the config.

bash

python3 scripts/stylelint_validator.py deprecated .stylelintrc.json

Options#

OptionValuesDefaultDescription--formattext, json, summarytextOutput format--min-severityerror, warning, infoinfoFilter by minimum severity--strictflagoffExit 1 on any issue

Requirements#

• Python 3.8+
• No external dependencies (pure stdlib)

Examples#

bash

# Quick check
python3 scripts/stylelint_validator.py lint .stylelintrc.json

# CI pipeline
python3 scripts/stylelint_validator.py lint --strict --format summary .stylelintrc

# Find deprecated rules to upgrade
python3 scripts/stylelint_validator.py deprecated .stylelintrc.json

# JSON output for tooling
python3 scripts/stylelint_validator.py validate --format json .stylelintrc.yaml