.stylelintrc.js

module.exports = {
  extends: ['stylelint-config-standard', 'stylelint-config-prettier'],
  plugins: ['stylelint-order'],
  // plugins: ['stylelint-order'],
  defaultSeverity: process.env.NODE_ENV === 'production' ? 'error' : 'warning',
  rules: {
    // Disabled as it's returning many false positives.
    // See https://github.com/stylelint/stylelint/issues/2489
    // TODO: Enable once fixed
    'no-descending-specificity': null,
    // Enable :global and :local selectors for css modules
    'selector-pseudo-class-no-unknown': [
      true,
      {
        ignorePseudoClasses: ['global', 'local'],
      },
    ],
    // Disable @rules for scss
    'at-rule-no-unknown': [
      true,
      {
        ignoreAtRules: [
          'at-root',
          'extend',
          'mixin',
          'for',
          'include',
          'content',
          'each',
          'function',
          'return',
          'if',
          'else',
        ],
      },
    ],
    // Enable composes keyword for css modules
    'property-no-unknown': [
      true,
      {
        ignoreProperties: ['composes'],
      },
    ],
    // https://github.com/hudochenkov/stylelint-order/blob/master/rules/order/README.md#options
    'order/order': ['custom-properties', 'dollar-variables', 'declarations', 'rules', 'at-rules'],
    // https://github.com/hudochenkov/stylelint-order/blob/master/rules/properties-order/README.md
    // tldr; Rules follow a logical, semantic ordering to prevent
    // readers from resetting their context of styles being applied
    'order/properties-order': [
      [
        // CSS Modules
        'composes',

        // Inheritance
        'all',

        // Heading
        'content',
        'quotes',

        // Positioning
        'position',
        'top',
        'right',
        'bottom',
        'left',
        'z-index',

        // Box Model & Display
        'box-sizing',
        'display',
        'float',
        'clear',

        // Shapes
        'shape-outside',
        'shape-image-threshold',
        'shape-margin',

        // Visual effects
        'visibility',
        'opacity',
        'overflow',
        'overflow-x',
        'overflow-y',
        'overflow-scrolling',
        'overflow-wrap',
        'scroll-behavior',
        'scroll-snap-type',
        'clip',
        'clip-path',
        'mask',

        // Flexible Box Layout
        'flex',
        'flex-grow',
        'flex-shrink',
        'flex-basis',
        'flex-flow',
        'flex-direction',
        'flex-wrap',
        'justify-content',
        'align-items',
        'align-content',
        'align-self',
        'order',

        // Tables
        'caption-side',
        'table-layout',
        'border-collapse',
        'border-spacing',
        'empty-cells',

        // List style
        'list-style',
        'list-style-type',
        'list-style-position',
        'list-style-image',

        // Multi-column Layout
        'columns',
        'column-width',
        'column-count',
        'column-gap',
        'column-fill',
        'column-span',
        'column-rule',
        'column-rule-width',
        'column-rule-style',
        'column-rule-color',

        // Grid
        'grid',
        'grid-area',
        'grid-template',
        'grid-template-rows',
        'grid-template-columns',
        'grid-template-areas',
        'grid-auto-rows',
        'grid-auto-columns',
        'grid-auto-flow',
        'grid-gap',
        'grid-row',
        'grid-row-gap',
        'grid-row-start',
        'grid-row-end',
        'grid-column',
        'grid-column-start',
        'grid-column-gap',
        'grid-column-end',

        // Width
        'width',
        'min-width',
        'max-width',

        // Height
        'height',
        'min-height',
        'max-height',

        // Zoom
        'zoom',
        'min-zoom',
        'max-zoom',
        'user-zoom',
        'orientation',

        // Sizing Images and Objects
        'object-fit',
        'object-position',

        // Padding
        'padding',
        'padding-top',
        'padding-right',
        'padding-bottom',
        'padding-left',

        // Margin
        'margin',
        'margin-top',
        'margin-right',
        'margin-bottom',
        'margin-left',

        // Border
        'border',
        'border-top',
        'border-right',
        'border-bottom',
        'border-left',
        'border-width',
        'border-top-width',
        'border-right-width',
        'border-bottom-width',
        'border-left-width',
        'border-style',
        'border-top-style',
        'border-right-style',
        'border-bottom-style',
        'border-left-style',
        'border-color',
        'border-top-color',
        'border-right-color',
        'border-bottom-color',
        'border-left-color',
        'border-image',
        'border-image-source',
        'border-image-slice',
        'border-image-width',
        'border-image-outset',
        'border-image-repeat',
        'border-radius',
        'border-top-left-radius',
        'border-top-right-radius',
        'border-bottom-left-radius',
        'border-bottom-right-radius',

        // Outline
        'outline',
        'outline-width',
        'outline-style',
        'outline-color',
        'outline-offset',

        // Font
        'font',
        'font-style',
        'font-variant',
        'font-weight',
        'font-stretch',
        'font-size',
        'font-size-adjust',
        'font-family',
        'font-emphasize',
        'font-emphasize-position',
        'font-emphasize-style',
        'font-kerning',
        'font-language-override',
        'font-smoothing',
        'font-synthesis',
        'font-variant',
        'font-variant-alternates',
        'font-variant-caps',
        'font-variant-east-asian',
        'font-variant-ligatures',
        'font-variant-numeric',
        'font-variant-position',
        'src',
        'line-height',

        // Text alignment & decoration
        'writing-mode',
        'direction',
        'unicode-bidi',
        'unicode-range',
        'text-align',
        'text-align-last',
        'text-combine-upright',
        'text-decoration',
        'text-decoration-color',
        'text-decoration-line',
        'text-decoration-style',
        'text-emphasis',
        'text-emphasis-color',
        'text-emphasis-position',
        'text-emphasis-style',
        'text-indent',
        'text-justify',
        'text-orientation',
        'text-overflow',
        'text-rendering',
        'text-shadow',
        'text-size-adjust',
        'text-stroke',
        'text-stroke-color',
        'text-stroke-width',
        'text-transform',
        'text-underline-position',
        'vertical-align',

        // Text spacing
        'white-space',
        'letter-spacing',
        'word-spacing',
        'word-wrap',
        'word-break',
        'line-break',
        'tab-size',
        'hyphens',

        // Colors, Backgrounds & Shadows
        'color',
        'background',
        'background-image',
        'background-position',
        'background-size',
        'background-repeat',
        'background-attachment',
        'background-origin',
        'background-clip',
        'background-color',
        'background-blend-mode',
        'box-shadow',

        // Image Processing
        'image-orientation',
        'image-rendering',
        'image-resolution',

        // Filter Effects
        'filter',

        // UI
        'appearance',
        'counter-increment',
        'counter-reset',
        'cursor',
        'pointer-events',
        'resize',
        'touch-action',
        'touch-callout',
        'user-select',

        // Animation
        'will-change',
        'backface-visibility',
        'perspective',
        'perspective-origin',
        'transform',
        'transform-origin',
        'transform-style',
        'transition',
        'transition-property',
        'transition-duration',
        'transition-timing-function',
        'transition-delay',
        'animation',
        'animation-name',
        'animation-duration',
        'animation-timing-function',
        'animation-delay',
        'animation-iteration-count',
        'animation-direction',
        'animation-fill-mode',
        'animation-play-state',

        // Page breaks
        'page-break-after',
        'page-break-before',
        'page-break-inside',
        'break-inside',
        'widows',
        'orphans',

        // Counter Styles
        'system',
        'symbols',
        'additive-symbols',
        'negative',
        'prefix',
        'suffix',
        'range',
        'pad',
        'speak-as',
        'fallback',
      ],
      { unspecified: 'bottomAlphabetical' },
    ],
  },
};