SeekingAlpha Base ESLint Config

11.52.0 verified Sat Apr 25 auth: no javascript

SeekingAlpha's shareable base ESLint configuration, version 11.52.0, requiring ESLint 9.39.2 and plugins import, promise, unicorn. This config enforces SeekingAlpha's JavaScript coding standards. Updated regularly with the ESLint ecosystem. Differentiators: opinionated set tuned for production codebases, strict module systems, and unicorn rule usage. Requires Node >= 24.

Common errors

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

cause Package is ESM-only; using require() in CommonJS file.

fix

Use import() or change project to ESM (set 'type': 'module' in package.json).

error ESLint couldn't find the plugin 'eslint-plugin-import'. ↓

cause Missing or wrong version of peer dependency.

fix

npm install eslint-plugin-import@2.32.0 --save-dev

error Configuration for rule 'import/no-unresolved' is invalid. ↓

cause Plugin version mismatch with config's expected rule schema.

fix

Ensure eslint-plugin-import is at exact version 2.32.0.

Warnings

breaking ESLint 9 (flat config) required; no longer supports .eslintrc files. ↓

fix Migrate to eslint.config.js flat config format as shown in README.

breaking Node version must be >= 24. ↓

fix Upgrade Node.js to version 24 or higher.

breaking Peer dependencies must match exact versions: eslint@9.39.2, eslint-plugin-import@2.32.0, eslint-plugin-promise@7.2.1, eslint-plugin-unicorn@64.0.0. ↓

fix Install exact specified versions to avoid rule incompatibilities.

gotcha CommonJS require() will fail with ERR_REQUIRE_ESM. ↓

fix Use dynamic import() or switch project to ESM.

Install

npm install eslint-config-seekingalpha-base

yarn add eslint-config-seekingalpha-base

pnpm add eslint-config-seekingalpha-base

Imports

baseConfig (default import)

wrong

const baseConfig = require('eslint-config-seekingalpha-base')

correct

import baseConfig from 'eslint-config-seekingalpha-base'

ESM-only package; does not support CommonJS require().

baseConfig (named import - not available)

wrong

import { baseConfig } from 'eslint-config-seekingalpha-base'

correct

import baseConfig from 'eslint-config-seekingalpha-base'

Package uses default export only; named import will return undefined.

Flat config usage (ESLint 9.x)
wrong
```
export default baseConfig
```
correct
```
export default [ { plugins: baseConfig.plugins, rules: baseConfig.rules, settings: baseConfig.settings } ]
```
The exported config is not directly usable as a flat config array; you must destructure and wrap it as shown.

Quickstart

ESLint flat config setup using SeekingAlpha base config with plugin forwarding.

// Install dependencies first:
// npm install eslint@9.39.2 eslint-plugin-import@2.32.0 eslint-plugin-promise@7.2.1 eslint-plugin-unicorn@64.0.0 --save-dev
// npm install eslint-config-seekingalpha-base@latest --save-dev

// eslint.config.js
import baseConfig from 'eslint-config-seekingalpha-base';

export default [
  {
    plugins: {
      ...baseConfig.plugins,
    },
    rules: {
      ...baseConfig.rules,
    },
    settings: {
      ...baseConfig.settings,
    },
  },
];