@roots/browserslist-config/README.md

Browserslist configuration

<p align="center"><img src="https://cdn.roots.io/app/uploads/logo-bud.svg" height="100" alt="bud.js" /></p>

<p align="center">
  <img alt="MIT License" src="https://img.shields.io/github/license/roots/bud?color=%23525ddc&style=flat-square" />
  <img alt="npm" src="https://img.shields.io/npm/v/@roots/bud.svg?color=%23525ddc&style=flat-square" />
  <img alt="Follow Roots" src="https://img.shields.io/twitter/follow/rootswp.svg?color=%23525ddc&style=flat-square" />
</p>

<h1 align="center"><strong>@roots/browserslist-config</strong></h1>

<p align="center">
  Browserslist configuration
</p>

---

## Installation

Install **@roots/browserslist-config** to your project.

Yarn:

```sh
yarn add @roots/browserslist-config --dev
```

npm:

```sh
npm install @roots/browserslist-config --save-dev
```

## Exported configurations

All browserslist configurations are deterministic. This means that the configurations are not constructed using unchanging targets, as opposed to queries based on market share (`> 2%`, `not dead`) or versions (`last 2 versions`, `last 3 versions`).

| Signifier                                    | Description                                       | Coverage |
| -------------------------------------------- | ------------------------------------------------- | -------- |
| `@roots/browserslist-config`                 | Recommended browserslist config                   | 89%      |
| `@roots/browserslist-config/last-2-versions` | Last 2 major versions                             | 79%      |
| `@roots/browserslist-config/last-3-versions` | Last 3 major versions                             | 90%      |
| `@roots/browserslist-config/wordpress`       | Very similar to WordPress maintained browserslist | 81%      |

## Deprecated configs

These configs will be removed in the next major release.

| Signifier                            | Description                                      |
| ------------------------------------ | ------------------------------------------------ |
| `@roots/browserslist-config/broad`   | Use `@roots/browserslist-config/last-3-versions` |
| `@roots/browserslist-config/current` | Use `@roots/browserslist-config/last-2-versions` |
| `@roots/browserslist-config/default` | Use `@roots/browserslist-config`                 |
| `@roots/browserslist-config/next`    | Use `@roots/browserslist-config`                 |

## Contributing

Contributions are welcome from everyone.

We have [contribution guidelines](https://github.com/roots/guidelines/blob/master/CONTRIBUTING.md) to help you get started.

## License

@roots/browserslist-config is licensed under MIT.

## Community

Keep track of development and community news.

- Join us on Roots Slack by becoming a [GitHub
  sponsor](https://github.com/sponsors/roots)
- Participate on the [Roots Discourse](https://discourse.roots.io/)
- Follow [@rootswp on Twitter](https://twitter.com/rootswp)
- Read and subscribe to the [Roots Blog](https://roots.io/blog/)
- Subscribe to the [Roots Newsletter](https://roots.io/subscribe/)

## Sponsors

**bud.js** is an open source project and completely free to use.

However, the amount of effort needed to maintain and develop new features and projects within the Roots ecosystem is not sustainable without proper financial backing. If you have the capability, please consider [sponsoring Roots](https://github.com/sponsors/roots).

<a href="https://carrot.com/">
<img src="https://cdn.roots.io/app/uploads/carrot.svg" alt="Carrot" width="200" height="150"/>
</a>
<a href="https://wordpress.com/">
<img src="https://cdn.roots.io/app/uploads/wordpress.svg" alt="WordPress.com" width="200" height="150"/>
</a>
<a href="https://worksitesafety.ca/careers/">
<img src="https://cdn.roots.io/app/uploads/worksite-safety.svg" alt="Worksite Safety" width="200" height="150"/>
</a>
<a href="https://www.itineris.co.uk/">
<img src="https://cdn.roots.io/app/uploads/itineris.svg" alt="Itineris" width="200" height="150"/>
</a>