Stylelint (.stylelintrc)

Configuration file for stylelint

Type object
File match .stylelintrc .stylelintrc.yml .stylelintrc.yaml .stylelintrc.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/stylelint-stylelintrc/latest.json
Source https://www.schemastore.org/stylelintrc.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

extends string | array
One of: string string, simpleArrayStringRule string[]
plugins string[]
uniqueItems=true
customSyntax string

Specify a custom syntax to use on your code.

overrides object[]

Provide rule and behavior overrides for files that match particular glob patterns.

processors string | object[][]

Processors are functions that hook into stylelint's pipeline, modifying code on its way into stylelint and modifying results on their way out

ignoreDisables boolean

Ignore stylelint-disable (e.g. /* stylelint-disable block-no-empty */) comments.

ignoreFiles string | array
One of: string string, simpleArrayStringRule string[]
defaultSeverity string

The default severity level for all rules that do not have a severity specified in their secondary options

Values: "warning" "error"
reportDescriptionlessDisables null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
reportInvalidScopeDisables null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
reportNeedlessDisables null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]

Definitions

allRules object
alwaysMultiLineRule null | string | array
alwaysNeverRule null | string | array
arrayStringRule null | string | array
booleanRule null | boolean | array
coreRule object
disableFix boolean
message string

Custom message that will be used in errors and warnings

reportDisables boolean
severity string

Message status

Values: "warning" "error"
url string
format=uri
integerRule null | integer | array
lowerUpperRule null | string | array
newlineRule null | string | array
newlineSpaceRule null | string | array
newlineSpaceWithIgnoreRule null | string | array
objectRule null | object | array
simpleArrayStringRule string[]
simpleStringOrArrayStringRule string | array
singleDoubleRule null | string | array
spaceRule null | string | array
stringRule null | string | array
unitRule null | string | array
atRule
at-rule-blacklist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
at-rule-empty-line-before null | string | array

Require or disallow an empty line before at-rules

One of: null null, string string, string | object[] string | object[]
at-rule-name-case null | string | array
One of: null null, string string, string | object[] string | object[]
at-rule-name-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
at-rule-name-space-after null | string | array

Require a single space after at-rule names

One of: null null, string string, string | object[] string | object[]
at-rule-no-unknown null | boolean | array

Disallow unknown at-rules

One of: null null, boolean boolean, boolean | object[] boolean | object[]
at-rule-no-vendor-prefix null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
at-rule-semicolon-newline-after null | string | array

Require a newline after the semicolon of at-rules

One of: null null, string string, string | object[] string | object[]
at-rule-semicolon-space-before

Require a single space or disallow whitespace before the semicolons of at-rules

at-rule-whitelist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
block
block-closing-brace-empty-line-before null | string | array

Require or disallow an empty line before the closing brace of blocks

One of: null null, string string, string | object[] string | object[]
block-closing-brace-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
block-closing-brace-newline-before null | string | array
One of: null null, string string, string | object[] string | object[]
block-closing-brace-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
block-closing-brace-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
block-no-empty null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
block-no-single-line null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
block-opening-brace-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
block-opening-brace-newline-before null | string | array

Require a newline or disallow whitespace before the opening brace of blocks

One of: null null, string string, string | object[] string | object[]
block-opening-brace-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
block-opening-brace-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
color
color-hex-case null | string | array
One of: null null, string string, string | object[] string | object[]
color-hex-length null | string | array

Specify short or long notation for hex colors

One of: null null, string string, string | object[] string | object[]
color-named null | string | array

Require (where possible) or disallow named colors

One of: null null, string string, string | object[] string | object[]
color-no-hex null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
color-no-invalid-hex null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
comment
comment-empty-line-before null | string | array

Require or disallow an empty line before comments

One of: null null, string string, string | object[] string | object[]
comment-no-empty null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
comment-whitespace-inside null | string | array
One of: null null, string string, string | object[] string | object[]
comment-word-blacklist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
customMedia
custom-media-pattern null | string | array
One of: null | string null | string, string | object[] string | object[]
no-unknown-custom-media const: true | null | array

Disallow unknown custom media queries

customProperty
custom-property-empty-line-before null | string | array

Require or disallow an empty line before custom properties

One of: null null, string string, string | object[] string | object[]
custom-property-no-outside-root null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
custom-property-pattern null | string | array
One of: null | string null | string, string | object[] string | object[]
no-unknown-custom-properties const: true | null | array

Disallow unknown custom properties

declaration
declaration-bang-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-bang-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-colon-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-colon-space-after null | string | array

Require a single space or disallow whitespace after the colon of declarations

One of: null null, string string, string | object[] string | object[]
declaration-colon-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-empty-line-before null | string | array

Require or disallow an empty line before declarations

