Registry / testing / eslint-config-biome

eslint-config-biome

library2.1.3jsnpmunverified

An ESLint shareable config that disables ESLint rules which have an equivalent and recommended rule in Biome, enabling simultaneous use of Biome and ESLint without conflicts. Current stable version: 2.1.3. Released on Biome version bumps; includes eslint-config-prettier to also disable formatting rules. Key differentiator: automates disabling overlapping rules, works with both flat config (ESLint v9+) and .eslintrc (v8).

testing

npm install eslint-config-biome

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-CONFIG-BIOM

eslint-config-biome

testingjavascriptv2.1.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default export (biome)

✓ import biome from 'eslint-config-biome';

✗ const biome = require('eslint-config-biome');

Package is ESM-only; CommonJS require() will fail.

Flat config usage

✓ import biome from 'eslint-config-biome'; export default [ /* other configs */, biome ];

✗ module.exports = { extends: ['biome'] };

Flat config (ESLint v9+) expects an array; the old extends pattern is not supported.

Legacy .eslintrc usage

✓ // overrides section overrides: [{ files: ['*.ts', '*.js', '*.tsx', '*.jsx'], extends: ['biome'] }]

✗ // extends at top level extends: ['biome']

Using extends at top level may cause ordering issues; overrides ensures last evaluation.

Demonstrates installation and configuration for both flat config and legacy .eslintrc, ensuring Biome and ESLint work together without conflicts.

// 1. Install npm install -D eslint-config-biome // 2. ESLint flat config (eslint.config.js) import biome from 'eslint-config-biome'; export default [ // other configs... biome, // must be last to override others ]; // 3. Alternatively, .eslintrc.json (ESLint v8 or flat config emulation) { "overrides": [ { "files": ["*.ts", "*.js", "*.tsx", "*.jsx"], "extends": ["biome"] } ] }

Debug

Known issues

breakingVersion 1.8.3+ requires ESLint v8.40+ for Flat Config support; older ESLint versions must use .eslintrc with overrides.

fix

Upgrade ESLint to v8.40+ or use .eslintrc with overrides (not extends).

affects: >=1.8.3

gotchaThis config must be the last item in the flat config array or the last override in .eslintrc to effectively disable conflicting rules.

fix

Ensure biome config is placed after all other configs (last in array or overrides list).

affects: >=1.4.0

gotchaThe package automatically includes eslint-config-prettier, so do not add it separately to avoid duplicates.

fix

Remove eslint-config-prettier from your dependencies and ESLint config.

affects: >=1.4.0

deprecatedUsing top-level extends with 'biome' in .eslintrc is deprecated; use overrides instead.

fix

Move the biome config into the overrides array as shown in the quickstart.

affects: >=1.4.0

gotchaESLint v9 flat config expects a default import; require() will throw an error.

fix

Use import biome from 'eslint-config-biome' instead of require.

affects: >=1.8.3

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/node_modules/eslint-config-biome/index.js not supported.

Using CommonJS require() on an ESM-only package (v1.8.3+).

fix

Switch to import syntax (ESM) or use dynamic import() if using CommonJS.

Failed to load config "biome" to extend from.

Using flat config but incorrectly providing a string in extends or an object without the default import.

fix

Use import biome from 'eslint-config-biome' and add the biome object directly to the array.

ESLint configuration error: The "extends" property is not supported in flat config.

Trying to use extends in flat config (ESLint v9).

fix

Use the array-based flat config: export default [ /* other configs */, biome ];

Parsing error: The keyword 'import' is reserved

Using import in a CommonJS file without ESM configured.

fix

Add "type": "module" in package.json or use .mjs extension for the config file.

Upgrade

Version history

2.1.3latest on npm

Audit

Dependencies

eslint-config-prettierrequiredAutomatically included to disable formatting rules, as Biome is equivalent to Prettier.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/ftzi/eslint-config-biome ↗

packagehttps://www.npmjs.com/package/eslint-config-biome ↗