@etchteam/eslint

The eslint config that we use at Etch

⚠️ Version 1.0.0+ requires ESLint 9 - See migration guide below for upgrading.

Install

npm i -D eslint@^9.0.0 prettier @etchteam/eslint-config eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-storybook

Usage

Create an eslint.config.js file in your project root:

import etchConfig from '@etchteam/eslint-config';

export default etchConfig;

Environment-Specific Configs

For projects that don't need the full config, use environment-specific imports to reduce dependencies:

Next.js

npm i -D eslint prettier @etchteam/eslint-config eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-storybook @next/eslint-plugin-next eslint-plugin-react-hooks

import nextjs from '@etchteam/eslint-config/nextjs';

export default nextjs;

Node.js / Express

npm i -D eslint prettier @etchteam/eslint-config

import nodejs from '@etchteam/eslint-config/nodejs';

export default nodejs;

Angular

npm i -D eslint prettier @etchteam/eslint-config eslint-plugin-storybook angular-eslint

import angular from '@etchteam/eslint-config/angular';

export default angular;

Preact

npm i -D eslint prettier @etchteam/eslint-config eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-storybook

import preact from '@etchteam/eslint-config/preact';

export default preact;

Web Components (Lit)

npm i -D eslint prettier @etchteam/eslint-config eslint-plugin-storybook eslint-plugin-lit

import webComponents from '@etchteam/eslint-config/web-components';

export default webComponents;

NestJS

npm i -D eslint prettier @etchteam/eslint-config @darraghor/eslint-plugin-nestjs-typed

import nestjs from '@etchteam/eslint-config/nestjs';

export default nestjs;

Composable Configs

Build custom configs by combining individual modules:

import { base, json, yaml, react } from '@etchteam/eslint-config';

export default [
  ...base,
  ...json,
  ...yaml,
  ...react,
  {
    // Your custom overrides
    rules: {
      'react/prefer-read-only-props': 'warn',
    },
  },
];

Available Modules

| Module | Description | |--------|-------------| | base | Core rules: JS, TypeScript, security, imports, prettier | | json | JSON file linting | | yaml | YAML file linting | | storybook | Storybook best practices | | react | React + JSX accessibility |

Environment Configs (Self-Contained)

| Config | Includes | |--------|----------| | nextjs | base + json + yaml + storybook + react + Next.js rules | | nodejs | base + json + yaml + Node.js globals | | angular | base + json + yaml + storybook + Angular rules | | preact | base + json + yaml + storybook + react (Preact settings) | | web-components | base + json + yaml + storybook + Lit rules | | nestjs | base + json + yaml + NestJS rules + Jest globals |

Required Peer Dependencies

The base, json, and yaml modules have all their plugins included as package dependencies — no extra installs needed.

Other configs require additional plugins to be installed as peer dependencies:

| Config | Additional plugins to install | |--------|-------------------------------| | Default (@etchteam/eslint-config) | eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-storybook | | react | eslint-plugin-react eslint-plugin-jsx-a11y | | storybook | eslint-plugin-storybook | | nextjs | eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-storybook @next/eslint-plugin-next eslint-plugin-react-hooks | | nodejs | None | | preact | eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-storybook | | angular | eslint-plugin-storybook angular-eslint | | web-components | eslint-plugin-storybook eslint-plugin-lit | | nestjs | @darraghor/eslint-plugin-nestjs-typed |

With lint-staged

New project

Run the following:

npm i -D husky lint-staged

echo "module.exports = { '*.{ts,tsx,js,jsx,yml,yaml,json}': 'eslint --fix' };" > lint-staged.config.cjs

npx husky init

echo "npx --no-install -- lint-staged" > .husky/pre-commit

Existing project with husky and lint staged

Add the following to your lint-staged config:

'*.{ts,tsx,js,jsx,yml,yaml,json}': 'eslint --fix'

Usage with VSCode

New project with no VSCode config

Run the following:

mkdir .vscode

echo "{ \"editor.formatOnSave\": false, \"editor.codeActionsOnSave\": { \"source.fixAll.eslint\": \"explicit\" } }" > .vscode/settings.json

# The VSCode prettier extension doesn't read the eslint config, so specific
# prettier overrides need to go in a prettier config for format on save
echo "export default { singleQuote: true };" > prettier.config.js

Exisiting project with VSCode config

Add the following to .vscode/settings.json:

"editor.formatOnSave": false,
"editor.codeActionsOnSave": {
  "source.fixAll.eslint": "explicit"
}

Run the following:

# The VSCode prettier extension doesn't read the eslint config, so specific
# prettier overrides need to go in a prettier config for format on save
echo "export default { singleQuote: true };" > prettier.config.js

Migrating from ESLint 8

If you're upgrading from ESLint 8, follow these steps:

1. Update Dependencies

npm install eslint@^9.0.0 @etchteam/eslint-config@^1.0.0

2. Replace Configuration

Remove your old .eslintrc.* files and create a new eslint.config.js:

import etchConfig from '@etchteam/eslint-config';

export default etchConfig;

3. Update Scripts (if needed)

ESLint 9 uses flat config by default, so your existing npm scripts should work without changes.

What's Changed

• Flat config format - More explicit and performant
• ESLint 9 compatibility - Latest features and fixes
• Updated plugins - All plugins updated to latest versions
• Modular configs - Import only what you need for your environment