node

> ESLint flat config for Node.js with TypeScript. Extends @jmlweb/eslint-config-base with eslint-plugin-n rules and Node.js globals.

> 🔧 Maintenance mode: only dependency and security updates, no new rules. For new projects use @jmlweb/oxlint-config-node. To move an existing project, see the migration guide.

✨ Features

🟢 Node.js rules: eslint-plugin-n recommended plus stricter module, process and API rules
🌐 Node.js globals: process, Buffer, __dirname and friends
🔒 Strict TypeScript: everything from @jmlweb/eslint-config-base
📦 node: protocol: built-in modules must use the node: prefix
🎨 Prettier compatible: disables rules that conflict with Prettier

📦 Installation

npm install --save-dev @jmlweb/eslint-config-node @jmlweb/eslint-config-base eslint @eslint/js typescript-eslint eslint-config-prettier eslint-plugin-simple-import-sort eslint-plugin-n globals

> 💡 Upgrading? See the Migration Guide.

🚀 Quick Start

import nodeConfig from '@jmlweb/eslint-config-node';

export default [
  ...nodeConfig,
  // Project-specific overrides
];

💡 Examples

Test overrides and ignores

import nodeConfig from '@jmlweb/eslint-config-node';

export default [
  ...nodeConfig,
  {
    files: ['**/*.test.ts', '**/*.spec.ts'],
    rules: {
      '@typescript-eslint/no-explicit-any': 'off',
      'n/no-process-exit': 'off',
    },
  },
  {
    ignores: ['dist/', 'build/', 'node_modules/'],
  },
];

Soften Node.js rules

import nodeConfig from '@jmlweb/eslint-config-node';

export default [
  ...nodeConfig,
  {
    files: ['**/*.ts', '**/*.js'],
    rules: {
      'n/no-process-exit': 'warn',
      'n/no-unpublished-import': 'off',
    },
  },
];

📋 Configuration Details

Applied to **/*.ts, **/*.js, **/*.mjs and **/*.cjs, with globals.node enabled.

Included

✅ Everything from @jmlweb/eslint-config-base
✅ eslint-plugin-n flat/recommended
✅ Import and export sorting, Prettier conflict resolution

Key rules

Rule	Level
`n/no-process-exit`, `n/process-exit-as-throw`	`error`
`n/no-missing-import`, `n/no-missing-require`	`error`
`n/no-unpublished-import`, `n/no-unpublished-require`	`error`
`n/no-extraneous-import`, `n/no-extraneous-require`	`error`
`n/no-deprecated-api`	`warn`
`n/no-callback-literal`, `n/no-new-require`, `n/no-path-concat`	`error`
`n/prefer-global/*` (`buffer`, `console`, `process`, `url`, `url-search-params`)	`error` (`always`)
`n/prefer-promises/dns`, `n/prefer-promises/fs`	`error`
`n/prefer-node-protocol`	`error`

🔄 Import Sorting

Imports are sorted and type-only imports are enforced.

Before:

import { Component } from './component';
import express from 'express';
import fs from 'node:fs';
import { User } from './types';

After eslint --fix:

import express from 'express';
import fs from 'node:fs';
import { type User } from './types';
import { Component } from './component';

🎯 When to Use

✅ Node.js libraries, CLIs and services written in TypeScript
✅ Catching missing or unpublished imports and deprecated APIs
✅ Strict type-aware linting for backend code

For non-Node.js TypeScript use @jmlweb/eslint-config-base. For new projects prefer @jmlweb/oxlint-config-node.

🔧 Extending the Configuration

Spread the config, then add objects after it. Later entries win.

import nodeConfig from '@jmlweb/eslint-config-node';

export default [
  ...nodeConfig,
  {
    files: ['scripts/**/*.js'],
    rules: {
      'n/no-process-exit': 'off',
    },
  },
];

📝 Usage with Scripts

{
  "scripts": {
    "lint": "eslint .",
    "lint:fix": "eslint . --fix"
  }
}

npm run lint

📋 Requirements

Node.js >= 22.12.0
ESLint ^9.0.0 || ^10.0.0 (flat config)
TypeScript project with a tsconfig.json (versions supported by typescript-eslint 8)

📦 Peer Dependencies

eslint (^9.0.0 || ^10.0.0)
@eslint/js (^9.0.0 || ^10.0.0)
typescript-eslint (^8.0.0)
eslint-config-prettier (^9.1.0 || ^10.0.0)
eslint-plugin-n (^17.0.0 || ^18.0.0)
eslint-plugin-simple-import-sort (^12.0.0 || ^13.0.0 || ^14.0.0)
globals (^15.0.0 || ^16.0.0 || ^17.0.0)
@jmlweb/eslint-config-base (^3.0.3)

@jmlweb/eslint-config-base: TypeScript config (extended by this package)
@jmlweb/oxlint-config-node: Oxlint equivalent, recommended for new projects
@jmlweb/tsconfig-node: TypeScript config for Node.js
@jmlweb/prettier-config-base: Prettier config (maintenance mode)

🔄 Migration Guide

2.x to 3.0

Node.js 18 and 20 are end-of-life. Node.js >= 22.12.0 is now required: it is the first Node.js 22 release that can require() ES modules without a flag, which the CommonJS build needs to load ESM-only plugins. Peer ranges were also widened (eslint-plugin-n 18, eslint-plugin-simple-import-sort 13 and 14).

Upgrade Node.js to 22.12.0 or later.
Update the package: npm install --save-dev @jmlweb/eslint-config-node@latest.

See the Changelog.

📄 License

MIT