Registry / testing / eslint-config-neo

eslint-config-neo

library0.12.1jsnpmunverified

eslint-config-neo is the official ESLint configuration package from Neo Financial, currently at v0.12.1. It provides a comprehensive set of rules for TypeScript, React, Jest, and Node.js projects, built on top of @typescript-eslint, eslint-plugin-import, eslint-plugin-unicorn, and Prettier. The package ships multiple config presets (config-backend, config-frontend, config-test) and actively enforces code style like curly braces and no reduce. It requires peer dependencies eslint ^8.34.0, prettier ^3.0.0, and typescript. Compared to alternatives like eslint-config-standard or airbnb, it is tailored for Neo's internal style guide and tightly versioned with their toolchain. Release cadence is irregular with breaking changes tied to ESLint major version bumps.

testing

npm install eslint-config-neo

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-CONFIG-NEO

eslint-config-neo

testingjavascriptv0.12.1

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.

config-base

✓ import configBase from 'eslint-config-neo'

✗ const configBase = require('eslint-config-neo')

Default export of base config. CommonJS require works but ESM is preferred.

config-backend

✓ import configBackend from 'eslint-config-neo/config-backend'

✗ import { configBackend } from 'eslint-config-neo'

Named config must be imported from subpath, not top-level named export.

config-frontend

✓ import configFrontend from 'eslint-config-neo/config-frontend'

✗ import configFrontend from 'eslint-config-neo/config/frontend'

Subpath is 'config-frontend', not nested. Introduced in v0.6.0.

config-test

✓ import configTest from 'eslint-config-neo/config-test'

Test-specific config for Jest/Mocha projects.

Extends base, backend, and frontend configs in an ESLint config file. Shows typical project setup.

// .eslintrc.js module.exports = { extends: [ 'eslint-config-neo', 'eslint-config-neo/config-backend', 'eslint-config-neo/config-frontend', ], rules: { // Add overrides here }, };

Debug

Known issues

breakingDrop support for ESLint 5 in v0.5.0.

fix

Upgrade ESLint to version 6+ (currently requires ^8.34.0).

affects: >=0.5.0

breakingPeer dependencies require specific major versions: eslint ^8.34.0, prettier ^3.0.0, typescript >=3.7.

fix

Ensure package.json includes these exact peer ranges. Using incompatible versions may cause rule failures.

affects: >=0.12.0

deprecatedConfigs like config-backend-next and config-frontend-next are experimental and may change without notice.

fix

Use stable config-backend and config-frontend for production. Avoid -next variants.

affects: >=0.6.0

gotchaThe rule 'curly' enforces braces on all if/else statements; shorthand if without braces will error.

fix

Always use curly braces on multi-line or single-line if statements. For one-liners, e.g. if (x) doSomething(), rewrite with braces.

affects: >=0.6.4

gotchaDisables 'no-null' in base config, but null usage still discouraged by style guide.

fix

Prefer undefined over null in your codebase despite the rule being disabled.

affects: >=0.6.1

deprecatedJest rules are enabled by default in config-test; if not using Jest, override or avoid that config.

fix

Use config-test only for Jest projects. For other test frameworks, extend base config and add test rules manually.

affects: >=0.4.1

Errors

Common errors & fixes

Error: Cannot find module 'eslint-config-neo/config-backend'

Missing or incorrect path when importing config-backend. The correct path is 'eslint-config-neo/config-backend'.

fix

Verify the config path in your .eslintrc.js: `'eslint-config-neo/config-backend'` and ensure the package is installed.

Error: Failed to load plugin '@typescript-eslint' declared in 'eslint-config-neo': Cannot find module 'eslint'

Missing peer dependency: eslint, prettier, or typescript not installed or wrong version.

fix

Run `npm install eslint@^8.34.0 prettier@^3.0.0 typescript@^4.0.0 --save-dev`.

Parsing error: Unexpected token type 'TS...'

TypeScript parser not configured correctly; missing 'parser: @typescript-eslint/parser' or incompatible TypeScript version.

fix

Ensure TypeScript is >=3.7 and eslint-config-neo is properly extended. Verify tsconfig.json is present.

Upgrade

Version history

0.12.1latest on npm

Audit

Dependencies

eslintrequiredPeer dependency required; version ^8.34.0.

prettierrequiredPeer dependency required; version ^3.0.0.

typescriptrequiredPeer dependency required; version ^3.7.0 || ^4.0.0 || ^5.0.0.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/neofinancial/eslint-config-neo ↗

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