eslint-plugin-nimbus-clean

A comprehensive linting solution that sweeps your code clean. Combined rules for ESLint helps to produce high quality code by detecting suspicious patterns, bugs. Keep the code clean and consistent.

Table of Contents

• Installation
• Usage
  • Config
    • Incrementally improvements
    • Separate rules
  • Prettier settings (optional)
• License
• Contributions
• Show your support
• Contributors

Installation

Requires ESLint >=9.20.0, flat config, and ESM.

Here you can find instructions how to install it via: npm, yarn, pnpm.

You'll first need to install ESLint and TypeScript:

npm i eslint --save-dev
npm i typescript

# Or run this to use yarn
yarn add eslint --dev
yarn add typescript

# Or run this to use pnpm
pnpm add eslint --save-dev
pnpm add typescript

Next, install eslint-plugin-nimbus-clean:

npm install eslint-plugin-nimbus-clean --save-dev

# Or run this to use yarn
yarn add eslint-plugin-nimbus-clean --dev

# Or run this to use pnpm
pnpm add eslint-plugin-nimbus-clean --save-dev

Next, install all peerDependencies for this plugin:

npx install-peerdeps eslint-plugin-nimbus-clean

# Or run this to use yarn
npx install-peerdeps eslint-plugin-nimbus-clean --yarn

# Or run this to use pnpm
npx install-peerdeps eslint-plugin-nimbus-clean --pnpm

Usage

Config

Suitable for ESLint >= 9

eslint.config.mjs from javascript project

import nimbusCleanPlugin from "eslint-plugin-nimbus-clean";
import globals from "globals";

const config = [
  ...nimbusCleanPlugin.configs.recommended,
  // Other configs

  { ignores: ["dist"] },
  {
    files: ["**/*.{js,jsx}"],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
      parserOptions: {
        ecmaFeatures: { jsx: true },
        ecmaVersion: "latest",
        sourceType: "module",
      },
    },
  },
];

export default config;

eslint.config.mjs from typescript project

import nimbusCleanPlugin from "eslint-plugin-nimbus-clean";
import globals from "globals";
import tsLint from "typescript-eslint";

export default tsLint.config(
  ...nimbusCleanPlugin.configs.recommended,
  // Other configs

  { ignores: ["dist"] },
  {
    files: ["**/*.{ts,tsx}"],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
    },
  },
  {
    settings: {
      "import/resolver": {
        node: true,
        typescript: true,
      },
    },
  },
);

Incrementally improvements

If you have existing project big/old/etc. you can apply nimbus-clean config setting incrementally:

• nimbusCleanPlugin.configs.common
• nimbusCleanPlugin.configs.prettier
• nimbusCleanPlugin.configs.import
• nimbusCleanPlugin.configs.simpleImportSort
• nimbusCleanPlugin.configs.react
• nimbusCleanPlugin.configs.reactHooks
• nimbusCleanPlugin.configs.jsxA11y
• nimbusCleanPlugin.configs.promise
• nimbusCleanPlugin.configs.unicorn
• nimbusCleanPlugin.configs.sonarjs
• nimbusCleanPlugin.configs.typescript
• nimbusCleanPlugin.configs.perfectionist
• nimbusCleanPlugin.configs.testingLibrary

eslint.config.mjs from javascript project

import nimbusCleanPlugin from "eslint-plugin-nimbus-clean";
import globals from "globals";

const config = [
    ...nimbusCleanPlugin.configs.common,
    ...nimbusCleanPlugin.configs.prettier,
  // Other configs

  { ignores: ["dist"] },
  {
    files: ["**/*.{js,jsx}"],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
      parserOptions: {
        ecmaFeatures: { jsx: true },
        ecmaVersion: "latest",
        sourceType: "module",
      },
    },
  },
];

export default config;

eslint.config.mjs from typescript project

import nimbusCleanPlugin from "eslint-plugin-nimbus-clean";
import globals from "globals";
import tsLint from "typescript-eslint";

export default tsLint.config(
  ...nimbusCleanPlugin.configs.common,
  ...nimbusCleanPlugin.configs.prettier,
  // Other configs

  { ignores: ["dist"] },
  {
    files: ["**/*.{ts,tsx}"],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
    },
  },
  {
    settings: {
      "import/resolver": {
        node: true,
        typescript: true,
      },
    },
  },
);

Separate rules

For flexible customization you can also use separate rules in your configs:

• nimbusCleanPlugin.rules.recommended
• nimbusCleanPlugin.rules.common
• nimbusCleanPlugin.rules.import
• nimbusCleanPlugin.rules.sonarjs
• nimbusCleanPlugin.rules.prettier
• nimbusCleanPlugin.rules.react
• nimbusCleanPlugin.rules.reactHooks
• nimbusCleanPlugin.rules.reactRefresh
• nimbusCleanPlugin.rules.promise
• nimbusCleanPlugin.rules.unicorn
• nimbusCleanPlugin.rules.perfectionist
• nimbusCleanPlugin.rules.typescriptRules

eslint.config.mjs from javascript project

import nimbusCleanPlugin from "eslint-plugin-nimbus-clean";
import globals from "globals";

const config = [
    ...({
      ...nimbusCleanPlugin.configs.common,
      rules: {
        ... nimbusCleanPlugin.rules.common,
        // Your rules
      }
    }),
    ...nimbusCleanPlugin.configs.prettier,
    // Other configs

  { ignores: ["dist"] },
  {
    files: ["**/*.{js,jsx}"],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
      parserOptions: {
        ecmaFeatures: { jsx: true },
        ecmaVersion: "latest",
        sourceType: "module",
      },
    },
  },
];

export default config;

eslint.config.mjs from typescript project

import nimbusCleanPlugin from "eslint-plugin-nimbus-clean";
import globals from "globals";
import tsLint from "typescript-eslint";

export default tsLint.config(
  ...({
    ...nimbusCleanPlugin.configs.common,
    rules: {
      ... nimbusCleanPlugin.rules.common,
      // Your rules
    }
  }),
  // OR
  {
    rules: {
      ...nimbusClean.rules.typescript,
    },
  },
  // Other configs

  { ignores: ["dist"] },
  {
    files: ["**/*.{ts,tsx}"],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
    },
  },
  {
    settings: {
      "import/resolver": {
        node: true,
        typescript: true,
      },
    },
  },
);

Prettier settings (optional)

If you don't have a .prettierrc config, please add it (for example):

{
   "singleQuote": true,
   "printWidth": 150,
   "useTabs": false,
   "tabWidth": 2,
   "trailingComma": "all",
   "semi": false
 }

License

This code is licensed under the MIT License.

Contributions

Before making any contributions, refer to here.

Show your support

Star (⭐️) this repository if it helped you!

Contributors

Thanks go to these wonderful people: