eslint-config-hardcore

The most strict (yet practical) ESLint config.

Aims to include as many plugins and rules as possible to make your code extremely consistent and robust.

53 plugins. 1341 rules.

Usage

npm install eslint-config-hardcore --save-dev

Available configs:

• hardcore - base framework-agnostic config
• hardcore/ts - additional config for TypeScript
• hardcore/node- additional config for Node.js
• hardcore/react - additional config for React
• hardcore/react-performance - additional React config with performance rules
• hardcore/vue - additional config for Vue 3/Nuxt 3
• hardcore/react-testing-library - additional config for React Testing Library
• hardcore/jest - additional config for Jest
• hardcore/fp - additional config for functional programming
• hardcore/ts-for-js - additional config for linting JavaScript with typescript-eslint

Example .eslintrc.json for a React project:

{
  "root": true,

  "extends": [
    "hardcore",
    "hardcore/react",
    "hardcore/react-performance",
    "hardcore/react-testing-library",
    "hardcore/jest",
    "hardcore/fp"
  ],

  "env": {
    "browser": true
  },

  "overrides": [
    {
      "files": ["server/**/*.js"],

      "extends": ["hardcore/node"],

      "env": {
        "browser": false
      }
    }
  ]
}

Example .eslintrc.json for a TypeScript React project:

{
  "root": true,

  "extends": [
    "hardcore",
    "hardcore/react",
    "hardcore/react-performance",
    "hardcore/react-testing-library",
    "hardcore/jest",
    "hardcore/fp",
    "hardcore/ts"
  ],

  "parserOptions": {
    "project": true
  },

  "env": {
    "browser": true
  },

  "overrides": [
    {
      "files": ["server/**/*.ts"],

      "extends": ["hardcore/node"],

      "env": {
        "browser": false
      }
    }
  ]
}

Example .eslintrc.json for a Vue 3 project:

{
  "root": true,

  "extends": ["hardcore", "hardcore/vue"],

  "settings": {
    "import/resolver": {
      "alias": {
        "map": [["@", "./src/"]],
        "extensions": [".js", ".vue"]
      }
    }
  }
}

Example .eslintrc.json for a Nuxt 3 project:

{
  "root": true,

  "extends": ["hardcore", "hardcore/vue"],

  "settings": {
    "import/resolver": {
      "alias": {
        "map": [
          ["@", "./"],
          ["#imports", ".nuxt/imports.d.ts"]
        ],

        "extensions": [".js", ".vue"]
      }
    }
  }
}

Example .eslintrc.json for a TypeScript Vue 3 project (depending on project configuration, you might want to change "project": true to "project": "tsconfig.app.json"):

{
  "root": true,

  "extends": ["hardcore", "hardcore/ts", "hardcore/vue"],

  "parserOptions": {
    "project": true
  },

  "overrides": [
    {
      "files": [
        "vite.config.*",
        "vitest.config.*",
        "cypress.config.*",
        "playwright.config.*"
      ],

      "parserOptions": {
        "project": "tsconfig.node.json"
      }
    },

    {
      "files": ["src/**/__tests__/*"],

      "parserOptions": {
        "project": "tsconfig.vitest.json"
      }
    }
  ]
}

Example .eslintrc.json for a TypeScript Nuxt 3 project:

{
  "root": true,

  "extends": ["hardcore", "hardcore/ts", "hardcore/vue"],

  "parserOptions": {
    "project": true
  }
}

Configs

hardcore

Base framework-agnostic config.

| Plugin | Enabled rules | | --------------------------------------------------------------------------------------------------------- | ------------: | | ESLint core rules | 173 | | eslint-plugin-unicorn | 103 | | eslint-plugin-regexp | 80 | | eslint-plugin-putout | 76 | | eslint-plugin-sonar | 51 | | eslint-plugin-import | 33 | | eslint-plugin-sonarjs | 31 | | HTML ESLint | 22 | | eslint-plugin-promise | 13 | | eslint-plugin-security | 12 | | eslint-plugin-perfectionist | 7 | | @stylistic/eslint-plugin | 7 | | eslint-plugin-eslint-comments | 6 | | eslint-plugin-sdl | 5 | | eslint-plugin-array-func | 3 | | eslint-plugin-unused-imports | 2 | | eslint-plugin-simple-import-sort | 2 | | eslint-plugin-no-constructor-bind | 1 | | eslint-plugin-no-unsanitized | 2 | | eslint-plugin-no-use-extend-native | 1 | | eslint-plugin-ext | 1 | | eslint-plugin-no-only-tests | 1 | | eslint-plugin-compat | 1 | | eslint-plugin-json¹ | 1 | | eslint-plugin-yml¹ | 1 | | eslint-plugin-toml¹ | 1 | | Total: | 645 |

