Skip to main content
Frontwerk Frontwerk
  • v2.1.4
  • Github

Linting with Stylelint

Frontwerk uses Stylelint under the hood to lint your CSS/SCSS files.

Default configuration

You can run the following command and have Stylelint lint your style files.

frontwerk stylelint

The above command will format every css, scss and sass file in your root, recursively, including any files inside node_modules. It is advisable to create a .stylelintignore file in your project root and exclude node_modules at least.

By default, Frontwerk will use the following stylelint preset:

Note that any args you pass to frontwerk stylelint will be forwarded to stylelint.

Overriding the defaults

Frontwerk follows Stylelint's way of creating configuration and ignore files.

Config

There are three possible ways to extend or create your stylelint config.

  1. Create a file named .stylelintrc or stylelint.config.js in your project root.
  2. Have an stylelint property in your package.json.
  3. Pass a --config argument with your stylelint task.

You can override the default config by creating an stylelint.config.js or .stylelintrc file and either by extending the default or completing replacing it with your own.

{
  "extends": "./node_modules/frontwerk/stylelint.js"
}

or

{
  "extends": "stylelint-config-primer"
}

You can also add a property stylelint to your package.json and extend or replace the defaults there.

{
  "stylelint": {
    "extends": "./node_modules/frontwerk/stylelint.js"
  }
}

Another way to do it is by passing a --config flag to your frontwerk stylelint task with a path to a file to use as a configuration file.

{
  "scripts": {
    "lint:css": "frontwerk stylelint --config ./myconfig.js"
  }
}

Ignore

There are two possible ways to create your own stylelint ignore.

  1. Create a file named .stylelintignore in your project root.
  2. Pass a --ignore-path argument with your lint task.

Files

By default, Frontwerk will look for and lint all the CSS, SASS and SCSS files in your root, recursively, ignoring whatever is passed in the ignore.

In order to override this behavior, you can simple add the files as an argument to your lint task.

{
  "scripts": {
    "lint:css": "frontwerk stylelint ./source/**/*.css"
  }
}

Cache

By default, Frontwerk will use cache and store the info about processed files in order to only operate on the changed ones. You can of course override this behavior as well:

{
  "scripts": {
    "lint:css": "frontwerk stylelint --no-cache"
  }
}

Colors

By default, Frontwerk will use colors in its output. You can of course override this behavior as well:

{
  "scripts": {
    "lint:css": "frontwerk stylelint --no-color"
  }
}

Next up: Testing Javascript