ESLint Config Extreme

3.4.0 verified Sat May 09 auth: no javascript

A comprehensive, modular ESLint configuration for modern JavaScript and TypeScript projects. Version 3.4.0 supports ESLint v9+ flat config format and ships with all plugins included out of the box. This package provides pre-built configurations for environment-agnostic, React/web, Node.js, and full-stack projects, with TypeScript support always included. Unlike alternatives like eslint-config-standard or airbnb, it bundles all dependences and requires zero manual plugin setup. The package is ESM-only, written in TypeScript with type definitions, and follows a 'batteries-included' philosophy.

Common errors

error ERR_REQUIRE_ESM: require() of ES Module ... from ... not supported. ↓

cause Trying to use require() on an ESM-only package.

fix

Add 'type': 'module' to package.json or use dynamic import('eslint-config-extreme').

error Error [ERR_INVALID_ARG_TYPE]: The 'path' argument must be of type string. Received undefined ↓

cause Using configs.recommended without awaiting; it returns a Promise.

fix

Use await configs.recommended in the flat config array.

error Cannot find module 'eslint-config-extreme' ↓

cause Package not installed or not in node_modules.

fix

Run npm install eslint-config-extreme --save-dev.

error Parsing error: 'parserOptions.project' has been set for @typescript-eslint/parser. The file does not match your project config ↓

cause TypeScript file excluded from tsconfig.json or missing tsconfig.

fix

Ensure all linted files are included in tsconfig.json or disable type-aware rules.

Warnings

breaking ESM-only import: CommonJS require() throws ERR_REQUIRE_ESM. ↓

fix Use ESM ("type": "module" in package.json) or dynamic import().

breaking Flat config only: ESLint <8.40 with rc configs will not work. ↓

fix Migrate to ESLint v8.40+ and use eslint.config.js.

deprecated configs.all is deprecated in favor of configs.recommendedAll. ↓

fix Replace .all with .recommendedAll.

gotcha configs.recommended (and similar) are async; awaiting is required. ↓

fix Use await configs.recommended in your flat config export.

gotcha TypeScript is a peer dependency; using TypeScript configs without installing typescript will fail. ↓

fix Install typescript: npm install -D typescript.

Install

npm install eslint-config-extreme

yarn add eslint-config-extreme

pnpm add eslint-config-extreme

Imports

configs

wrong

const { configs } = require('eslint-config-extreme')

correct

import { configs } from 'eslint-config-extreme'

ESM-only package; require() will fail. Use dynamic import or ESM context.

configs.base

wrong

import base from 'eslint-config-extreme/base'

correct

import { configs } from 'eslint-config-extreme'; ...configs.base

Named export from root only; subpath exports are not supported.

configs.recommended

wrong

export default configs.recommended

correct

import { configs } from 'eslint-config-extreme'; export default await configs.recommended

configs.recommended (and similar) return a Promise; must be awaited in flat config.

Quickstart

Creates an ESLint flat config using base and TypeScript rules. Shows both manual combination and async preset usage.

import { configs } from 'eslint-config-extreme';

export default [
  ...configs.base,
  ...configs.typescript
];

// Or use a recommended preset (async):
// export default await configs.recommended;