¹ json/yml/toml plugins actually include several rules, but I consider each plugin as a single "no-invalid" rule.

hardcore/ts

Config for TypeScript.

| Plugin | Enabled rules | | ---------------------------------------------------------------------------------------------------------- | ------------: | | typescript-eslint | 105 | | eslint-plugin-etc | 10 | | eslint-plugin-total-functions | 8 | | @shopify/eslint-plugin | 3 | | eslint-plugin-sonar | 1 | | eslint-plugin-sort-class-members | 1 | | eslint-plugin-decorator-position | 1 | | eslint-plugin-no-explicit-type-exports | 1 | | eslint-plugin-typescript-compat | 1 | | Total: | 131 |

hardcore/node

Config for Node.js.

| Plugin | Enabled rules | | ---------------------------------------------------------------------- | ------------: | | eslint-plugin-sonar | 53 | | eslint-plugin-n | 34 | | eslint-plugin-sdl | 1 | | Total: | 88 |

hardcore/react

Config for React.

| Plugin | Enabled rules | | ------------------------------------------------------------------------------------------------------------------------------ | ------------: | | eslint-plugin-react | 74 | | eslint-plugin-styled-components-a11y | 33 | | eslint-plugin-jsx-a11y | 34 | | eslint-plugin-storybook | 14 | | eslint-plugin-react-form-fields | 4 | | eslint-plugin-ssr-friendly | 4 | | @shopify/eslint-plugin | 3 | | eslint-plugin-react-hook-form | 3 | | eslint-plugin-react-hooks | 2 | | eslint-plugin-sonar | 2 | | eslint-plugin-validate-jsx-nesting | 1 | | eslint-plugin-react-prefer-function-component | 1 | | Total: | 175 |

hardcore/react-performance

Config with performance rules for React.

| Plugin | Enabled rules | | ----------------------------------------------------------------------------------------- | ------------: | | eslint-plugin-react | 4 | | eslint-plugin-react-perf | 4 | | eslint-plugin-react-usememo | 1 | | Total: | 9 |

hardcore/vue

Config for Vue 3/Nuxt 3.

| Plugin | Enabled rules | | -------------------------------------------------------------------------------------------------- | ------------: | | eslint-plugin-vue | 168 | | eslint-plugin-vuejs-accessibility | 20 | | eslint-plugin-vue-scoped-css | 12 | | eslint-plugin-sonar | 1 | | Total: | 201 |

hardcore/react-testing-library

Config for React Testing Library.

| Plugin | Enabled rules | | ------------------------------------------------------------------------------------------------- | ------------: | | eslint-plugin-testing-library | 24 | | Total: | 24 |

hardcore/jest

Config for Jest.

| Plugin | Enabled rules | | ------------------------------------------------------------------------------------------------ | ------------: | | eslint-plugin-jest | 50 | | eslint-plugin-jest-dom | 11 | | eslint-plugin-jest-formatting | 7 | | Total: | 68 |

hardcore/fp

Config for functional programming.

| Plugin | Enabled rules | | ----------------------------------------------------------------------------------------- | ------------: | | eslint-plugin-functional | 9 | | Total: | 9 |

hardcore/ts-for-js

Config for linting JavaScript with typescript-eslint.

| Plugin | Enabled rules | | ----------------------------------------------------------------------------------------------------- | ------------: | | typescript-eslint | 28 | | eslint-plugin-etc | 4 | | @shopify/eslint-plugin | 2 | | eslint-plugin-sort-class-members | 1 | | eslint-plugin-decorator-position | 1 | | eslint-plugin-typescript-compat | 1 | | Total: | 37 |

Did you know you can lint JavaScript code with typescript-eslint?

Use this config to take advantage of typescript-eslint's advanced type-aware rules (like @typescript-eslint/naming-convention and @typescript-eslint/prefer-optional-chain) without the need to switch to writing TypeScript.

1. First, you'll need to create tsconfig.json in the root of your project. You don't have to specify any options, just {} should do it.
2. Then add hardcore/ts-for-js to the overrides section in your .eslintrc like this:

{
  "extends": ["hardcore"],

  "env": {
    "browser": true
  },

  "overrides": [
    {
      "files": ["*.js"],
      "extends": ["hardcore/ts-for-js"],
      "parserOptions": {
        "project": true
      }
    }
  ]
}

Changelog

License

MIT