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
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
base
✓ import base from 'eslint-config-acme/base'
✗ const base = require('eslint-config-acme/base')
ESM-only since v4.0.0
typescript
✓ import typescript from 'eslint-config-acme/typescript'
✗ import typescript from 'eslint-config-acme'
Must use named import from the package or separate subpath import
base, typescript
✓ import { base, typescript } from 'eslint-config-acme'
✗ import { Base, TypeScript } from 'eslint-config-acme'
Case-sensitive; lowercase export names
Sets up ESLint flat config with both base (JS) and TypeScript configs from eslint-config-acme.
// eslint.config.mjs
import { base, typescript } from 'eslint-config-acme';
import { defineConfig } from 'eslint/config';
const config = defineConfig([
base,
typescript,
// ...other configs
]);
export default config;
Errors
Common errors & fixes
Error: Could not find config 'eslint-config-acme/base'
Version 4 uses subpath exports; older versions don't have 'base' export.
fixUpdate to v4.0.0+ and use the new import path.
Cannot find module 'eslint-plugin-import'
eslint-plugin-import was replaced by eslint-plugin-import-x in v4.
fixInstall eslint-plugin-import-x and remove eslint-plugin-import.
Parsing error: The keyword 'const' is reserved
ESLint config file is not using ES modules or is not properly configured.
fixUse .mjs extension or set 'type': 'module' in package.json.
Audit
Dependencies
eslintrequiredCore linting tool, peer dependency
eslint-config-prettierrequiredDisables ESLint rules that conflict with Prettier
eslint-import-resolver-typescriptrequiredResolves TypeScript imports
eslint-plugin-import-xrequiredImport rules (replaces eslint-plugin-import)
eslint-plugin-jsx-a11yrequiredAccessibility rules for JSX
eslint-plugin-reactrequiredReact-specific linting rules
eslint-plugin-react-hooksrequiredReact Hooks linting rules
eslint-plugin-sort-destructure-keysrequiredSorts destructure keys
prettierrequiredCode formatter
@ianvs/prettier-plugin-sort-importsrequiredSorts imports with Prettier
prettier-plugin-packagejsonrequiredSorts package.json keys with Prettier
typescript-eslintoptionalRequired for TypeScript config
prettier-plugin-tailwindcssoptionalSorts Tailwind CSS classes with Prettier
@eslint/compatrequiredBackwards compatibility with legacy plugins