Linting CSS

From the blog:
isomorphic-webpack - Universal module consumption using webpack - Interview with Gajus Kuizinas

As discussed earlier in the Linting JavaScript chapter, linting is a technique that allows us to avoid certain categories of mistakes. Automation is good as it can save effort. In addition to JavaScript, it's possible to lint CSS.

stylelint is a tool that allows linting. It can be used with webpack through postcss-loader.

Setting Up Stylelint#

To get started, install the required dependencies:

npm i stylelint postcss-loader --save-dev

Next, we'll need to integrate it with our configuration. Set up a configuration part first:


exports.lintCSS = function(paths) {
  return {
    module: {
      rules: [
          test: /\.css$/,
          include: paths,

          use: 'postcss-loader',
          enforce: 'pre'

Then add it to the common configuration:



const common = merge(
parts.lintJavaScript( ); ...

This is also going to require PostCSS specific configuration to enable Stylelint:


module.exports = {
  plugins: {
    stylelint: {
      rules: {
        'color-hex-case': 'lower'
      // Ignore node_modules CSS
      ignoreFiles: 'node_modules/**/*.css'

If you define a CSS rule, such as background-color: #EFEFEF; at main.css now, you should see a warning like this at your terminal when you run the build (npm start or npm run build):

WARNING in ./~/css-loader!./~/postcss-loader!./app/main.css
stylelint: /webpack-demo/app/main.css:2:21: Expected "#EFEFEF" to be "#efefef" (color-hex-case)
 @ ./app/main.css 4:14-117
 @ ./app/index.js

See stylelint documentation for a full list of rules. npm lists possible stylelint rulesets you can enable through configuration.


stylelint-webpack-plugin is an alternative way to achieve the same result. Its greatest advantage over the setup above is that it will follow possible @import statements you might have in your styling.


After these changes, we have linting for our styling in place. Now you can catch at least the most obvious CSS related problems.

This book is available through Leanpub. By purchasing the book you support the development of further content. A part of profit (~30%) goes to Tobias Koppers, the author of Webpack.

Need help?