A mighty, modern linter that helps you avoid errors and enforce conventions in your styles.

It's mighty as it:

• has over 170 built-in rules for modern CSS syntax and features
• supports plugins so you can create your own rules
• automatically fixes problems where possible
• is well tested with over 15000 unit tests
• supports shareable configs that you can extend or create
• is unopinionated so that you can customize it to your exact needs
• complements pretty printers like Prettier
• has a growing community and is used by Google, GitHub and WordPress

And can be extended to:

• parse CSS-like syntaxes like SCSS, Sass, Less and SugarSS
• extract embedded styles from HTML, Markdown and CSS-in-JS object & template literals

It'll help you avoid errors, for example:

• invalid things, e.g. malformed hex colors and named grid areas
• unknown things, e.g. units and functions that aren't in the CSS specs
• valid things that are problematic, e.g. duplicated selectors and overridden properties

And enforce non-stylistic conventions, for example:

• what units, functions, at-rules etc are allowed
• consistent patterns for selector names, at-rule names, custom properties etc
• maximum specificity or maximum quantity of each selector type
• your preferred notation for color functions, font weight etc

There are also rules for enforcing stylistic conventions, but we now recommend you use Stylelint alongside a pretty printer like Prettier. Linters and pretty printers are complementary tools that work together.

• User guide
  • Getting started
  • Configuration
  • Rules
  • Usage
    • CLI
    • Node.js API
    • PostCSS plugin
    • Options
  • Integrations
    • Editor integrations
    • Task runner integrations
    • Other integrations
  • Ignoring code
  • Combining rules
  • Using regex
  • Errors & warnings
• Developer guide
  • Working on rules
  • Writing plugins
  • Writing custom syntaxes
  • Writing custom formatters
  • Writing system tests
  • Writing processors
• Migration guide
  • Migrating to 14.0.0
• Maintainer guide
  • Managing issues
  • Managing pull requests
  • Performing releases
• About
  • Vision
  • Semantic versioning

Stylelint is maintained by volunteers. Without the code contributions from all these fantastic people, Stylelint would not exist. Become a contributor.

Thank you to all our sponsors! Become a sponsor.

Thank you to all our backers! Become a backer.

The MIT License.