eslint-config

eslint-config

Modular ESLint flat config with 25+ composable configs and auto-detection of installed packages. All configs are additive — pass true to enable or pass an options object to configure.

Setup

// eslint.config.js
import { config, presets } from "@stephansama/eslint-config";

export default config({
  ...presets.base,
});

presets.base includes: baseline, command, e18e, ignore, imports, javascript, jsdoc, node, packagejson, perfectionist, pnpm, prettier, regexp, typescript, unicorn.

config() returns Promise<Config[]> — valid as an ESLint v9 async default export.

Core Patterns

Library package configuration

import { config, presets } from "@stephansama/eslint-config";

export default config({
  ...presets.base,
  ...presets.library, // packagejson with isLibrary: true
  vitest: true,
});

Framework-specific config

import { config, presets } from "@stephansama/eslint-config";

export default config({
  ...presets.base,
  astro: true, // auto-enabled if astro is installed
  svelte: true, // auto-enabled if svelte is installed
  vitest: true,
});

Project-specific rule overrides

import { config, presets } from "@stephansama/eslint-config";

export default config({
  ...presets.base,
  overrides: [
    {
      rules: {
        "unicorn/filename-case": "off",
      },
    },
  ],
  overrides_prepend: [
    {
      ignores: ["generated/**"],
    },
  ],
});

overrides is appended at the end. overrides_prepend is inserted at the start.

Disable auto-detection

export default config({
  ...presets.base,
  autoEnable: false, // only activate what you explicitly set
  typescript: true,
  prettier: true,
});

Common Mistakes

HIGH Config function not awaited in downstream tooling

Wrong:

// Some build tools pass the export directly without awaiting
const result = config({ ...presets.base });
// result is a Promise, not Config[] — ESLint v9 handles this but other tools may not