Stylelint

Stylelint is a popular linter for CSS.

Run Locally

The mozlint integration of Stylelint can be run using mach:

$ mach lint --linter stylelint <file paths>

Alternatively, omit the --linter stylelint and run all configured linters, which will include Stylelint.

Stylelint also supports the --fix option to autofix most errors raised from most of the rules.

See the Usage guide for more options.

Understanding Rules and Errors

  • Only some files are linted, see the configuration for details.

    • By design we do not lint/format reftests not crashtests as these are specially crafted tests.

  • If you don’t understand a rule, you can look it in stylelint.io’s rule list for more information about it.

Common Issues and How To Solve Them

This code should neither be linted nor formatted

Configuration

The global configuration file lives in topsrcdir/.stylelintrc.js. For an overview of the supported configuration, see Stylelint’s documentation.

Please keep differences in rules across the tree to a minimum. We want to be consistent to make it easier for developers.

Sources

Builders

Gijs Kruitbosch (gijs) owns the builders. Questions can also be asked on #lint:mozilla.org on Matrix.

Stylelint task

This is a tier-1 task. For test failures the patch causing the issue should be backed out or the issue fixed.

Some failures can be fixed with ./mach lint -l stylelint --fix path/to/file.

For test harness issues, file bugs in Developer Infrastructure :: Lint and Formatting.