One of: null null, string string, string | object[] string | object[]
declaration-no-important null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
declaration-property-unit-blacklist null | object | array
declaration-property-unit-whitelist null | object | array
declaration-property-value-blacklist null | object | array
declaration-property-value-no-unknown const: true | null | array

Disallow unknown values for properties within declarations

declaration-property-value-whitelist null | object | array
declarationBlock
declaration-block-no-duplicate-properties null | boolean | array

Disallow duplicate properties within declaration blocks

One of: null null, boolean boolean, boolean | object[] boolean | object[]
declaration-block-no-ignored-properties null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
declaration-block-no-redundant-longhand-properties null | boolean | array

Disallow longhand properties that can be combined into one shorthand property

One of: null null, boolean boolean, boolean | object[] boolean | object[]
declaration-block-no-shorthand-property-overrides null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
declaration-block-properties-order null | string | array

Specify the order of properties within declaration blocks

One of: null null, string string, string | array | object[] string | array | object[]
declaration-block-semicolon-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-block-semicolon-newline-before null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-block-semicolon-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-block-semicolon-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
declaration-block-single-line-max-declarations null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]
declaration-block-trailing-semicolon null | string | array
One of: null null, string string, string | object[] string | object[]
font
font-family-name-quotes null | string | array

Specify whether or not quotation marks should be used around font family names

One of: null null, string string, string | object[] string | object[]
font-weight-notation null | string | array

Require numeric or named (where possible) font-weight values. Also, when named values are expected, require only valid names

One of: null null, string string, string | object[] string | object[]
function
function-blacklist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
function-calc-no-unspaced-operator null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
function-comma-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
function-comma-newline-before null | string | array
One of: null null, string string, string | object[] string | object[]
function-comma-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
function-comma-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
function-linear-gradient-no-nonstandard-direction null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
function-max-empty-lines null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]
function-name-case null | string | array

Specify lowercase or uppercase for function names

One of: null null, string string, string | object[] string | object[]
function-parentheses-newline-inside null | string | array
One of: null null, string string, string | object[] string | object[]
function-parentheses-space-inside null | string | array
One of: null null, string string, string | object[] string | object[]
function-url-data-uris null | string | array
One of: null null, string string, string | object[] string | object[]
function-url-no-scheme-relative null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
function-url-quotes null | string | array
One of: null null, string string, string | object[] string | object[]
function-url-scheme-whitelist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
function-whitelist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
function-whitespace-after null | string | array
One of: null null, string string, string | object[] string | object[]
generalSheet
indentation null | integer | string | array

Specify indentation

One of: null | integer null | integer, string string, integer[] integer[], integer | string | object[] integer | string | object[]
linebreaks

Specify unix or windows linebreaks

max-empty-lines null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]
max-line-length null | integer | array

Limit the length of a line

One of: null | integer null | integer, integer | object[] integer | object[]
max-nesting-depth null | integer | array

Limit the allowed nesting depth

One of: null | integer null | integer, integer | object[] integer | object[]
no-browser-hacks null | boolean | array

Disallow browser hacks that are irrelevant to the browsers you are targeting

One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-descending-specificity null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-duplicate-selectors null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-empty-first-line

Disallow empty first lines

no-empty-source null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-eol-whitespace null | boolean | array

Disallow end-of-line whitespace

One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-extra-semicolons null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-indistinguishable-colors null | boolean | array

Disallow colors that are suspiciously close to being identical

One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-invalid-double-slash-comments null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-missing-end-of-source-newline null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
no-unknown-animations null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
unicode-bom null | string | array
One of: null null, string string, string | object[] string | object[]
no-unsupported-browser-features null | boolean | array

Disallow features that are unsupported by the browsers that you are targeting

One of: null null, boolean boolean, boolean | object[] boolean | object[]
keyframeDeclaration
keyframe-declaration-no-important null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
length
length-zero-no-unit null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
lightness
lightness-notation string | null | array

Specify number or percentage notation for lightness

mediaFeature
media-feature-colon-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
media-feature-colon-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
media-feature-name-case null | string | array
One of: null null, string string, string | object[] string | object[]
media-feature-name-no-unknown null | boolean | array

Disallow unknown media feature names

One of: null null, boolean boolean, boolean | object[] boolean | object[]
media-feature-name-value-no-unknown const: true | null | array

Disallow unknown values for media features

media-feature-name-no-vendor-prefix null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
media-feature-name-unit-allowed-list object | null | array

Specify a list of allowed name and unit pairs within media features

media-feature-no-missing-punctuation null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
media-feature-parentheses-space-inside null | string | array
One of: null null, string string, string | object[] string | object[]
media-feature-range-notation string | null | array

Specify context or prefix notation for media feature ranges

media-feature-range-operator-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
media-feature-range-operator-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
mediaQuery
media-query-no-invalid const: true | null | array

Disallow invalid media queries

