stylelint.config.js

module.exports = {
  extends: [
    // Use the Standard config as the base
    // https://github.com/stylelint/stylelint-config-standard
    'stylelint-config-standard',
    // Enforce a standard order for CSS properties
    // https://github.com/stormwarning/stylelint-config-recess-order
    'stylelint-config-recess-order',
    // Override rules that would interfere with Prettier
    // https://github.com/shannonmoeller/stylelint-config-prettier
    'stylelint-config-prettier',
    // Override rules to allow linting of CSS modules
    // https://github.com/pascalduez/stylelint-config-css-modules
    'stylelint-config-css-modules'
  ],
  plugins: [
    // Bring in some extra rules for SCSS
    'stylelint-scss'
  ],
  // Rule lists:
  // - https://stylelint.io/user-guide/rules/
  // - https://github.com/kristerkari/stylelint-scss#list-of-rules
  rules: {
    // Allow newlines inside class attribute values
    'string-no-newline': null,

    'selector-class-pattern': /^([a-z][\da-z]*)(-[\da-z]+)*$/,
    // 'selector-id-pattern': /^[a-z][a-zA-Z]*$/,

    // Limit the number of universal selectors in a selector,
    // to avoid very slow selectors
    'selector-max-universal': 1,
    // Disallow allow global element/type selectors in scoped modules
    // 'selector-max-type': [0, { ignore: ['child', 'descendant', 'compounded'] }],
    // ===
    // PRETTIER
    // ===
    // HACK: to compensate for https://github.com/shannonmoeller/stylelint-config-prettier/issues/4
    // Modifying setting from Standard: https://goo.gl/ZuCJMa

    // 'at-rule-empty-line-before': [
    //   'always',
    //   {
    //     except: ['blockless-after-same-name-blockless', 'first-nested'],
    //     ignore: ['after-comment'],
    //     ignoreAtRules: ['else']
    //   }
    // ],

    // ===
    // SCSS
    // ===
    'scss/dollar-variable-colon-space-after': 'always',
    'scss/dollar-variable-colon-space-before': 'never',
    'scss/dollar-variable-no-missing-interpolation': true,
    // 'scss/dollar-variable-pattern': /^[a-z-]+$/,
    'scss/double-slash-comment-whitespace-inside': 'always',
    'scss/operator-no-newline-before': true,
    'scss/operator-no-unspaced': true,
    'scss/selector-no-redundant-nesting-selector': true,
    // Allow SCSS and CSS module keywords beginning with `@`
    'at-rule-no-unknown': null,
    'scss/at-rule-no-unknown': true,
    'declaration-colon-space-after': 'always',
    'font-family-no-missing-generic-family-keyword': null,
    'block-no-empty': null

    // Other
    /*
    'no-descending-specificity': null,
    'media-feature-name-no-unknown': null,
    'selector-max-type': null,
    'scss/at-rule-no-unknown': null,
    'selector-max-type': null,
    'scss/double-slash-comment-whitespace-inside': null,
    'scss/operator-no-unspaced': null,
    'selector-pseudo-element-colon-notation': null, // this is better as 'double'

    'block-opening-brace-newline-after': null, //['always-multi-line']
    'custom-property-empty-line-before': null
    */
  }
}