https://github.com/3846masa/stylelint-browser-compat
Yet another linter rule to detect compatibility of CSS features.
https://github.com/3846masa/stylelint-browser-compat
compatibility css linter stylelint stylelint-plugin
Last synced: 5 months ago
JSON representation
Yet another linter rule to detect compatibility of CSS features.
- Host: GitHub
- URL: https://github.com/3846masa/stylelint-browser-compat
- Owner: 3846masa
- License: mit
- Created: 2022-06-04T04:42:09.000Z (almost 4 years ago)
- Default Branch: develop
- Last Pushed: 2025-04-09T14:13:48.000Z (about 1 year ago)
- Last Synced: 2025-04-09T16:20:50.776Z (about 1 year ago)
- Topics: compatibility, css, linter, stylelint, stylelint-plugin
- Language: TypeScript
- Homepage:
- Size: 3.66 MB
- Stars: 25
- Watchers: 2
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# stylelint-browser-compat
[](https://github.com/sponsors/3846masa)
[](https://www.npmjs.com/package/stylelint-browser-compat)
[](LICENSE)
[](https://github.com/RichardLitt/standard-readme)
Yet another linter rule to detect compatibility of CSS features.
This plugin checks if the CSS you're using is supported by the browsers you're targeting.
It uses [@mdn/browser-compat-data](https://github.com/mdn/browser-compat-data) to detect browser support.
**:warning: This plugin is beta. USE AT YOUR OWN RISK.**
## Table of Contents
- [Background](#background)
- [Install](#install)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## Background
`stylelint-no-unsupported-browser-features` (using `doiuse`) is available to detect compatibility of CSS features.
However, `doiuse` have not been maintained for a long time.
This library provides another alternative to detect compatibility of CSS features.
Although `doiuse` detects compatibility from `caniuse` data, this library uses `@mdn/browser-compat-data` to do so.
## Install
```bash
$ npm install --dev browserslist stylelint stylelint-browser-compat
```
```bash
$ yarn add --dev browserslist stylelint stylelint-browser-compat
```
## Usage
```js
module.exports = {
plugins: ['stylelint-browser-compat'],
rules: {
'plugin/browser-compat': [
true,
{
allow: {
features: ['at-rules.supports'],
flagged: false,
partialImplementation: false,
prefix: true,
},
browserslist: ['last 2 versions'],
},
],
},
};
```
### Options
- `browserslist` (string or array, optional)
- Accepts [browserslist queries](https://github.com/browserslist/browserslist#queries) for target browsers.
- By default, browserslist automatically loads the configuration file (e.g. `package.json`, `.browserslistrc`).
- `allow.features` (array, optional)
- Accepts an array of features to allow.
- Feature ids are from [@mdn/browser-compat-data](https://github.com/mdn/browser-compat-data).
- For example, if you want to use `@supports` at-rules, pass `at-rules.supports`.
- `allow.flagged` (boolean, optional)
- Allows features that are available when the browser's feature flags is enabled.
- `false` by default
- `allow.partialImplementation` (boolean, optional)
- Allows features that are partial implementations.
- `false` by default
- `allow.prefix` (boolean, optional)
- Allows features with vendor prefix.
- `true` by default
## Contributing
PRs accepted.
## License
[MIT (c) 3846masa](https://3846masa.mit-license.org/)