mediaQueryList
media-query-list-comma-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
media-query-list-comma-newline-before null | string | array
One of: null null, string string, string | object[] string | object[]
media-query-list-comma-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
media-query-list-comma-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
number
number-leading-zero null | string | array
One of: null null, string string, string | object[] string | object[]
number-max-precision null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]
number-no-trailing-zeros null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
property
property-blacklist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
property-case null | string | array
One of: null null, string string, string | object[] string | object[]
property-no-unknown null | boolean | array

Disallow unknown properties

One of: null null, boolean boolean, boolean | object[] boolean | object[]
property-no-vendor-prefix null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
property-whitelist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
rootRule
root-no-standard-properties null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
rule
rule-nested-empty-line-before null | string | array

Require or disallow an empty line before nested rules

One of: null null, string string, string | object[] string | object[]
rule-non-nested-empty-line-before null | string | array

Require or disallow an empty line before non-nested rules

One of: null null, string string, string | object[] string | object[]
selector
selector-anb-no-unmatchable const: true | null | array

Disallow unmatchable An+B selectors

selector-attribute-brackets-space-inside null | string | array
One of: null null, string string, string | object[] string | object[]
selector-attribute-operator-blacklist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
selector-attribute-operator-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
selector-attribute-operator-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
selector-attribute-operator-whitelist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
selector-attribute-quotes null | string | array
One of: null null, string string, string | object[] string | object[]
selector-class-pattern null | string | array

Specify a pattern for class selectors

One of: null | string null | string, string | object[] string | object[]
selector-combinator-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
selector-combinator-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
selector-descendant-combinator-no-non-space null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-id-pattern null | string | array
One of: null | string null | string, string | object[] string | object[]
selector-max-compound-selectors null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]
selector-max-specificity null | string | array
One of: null | string null | string, string | object[] string | object[]
selector-nested-pattern null | string | array
One of: null | string null | string, string | object[] string | object[]
selector-no-attribute null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-no-combinator null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-no-id null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-no-qualifying-type null | boolean | array

Disallow qualifying a selector by type

One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-no-type null | boolean | array

Disallow type selectors

One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-no-universal null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-no-vendor-prefix null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-pseudo-class-case null | string | array
One of: null null, string string, string | object[] string | object[]
selector-pseudo-class-no-unknown null | boolean | array

Disallow unknown pseudo-class selectors

One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-pseudo-class-parentheses-space-inside null | string | array
One of: null null, string string, string | object[] string | object[]
selector-pseudo-class-whitelist null | string | array
One of: null | string null | string, string | array | object[] string | array | object[]
selector-pseudo-element-case null | string | array
One of: null null, string string, string | object[] string | object[]
selector-pseudo-element-colon-notation null | string | array
One of: null null, string string, string | object[] string | object[]
selector-pseudo-element-no-unknown null | boolean | array

Disallow unknown pseudo-element selectors

One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-root-no-composition null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-type-case null | string | array
One of: null null, string string, string | object[] string | object[]
selector-type-no-unknown null | boolean | array

Disallow unknown type selectors

One of: null null, boolean boolean, boolean | object[] boolean | object[]
selector-max-empty-lines null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]
selectorList
selector-list-comma-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
selector-list-comma-newline-before null | string | array
One of: null null, string string, string | object[] string | object[]
selector-list-comma-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
selector-list-comma-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
shorthandProperty
shorthand-property-no-redundant-values null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
string
string-no-newline null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
string-quotes null | string | array
One of: null null, string string, string | object[] string | object[]
stylelintDisableComment
stylelint-disable-reason null | string | array

Require a reason comment before or after stylelint-disable comments

One of: null null, string string, string | object[] string | object[]
time
time-no-imperceptible null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
unit
unit-blacklist null | string | array
One of: null null, string string, string | array | object[] string | array | object[]
unit-case null | string | array
One of: null null, string string, string | object[] string | object[]
unit-no-unknown null | boolean | array

Disallow unknown units

One of: null null, boolean boolean, boolean | object[] boolean | object[]
unit-whitelist null | string | array
One of: null null, string string, string | array | object[] string | array | object[]
value
value-keyword-case null | string | array

Specify lowercase or uppercase for keywords values

One of: null null, string string, string | object[] string | object[]
value-no-vendor-prefix null | boolean | array
Default: true
One of: null null, boolean boolean, boolean | object[] boolean | object[]
valueList
value-list-comma-newline-after null | string | array
One of: null null, string string, string | object[] string | object[]
value-list-comma-newline-before null | string | array
One of: null null, string string, string | object[] string | object[]
value-list-comma-space-after null | string | array
One of: null null, string string, string | object[] string | object[]
value-list-comma-space-before null | string | array
One of: null null, string string, string | object[] string | object[]
value-list-max-empty-lines null | integer | array
One of: null | integer null | integer, integer | object[] integer | object[]