These are my personal ESLint configs. There are many like them, but these ones are mine.

You're welcome to extend my configs and use them for your own projects, but be warned: my preferences change from time to time, and these configs will change with them.

Please don't ask me to change these configs to suit your preferences. Just override them in your own configs, or don't use them.

npm i --save-dev @rgrove/eslint-config

pnpm add --save-dev --config.auto-install-peers=true @rgrove/eslint-config

To use the primary config, add an extends property to your .eslintrc.js (or wherever you've chosen to configure ESLint), like this:

module.exports = {
  extends: '@rgrove/eslint-config'
};

You can extend multiple configs using an array:

module.exports = {
  extends: [
    '@rgrove/eslint-config',
    '@rgrove/eslint-config/browser',
    '@rgrove/eslint-config/modules',
    '@rgrove/eslint-config/react'
  ]
};

When extending multiple configs, always extend @rgrove/eslint-config first, since it defines baseline rules that other configs may override.

See the documentation for ESLint's extends property for more details.

This is the base config. It defines parser options and rules that are relevant in all modern JS environments, and doesn't assume the use of any particular module system.

When extending multiple configs, this one should always be first.

Defines parser options and rules specific to modern browser JS.

Defines parser options and rules specific to CommonJS modules.

Defines parser options and rules specific to ES modules.

Defines parser options and rules specific to modern Node.js.

Defines parser options and rules specific to React.

Defines parser options and rules specific to TypeScript.

These configs use ESLint's default parser. If you're using (for example) Babel to transpile language features that aren't yet part of the ECMAScript standard, ESLint may not be able to parse them, and you may see parsing errors when you run ESLint.

To fix this, you may need to specify an alternative parser such as babel-eslint in your ESLint config:

module.exports = {
  parser: 'babel-eslint',

  extends: [
    '@rgrove/eslint-config',
    '@rgrove/eslint-config/browser',
    '@rgrove/eslint-config/modules',
    '@rgrove/eslint-config/react'
  ]
};

You'll need to install and properly configure babel-eslint (or whatever alternative parser you use) as a dependency of your own project.