A mighty, modern linter that helps you avoid errors and enforce conventions in your styles.
It's mighty because it:
- has over 160 built-in rules to catch errors, apply limits and enforce stylistic conventions
- understands the latest CSS syntax including custom properties and level 4 selectors
- extracts embedded styles from HTML, markdown and CSS-in-JS object & template literals
- parses CSS-like syntaxes like SCSS, Sass, Less and SugarSS
- supports plugins so you can create your own rules or make use of plugins written by the community
- automatically fixes some violations (experimental feature)
- is well tested with over 10000 unit tests
- supports shareable configs that you can extend or create your own of
- is unopinionated so you can tailor the linter to your exact needs
- has a growing community and is used by Facebook, GitHub and WordPress
It's easy to get started.
First, decide how you want to use stylelint:
Then create your configuration object. You can either extend a shared configuration or craft your own.
This is the quickest way to get started. We suggest you extend either:
- recommended config if you use a pretty printer like prettier
- standard config if you want stylelint to enforce stylistic conventions
You may want to add rules to your config that limit language features as these will be specific to your team and/or project.
If you use language extensions, for example
@extends, you can use a community config like
#Craft your own config
Alternatively, you can learn about the rules and then either:
You'll find detailed information on customising stylelint in our guides:
Read our FAQ first.
If the answer to your problem isn't there, then post it on stackoverflow.
Create a new issue if:
- you think you've found a bug
- you have a feature request
If you're upgrading, read our CHANGELOG to learn what changes to expect in the latest version.
To help out, you can:
Our VISION document guides our work.
#Semantic Versioning Policy
We have a semantic versioning policy. Any minor update may report more errors than the previous release. As such, we recommend using the tilde (
"stylelint": "~7.2.0" to guarantee the results of your builds.
This project exists thanks to all these people. Contribute.
Thank you to all our backers! Become a backer.
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor.