stylelint-config-wolox

1.1.0 verified Fri May 01 auth: no javascript maintenance

Shareable stylelint configuration used at Wolox, a software consultancy. Version 1.1.0 (released March 2021, no further updates). Provides a preset set of rules based on stylelint v13, including SCSS support via stylelint-scss. Less active than alternatives like stylelint-config-standard; primarily useful for projects following Wolox internal conventions.

Common errors

error Configuration for rule "scss/at-extend-no-missing-placeholder" is invalid ↓

cause Missing peer dependency stylelint-scss.

fix

npm install stylelint-scss@^3.18.0 --save-dev

error Cannot find module 'stylelint-config-wolox' ↓

cause Package not installed or incorrect extends path.

fix

npm install stylelint-config-wolox@1.1.0 --save-dev

error Unknown rule: scss/dollar-variable-pattern ↓

cause Using stylelint v14 which removed deprecated rules.

fix

Downgrade to stylelint@13 or use stylelint-config-standard-scss.

Warnings

gotcha Requires stylelint v13.x and stylelint-scss v3.18.x. Not compatible with v14+ due to rule removals. ↓

fix Pin stylelint to ^13.7.0 and stylelint-scss to ^3.18.0.

gotcha Includes SCSS-specific rules; will cause errors on plain CSS without stylelint-scss installed. ↓

fix Install peer dependency stylelint-scss.

gotcha Not compatible with stylelint v14's new rules (e.g., color-function-notation). ↓

fix Use stylelint-config-standard or other modern configs for stylelint v14+.

Install

npm install stylelint-config-wolox

yarn add stylelint-config-wolox

pnpm add stylelint-config-wolox

Imports

default

wrong

require('stylelint-config-wolox') as plugin

correct

module.exports = { extends: 'stylelint-config-wolox' }

Use as an extends in .stylelintrc, not as a plugin.

default

wrong

const stylelintConfigWolox = require('stylelint-config-wolox');

correct

import stylelintConfigWolox from 'stylelint-config-wolox';

CommonJS require works, but ESM import is usable if your project supports it.

rules

wrong

const rules = require('stylelint-config-wolox/rules');

correct

import { rules } from 'stylelint-config-wolox';

Rules are exported as a named export; no separate path.

Quickstart

Extends the base config in .stylelintrc.json to apply Wolox's SCSS-aware linting rules.

// .stylelintrc.json
{
  "extends": ["stylelint-config-wolox"]
}