A webpack plugin to lint your CSS/Sass code using stylelint
Clone or download
brneto and shellscape chore: update peerDependency stylelint to ^9.0.0 (#160)
* fix(stylelint): stylelint 9 support

* fix(stylelint): remove lockfile

* fix(stylelint): Recover yarn.lock from commit b244ff
Latest commit 5ae9467 Jun 11, 2018
Permalink
Failed to load latest commit information.
.circleci ci(circle): add circleci, remove travis Mar 31, 2018
.github refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
lib refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
test chore: update peerDependency stylelint to ^9.0.0 (#160) Jun 11, 2018
.babelrc refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
.editorconfig refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
.eslintignore refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
.eslintrc.js refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
.gitattributes refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
.gitignore refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
.prettierrc refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
CHANGELOG.md refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
LICENSE Transfering ownership to webpack-contrib Mar 31, 2018
README.md refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
appveyor.yml refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
codecov.yml refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
commitlint.config.js refactor(defaults): update to latest webpack-defaults (#147) Apr 30, 2018
index.js fix: fixes #153, webpack peerDep regression (#154) May 10, 2018
package-lock.json chore(release): 0.10.5 May 10, 2018
package.json chore: update peerDependency stylelint to ^9.0.0 (#160) Jun 11, 2018
yarn.lock chore: update yarn.lock Mar 31, 2018

README.md

npm node deps tests chat

stylelint-webpack-plugin

A Stylelint plugin for webpack

Requirements

This module requires a minimum of Node v6.9.0 and webpack v4.0.0.

Differences With stylelint-loader

Both stylelint-loader and this module have their uses. stylelint-loader lints the files you require (or the ones you define as an entry in your webpack config). However, @imports in files are not followed, meaning only the main file for each require/entry is linted.

stylelint-webpack-plugin allows defining a glob pattern matching the configuration and use of stylelint.

Getting Started

To begin, you'll need to install stylelint-webpack-plugin:

$ npm install stylelint-webpack-plugin --save-dev

Then add the plugin to your webpack config. For example:

file.ext

import file from 'file.ext';
// webpack.config.js
const StyleLintPlugin = require('stylelint-webpack-plugin');

module.exports = {
  // ...
  plugins: [
    new StyleLintPlugin(options),
  ],
  // ...
}

And run webpack via your preferred method.

Options

See stylelint's options for the complete list of options available. These options are passed through to the stylelint directly.

configFile

Type: String Default: undefined

Specify the config file location to be used by stylelint.

Note: By default this is handled by stylelint via cosmiconfig.

context

Type: String Default: compiler.context

A String indicating the root of your SCSS files.

emitErrors

Type: Boolean Default: true

If true, pipes stylelint error severity messages to the webpack compiler's error message handler.

Note: When this property is disabled all stylelint messages are piped to the webpack compiler's warning message handler.

failOnError

Type: Boolean Default: false

If true, throws a fatal error in the global build process. This will end the build process on any stylelint error.

files

Type: String|Array[String] Default: '**/*.s?(a|c)ss'

Specify the glob pattern for finding files. Must be relative to options.context.

formatter

Type: Object Default: require('stylelint').formatters.string

Specify a custom formatter to format errors printed to the console.

lintDirtyModulesOnly

Type: Boolean Default: false

Lint only changed files, skip lint on start.

syntax

Type: String Default: undefined

See the styelint user guide for more info. e.g. use 'scss' to lint .scss files.

Error Reporting

By default the plugin will dump full reporting of errors. Set failOnError to true if you want webpack build process breaking with any stylelint error. You can use the quiet option to avoid error output to the console.

Acknowledgement

This project was inspired by, and is a heavily modified version of sasslint-webpack-plugin.

Thanks to Javier (@vieron) for authoring this plugin.

License

MIT