# Custom configuration

If you are in the process of migrating an existing project to use @workleap/stylelint-configs or encountering a challenging situation that is not currently handled by this library, you might want to customize the default shared configurations.

For a list of the rules included with the default shared configurations, refer to the following file on GitHub.

# Disable a default rule

You can disable a default rule by defining the rule locally with the null value:

.stylelintrc.json
{
    "$schema": "https://json.schemastore.org/stylelintrc",
    "extends": "@workleap/stylelint-configs",
    "rules": {
        "color-hex-length": null
    }
}

# Change a default rule severity

You can update the severity of a rule by defining the rule locally with either the "warn" or "error" severity:

.stylelintrc.json
{
    "$schema": "https://json.schemastore.org/stylelintrc",
    "extends": "@workleap/stylelint-configs",
    "rules": {
        "max-nesting-depth": [2, { "severity": "error" }]
    }
}

# Change a default rule value

You can update a default rule value by defining the rule locally with its new value:

.stylelintrc.json
{
    "$schema": "https://json.schemastore.org/stylelintrc",
    "extends": "@workleap/stylelint-configs",
    "rules": {
        "unit-allowed-list": [
            "rem"
        ]
    }
}

# Add a plugin

You can configure additional rules from a third party Stylelint plugin:

.stylelintrc.json
{
    "$schema": "https://json.schemastore.org/stylelintrc",
    "plugins": ["stylelint-order"],
    "extends": "@workleap/stylelint-configs",
    "rules": {
		"order/properties-order": [
			"width",
			"height"
		]
    }
}