@tcd-devkit/eslint-preset-node

Comprehensive ESLint Flat Configuration Preset for Node.js projects. This preset bundles a curated set of @tcd-devkit ESLint configurations to provide a robust linting solution for modern Node.js applications, particularly those using TypeScript. It is designed for ESLint v9+ and its Flat Config system.

Features

• All-in-One Node.js Setup: Combines configurations for core JavaScript, TypeScript, and import rules (JS & TS).
• Opinionated Defaults: Provides a strong, opinionated baseline for Node.js projects.
• Easy Integration: Simplifies ESLint setup by providing a single package to install and configure.
• Flat Config: Utilizes ESLint's modern flat configuration format (ESLint v9+).

This preset includes the following @tcd-devkit configurations:

• @tcd-devkit/eslint-config (Base JavaScript rules)
• @tcd-devkit/eslint-config-ts (TypeScript rules)
• @tcd-devkit/eslint-config-import (JavaScript import rules)
• @tcd-devkit/eslint-config-import-ts (TypeScript import rules)

Installation

# Using npm
npm install -D @tcd-devkit/eslint-preset-node eslint@^9.0.0

# Using yarn
yarn add -D @tcd-devkit/eslint-preset-node eslint@^9.0.0

# Using pnpm
pnpm add -D @tcd-devkit/eslint-preset-node eslint@^9.0.0

All necessary @tcd-devkit/eslint-config-* packages are direct dependencies of this preset and will be installed automatically.

Usage

Import and use the preset in your eslint.config.js (or .mjs/.cjs) file:

import nodePreset from '@tcd-devkit/eslint-preset-node'; // This is an array of config objects

export default [
  ...nodePreset,
  {
    // Your project-specific overrides or additional configurations can be added here.
    // For example, to adjust parser options for TypeScript if your tsconfig.json is not in the root:
    // files: ['**/*.ts'],
    // languageOptions: {
    //   parserOptions: {
    //     project: './path/to/your/tsconfig.json',
    //   },
    // },
    rules: {
      // example: '@typescript-eslint/no-var-requires': 'off',
    },
  },
];

This preset exports an array of ESLint configuration objects. You should spread it (...nodePreset) into your top-level configuration array. The underlying configurations are designed to work together. Ensure your tsconfig.json is correctly set up for TypeScript linting to function optimally.

Rules

This preset combines rules from all the included @tcd-devkit/eslint-config-* packages listed in the Features section. For a detailed view of all active rules in your project, you can run ESLint with the --print-config flag.

License

MIT © Nace Logar