# stylelint-config-valantic

> Default valantic configuration for stylelint.

Latest version **10.1.0** (published 2026-03-03) · ISC license · 0 weekly downloads

## Install

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

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 10.1.0 |
| Published | 2026-03-03 |
| First published | 2019-01-08 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 18.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | valantic |
| Maintainers | fsaccilotto, limenet, claudio.schaepper, mob8607 |
| Keywords | eslint, valantic, eslint-config |

## Links

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

## Dependencies (5)

- [postcss-scss](https://npm.io/package/postcss-scss.md) ^4.0.9
- [stylelint-scss](https://npm.io/package/stylelint-scss.md) ^7.0.0
- [stylelint-order](https://npm.io/package/stylelint-order.md) ^7.0.1
- [stylelint-config-html](https://npm.io/package/stylelint-config-html.md) ^1.1.0
- [stylelint-config-standard](https://npm.io/package/stylelint-config-standard.md) ^40.0.0

## 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

- 10.1.0 (latest) — 2026-03-03
- 10.0.0 — 2026-02-10
- 9.1.0 — 2025-10-02
- 9.0.0 — 2024-01-11
- 8.0.1 — 2023-08-22
- 8.0.0 — 2023-08-22
- 7.1.5 — 2023-02-22
- 7.1.4 — 2022-09-05
- 7.1.3 — 2022-08-31
- 7.1.2 — 2022-08-31
- 7.1.1 — 2022-08-31
- 7.1.0 — 2022-08-31
- 7.0.0 — 2022-07-12
- 6.5.1 — 2021-11-23
- 6.5.0 — 2021-11-23
- … 11 more at https://npm.io/package/stylelint-config-valantic/versions

## README

# valantic stylelint configuration

To ensure a high an consistent code quality for SCSS/CSS we use stylelint.

[https://stylelint.io/](https://stylelint.io/)

## Version

Our config is currently optimized for Stylelint 13.0.0 To check for updates, see [https://github.com/stylelint/stylelint/releases](https://github.com/stylelint/stylelint/releases)

**Note that Stylelint is not backwards compatible and linting will fail if the configuration contains settings, which are not known to the current version!**

## Installing stylelint-config-valantic package

```shell
npm install stylelint-config-valantic stylelint --save-dev
```

### Create config

In the root of your project add a `.stylelintrc.js` file and add the following content to enable the valantic config for your project.

```js
module.exports = {
  "extends": "stylelint-config-valantic",
  "rules": {
    // Project related rules
  }
}

```

### Create --fix config

It is recommended to have a separate `--fix` config, that uses some additional rules (e.g. for property order) to hide non-blocking issues from the user but auto apply them on git hooks.

1. Create an additional `.stylelintrc.fix.js` file

```js
module.exports = {
  extends: [
    'stylelint-config-valantic/fix',
    './.stylelintrc.js'
  ],
};
```

**NOTE: using `--config` in the fix command will disable the auto-merging of nested stylelint configurations.** It therefore is recommended to move folder specific conigurations to the `overrides` section of the base configuration.

```js
module.exports = {
  overrides: [
    {
      files: ['src/styleguide/routes/**/*.*'],
      rules: {
        'selector-class-pattern': null,
      }
    }
  ]
};
```

2. Add a `package.json` script, if you want to test manually.

```json
{
  "stylelint": "stylelint --cache 'src/**/*.?(vue|scss)'",
  "stylelint:fix": "npm run stylelint -- --cache=false --config .stylelintrc.fix.js --fix"
}
```

3. Assign the `--fix` config for `lint-staged`.

```json
{
  "lint-staged": {
    "*.{css,vue,scss}": [
      "stylelint --config .stylelintrc.fix.js --fix"
    ]
  }
}
```

## Use

Now you're ready to enable Stylelint in your editor or use it on the command line!

### PhpStorm

Go to `PhpStorm > Preferences` and search for Stylelint or navigate to `Languages & Frameworks > Stylesheets > Stylelint` and enable it.

### Console

You can also lint your code from the console. To do this, add a script to your `package.json`.

```
"scripts": {
  "stylelint": "stylelint 'app/**/*.scss' --config .stylelintrc; exit 0"
}
```

Now you can execute the linter with the following command.

```
$ npm run stylelint
```

## Know issues

### Undefined rule

In case you get errors like "Undefined rule ..." you may have a version conflict between Stylelint and this configuration. Make sure you're using the above mentioned Stylelint version.

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