# stylelint-config-recommended

> Recommended shareable config for Stylelint

Latest version **18.0.0** (published 2026-01-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install stylelint-config-recommended
pnpm add stylelint-config-recommended
yarn add stylelint-config-recommended
bun add stylelint-config-recommended
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 18.0.0 |
| Published | 2026-01-15 |
| First published | 2017-07-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=20.19.0 |
| Dependencies | 0 |
| Unpacked size | 6.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 399 |
| Author | Stylelint |
| Maintainers | jeddy3, ybiquitous, romainmenke, ntwb |
| Keywords | stylelint, stylelint-config, recommended |

## Links

- npm: https://www.npmjs.com/package/stylelint-config-recommended
- Repository: https://github.com/stylelint/stylelint-config-recommended
- Homepage: https://github.com/stylelint/stylelint-config-recommended#readme
- Issues: https://github.com/stylelint/stylelint-config-recommended/issues
- Funding: https://opencollective.com/stylelint
- npm.io page: https://npm.io/package/stylelint-config-recommended

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@inrupt/eslint-config-base](https://npm.io/package/@inrupt/eslint-config-base.md) — 4.5K weekly downloads

## Recent versions

- 18.0.0 (latest) — 2026-01-15
- 6.0.0-0 (next) — 2021-10-20
- 17.0.0 — 2025-07-29
- 16.0.0 — 2025-04-06
- 15.0.0 — 2025-01-12
- 14.0.1 — 2024-06-21
- 14.0.0 — 2023-12-08
- 13.0.0 — 2023-07-04
- 12.0.0 — 2023-04-16
- 11.0.0 — 2023-03-16
- 10.0.1 — 2023-02-09
- 10.0.0 — 2023-02-09
- 9.0.0 — 2022-08-11
- 8.0.0 — 2022-06-08
- 7.0.0 — 2022-02-08
- … 10 more at https://npm.io/package/stylelint-config-recommended/versions

## README

# stylelint-config-recommended

[![NPM version](https://img.shields.io/npm/v/stylelint-config-recommended.svg)](https://www.npmjs.org/package/stylelint-config-recommended) [![Build Status](https://github.com/stylelint/stylelint-config-recommended/workflows/CI/badge.svg)](https://github.com/stylelint/stylelint-config-recommended/actions)

> The recommended shareable config for Stylelint.

It turns on most of the Stylelint rules that help you [_avoid errors_](https://stylelint.io/user-guide/rules/#avoid-errors).

You can use this as a foundation for your own config, but we suggest most people use our [standard config](https://www.npmjs.com/package/stylelint-config-standard) instead which extends this config and adds a few more rules to enforce common conventions.

## Installation

```bash
npm install stylelint-config-recommended --save-dev
```

## Usage

Set your `stylelint` config to:

```json
{
  "extends": "stylelint-config-recommended"
}
```

### Extending the config

Add a `"rules"` key to your config, then add your overrides and additions there.

For example, to change the `at-rule-no-unknown` rule to use its `ignoreAtRules` option, turn off the `block-no-empty` rule, and add the `unit-allowed-list` rule:

```json
{
  "extends": "stylelint-config-recommended",
  "rules": {
    "at-rule-no-unknown": [
      true,
      {
        "ignoreAtRules": ["extends"]
      }
    ],
    "block-no-empty": null,
    "unit-allowed-list": ["em", "rem", "s"]
  }
}
```

## [Changelog](CHANGELOG.md)

## [License](LICENSE)

---
_Source: https://npm.io/package/stylelint-config-recommended · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._