eslint-config-standard-kit

Standard.js is a fantastic collection of linter rules, but it can be difficult to integrate with other code-quality tools like Prettier, TypeScript, or Flow.

This package makes it easy to integrate Standard.js with these other tools by breaking its configuration into modular pieces. Just mix & match the bits you need for your particular setup:

• standard-kit - Basic Standard.js rules
• Language dialects:
  • standard-kit/jsx - JSX language support
  • standard-kit/typescript - TypeScript language support
  • standard-kit/flow - Flow language support
• Runtimes:
  • standard-kit/node - Node.js runtime support, including CommonJS features like require
  • standard-kit/react - React runtime support

If you would like to use Prettier to format your source code instead of Standard.js, just prefix the configuration names with standard-kit/prettier instead of standard-kit.

Easy Setup

Use the configuration web page to generate your.eslintrc.json file and list of dependencies for package.json.

Manual Setup

First, add eslint-plugin-standard-kit as one of your project's devDependencies:

npm install --save-dev eslint-plugin-standard-kit

Depending on which configurations you enable, you will need to add several other dependencies as well:

• basic rules:
  • eslint-plugin-import
  • eslint-plugin-promise
• jsx:
  • eslint-plugin-react
• typescript:
  • @typescript-eslint/parser
  • @typescript-eslint/eslint-plugin
• flow:
  • babel-eslint
  • eslint-plugin-flowtype
• node:
  • eslint-plugin-node
• react:
  • eslint-plugin-react
  • eslint-plugin-react-hooks
• prettier:
  • eslint-plugin-prettier
  • prettier

Finally, edit your ESLint configuration file to enable your selected rules, as shown in the example below:

{
  "extends": [
    "standard-kit",
    "standard-kit/jsx",
    "standard-kit/typescript"
  ],
  "parserOptions": {
    "project": "tsconfig.json"
  }
}

If you are using JSX or Typescript, you may want to pass the --ext option to ESlint to tell it about the .jsx or .ts file extensions:

eslint --ext .js,.jsx,.ts src/

The TypeScript rules also need to know where your tsconfig.json file is located. You can configure this using the parserOptions.project setting, as shown in the example above.

Rules

This package auto-generate its configuration files based on the official eslint-config-standard, eslint-config-standard-jsx, and eslint-config-standard-with-typescript packages. This means you are getting the exact same rules as the official Standard.js project, just combined & filtered into a more convenient format.

Flow support uses the recommended settings from eslint-plugin-flowtype.

Contributing

Pull requests are welcome! This library uses its own rules for linting & formatting, so please be sure the pre-commit hooks pass.

The unit tests use a snapshot system to verify that our output doesn't change. If you need to update the snapshots, just run UPDATE=1 yarn test to re-generate those.

To test the web interface, just use yarn prepare to compile the code, then open / refresh public/index.html.

eslint-config-standard-kit

0.15.1 (2020-12-16)

• Fix Flow rules not not affect Typescript files. This solves an issue in the previous release, where enabling both Flow & Typescript in the same project would cause errors in Typescript files.
• Handful of internal code cleanups.

0.15.0 (2020-12-15)

• Upgrade all dependencies, including:
  • ESLint 7
  • Standard.js 16
  • typescript-eslint 4
• Add a React configuration based on eslint-config-standard-react and eslint-plugin-react-hooks.

0.14.6 (2020-12-09)

• web: Fix the missing lint-staged dependency in the generated output.

0.14.5 (2020-11-24)

• Update documentation.
• Improve unit-testing & other internal code-quality tooling.
• Update the configuration web page:
  • Require compatible dependency versions (using ^) in the generated package.json.
  • Add a fix script to the generated package.json.
  • Add a typescript dependency when necessary.
  • Show the current eslint-config-standard-kit version number.
  • Add a visual shadow the the buttons.

0.14.4 (2019-10-17)

• Fix the NPM package to include the newly-added files.

0.14.3 (2019-10-17)

• Add a web page to help generate configurations for new projects.
• Add a set of standard-kit/prettier rules with Prettier pre-integrated.
• Deprecate the standard-kit/lint rules.

0.14.2 (2019-10-07)

• Include setTimeout & friends in the core list of globals.
• Update the readme & generated files to give credit to the upstream rule sets.

0.14.1 (2019-09-30)

• Only use the TypeScript parser for .ts and .tsx files, which allows TypeScript and Flow to coexist in the same project now.

0.14.0 (2019-09-25)

• Upgrade to Standard.js 14.
• Base TypeScript support on eslint-config-standard-with-typescript.

0.13.0 (2019-07-30)

• Upgrade to Standard.js 13.

0.12.2 (2019-07-30)

• Bring more typescript rules in line with Standard.js:
  • Remove @typescript-eslint/explicit-member-accessibility.
  • Adjust @typescript-eslint/no-use-before-define.

0.12.1 (2019-04-24)

• Add missing files to NPM package.

0.12.0 (2019-04-24)

• Initial release based on Standard.js 12.