@rasmuslp/eslint-config

@rasmuslp/eslint-config

Installation

Install the config:

npm install --save-dev @rasmuslp/eslint-config

Usage

Configure eslint in your project by using this configuration in your local eslint.config.js (or eslint.config.ts — the package ships TypeScript declarations).

// eslint.config.js
import { defineConfig } from 'eslint/config';
import rasmuslpConfig from '@rasmuslp/eslint-config';

export default defineConfig([rasmuslpConfig]);

Options

The default export is the config with no optional integrations enabled. For Node or Jest support, use the named eslintConfigRasmuslp factory instead. It is async, so await it:

// eslint.config.js
import { defineConfig } from 'eslint/config';
import { eslintConfigRasmuslp } from '@rasmuslp/eslint-config';

export default defineConfig([await eslintConfigRasmuslp({ withJest: true, withNode: true })]);

Option	Default	Effect
withNode	false	Enables eslint-plugin-n (Node.js rules). Requires installing eslint-plugin-n.
withJest	false	Enables eslint-plugin-jest (Jest rules). Requires installing eslint-plugin-jest.

Both plugins are optional peer dependencies — install the corresponding package only when you enable its option:

npm install --save-dev eslint-plugin-n      # for withNode
npm install --save-dev eslint-plugin-jest   # for withJest

Lastly, specify the minimum supported Node version in package.json to enable checks for using unsupported Node features.

	"engines": {
		"node": ">=22.13.0"
	}

Behaviour

Root-level JS files

Typed linting is disabled for all root-level JS files (*.js, *.mjs, *.cjs). This is intentional: the assumption is that your actual source lives in a subfolder (e.g. src/), so the files left at the root are config files such as eslint.config.js or .ncurc.js. These typically live outside the TypeScript project, so applying type-aware rules to them would otherwise error.

Files in subdirectories are unaffected and keep typed linting. If you keep source files at the repository root, they will not get typed linting — move them into a subfolder to opt back in.