ESLint x React

A set of ESLint rules to catch common mistakes and improve your React code.

Supported engines

Node.js

• 18.x LTS Hydrogen
• 20.x Current

Bun

• 1.0.15 or later

Installation

Installation Guide ↗

Presets

Presets List ↗

Rules

Rule List ↗

Philosophy

• Do what a linter should do
• Focus on code rather than style
• Rules are better than options

Rule introduction or modification principles

1. No Auto-fix. Auto-fix is a great feature, but it's not always safe and reliable. We prefer to not to do auto-fix at all than to implement it in a way that can cause more problems than it solves.
2. Formatting independent. Rules should check for correctness, not style. We recommend using style focused tools for formatting (e.g. dprint).
3. Rules over options [1]. Each rule should have a single purpose. Make multiple rules work together to achieve more complex behaviors instead of adding options to a single rule.
4. Sensible defaults. Rules should be easy to setup and use with minimal configuration and sensible defaults.

Contributing

Before you start working on something, it's best to check if there is an existing issue first. It's also a good idea to reach the maintainer and confirm if it makes sense or if someone else is already working on it.

Please make sure to read the Contributing Guide before making a pull request.

Pull requests submitted without prior discussion can also be rejected without prior discussion.

Thank you to everyone contributing to ESLint x React!

License

This project is licensed under the MIT License - see the LICENSE file for details.

Inspiration

• eslint-plugin-perfectionist
• eslint-plugin-solid
• eslint-plugin-functional
• eslint-plugin-filenames-simple
• @tanstack/eslint-plugin-query
• rome/tools
• rust-clippy

Prior art

• eslint-plugin-react
• eslint-plugin-react-hooks