eslint-config-benjamin

Quick start

1. Install the following dev-dependencies:

   yarn add -D \
     @benjaminsimode/eslint-config-benjamin \
     eslint \
     eslint-plugin-node

2. Extend the @benjaminsimode/eslint-config-benjamin config in your .eslintrc (or eslintConfig key in your package.json):

   "eslintConfig": {
     "extends": "@benjaminsimode/eslint-config-benjamin"
   }

3. Specify the version of Node.js your project uses by setting .engines.node in your package.json.

   "engines": {
     "node": ">=8"
   }

4. Run eslint on your project as part of your lint:js scripts:

   "scripts": {
     "lint:js": "yarn run eslint --cache --ext .js --ignore-path .gitignore ./resources/",
   }

Usage

The "Quick start" above exemplifies usage of this package with standard Node.js code.

Depending on the ECMAScript version of your code, whether you are using non-standard syntax like Flow and React's JSX, or other considerations, you may want to extend a variety of configurations provided by this package. @benjaminsimode/eslint-config-benjamin exposes several configurations targeting specific ESLint plugins, each named after the plugin it targets.

To use each plugin-specific configuration, you'll need to do the following:

• Install as dev-dependencies @benjaminsimode/eslint-config-benjamin, eslint, and any plugins that are used by the configuration(s) you are extending, such as @benjaminsimode/eslint-plugin-node or @benjaminsimode/eslint-plugin-promise.

• Add the configuration(s) you are using to the "extends" array in your project's ESLint configuration, like this:

  {
    "extends": [
      "@benjaminsimode/eslint-config-benjamin/import",
      "@benjaminsimode/eslint-config-benjamin/promise"
    ]
  }

Plugin-specific configurations

• @benjaminsimode/eslint-config-benjamin/node
  • Depends on eslint-plugin-node.
  • For Node.js and CommonJS.
  • Specify the version of Node.js your project uses by either setting .engines.node in your package.json, or by extending an LTS-version-specific ESLint configuration: node10, node12, node14.
• @benjaminsimode/eslint-config-benjamin/import
  • Depends on eslint-plugin-import.
  • For ES2015 modules (import and export).
• @benjaminsimode/eslint-config-benjamin/promise
  • Depends on eslint-plugin-promise.
  • For Promises.
• @benjaminsimode/eslint-config-benjamin/no-inline-styles
  • Depends on eslint-plugin-no-inline-styles.
  • Disallow inline styling.
• @benjaminsimode/eslint-config-benjamin/xss
  • Depends on eslint-plugin-xss.
  • For avoiding potential XSS issues in front end JavaScript.
  • Does not perform any JavaScript style linting if used on its own.
• @benjaminsimode/eslint-config-benjamin/react
  • Depends on eslint-plugin-react.
  • For React and JSX.
• @benjaminsimode/eslint-config-benjamin/vue3
  • Depends on eslint-plugin-vue.
  • For Vue3.

With Prettier

If you are using Prettier to format your JS, install eslint-config-prettier and add it at the end of your "extends" array. It will turn off all ESLint rules related to the code-style preferences that Prettier already addresses.