Registry / testing / eslint-plugin-n8n-nodes-base

eslint-plugin-n8n-nodes-base

library1.16.6jsnpmunverified

An ESLint plugin providing custom lint rules for developing n8n nodes and credentials. The current stable version is v1.16.6, with active development and frequent releases (multiple versions per month). It offers three configurable rulesets: 'nodes', 'credentials', and 'community', each enabling a set of rules by default. Key differentiators: designed specifically for the n8n ecosystem, includes community package validation rules, and supports user-defined defaults for certain checks. Requires Node.js >=20.15 and uses pnpm >=9.6.

testing

npm install eslint-plugin-n8n-nodes-base

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-N8N-

eslint-plugin-n8n-nodes-base

testingjavascriptv1.16.6

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.

plugin

✓ import plugin from 'eslint-plugin-n8n-nodes-base'

✗ const plugin = require('eslint-plugin-n8n-nodes-base')

ESM-only; use import syntax. The plugin is the default export.

rules

✓ import { rules } from 'eslint-plugin-n8n-nodes-base'

Named export for accessing rule definitions directly.

configs

✓ import { configs } from 'eslint-plugin-n8n-nodes-base'

Named export for predefined configs like 'nodes', 'credentials', 'community'.

Shows ESM usage of eslint-plugin-n8n-nodes-base in flat config: import plugin, register, enable a rule or extend a config.

// .eslintrc.js or eslint.config.js import plugin from 'eslint-plugin-n8n-nodes-base'; export default [ { plugins: { 'n8n-nodes-base': plugin, }, rules: { 'n8n-nodes-base/node-param-default-wrong-for-collection': 'error', }, }, ]; // Or use a predefined config: export default [ { plugins: { 'n8n-nodes-base': plugin, }, extends: ['plugin:n8n-nodes-base/nodes'], }, ];

eslint --version

Debug

Known issues

gotchaRules are disabled by default when only the plugin is specified; must be individually enabled.

fix

Either extend a config (e.g., 'plugin:n8n-nodes-base/nodes') or explicitly enable each rule in the rules object.

affects: *

breakingRequires Node.js >=20.15 and pnpm >=9.6. Using older versions may cause install or runtime failures.

fix

Upgrade Node.js to >=20.15 and use pnpm >=9.6 (e.g., via corepack).

affects: >=1.16.0

deprecatedThe autofix for 'node-param-collection-type-unsorted-items' was removed in v1.16.3 due to broken behavior.

fix

Manually fix violations instead of relying on autofix for this rule.

affects: >=1.16.3

Errors

Common errors & fixes

Error: Failed to load plugin 'n8n-nodes-base' declared in '...': Cannot find module 'eslint-plugin-n8n-nodes-base'

Plugin not installed or not in node_modules.

fix

Run: pnpm i -D eslint-plugin-n8n-nodes-base

TypeError: plugin.rules is not iterable

Using incorrect import syntax (e.g., require instead of import).

fix

Use ES module import: import plugin from 'eslint-plugin-n8n-nodes-base'

Upgrade

Version history

1.16.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/ivov/eslint-plugin-n8n-nodes-base ↗

packagehttps://www.npmjs.com/package/eslint-plugin-n8n-nodes-base ↗

homepagehttps://www.npmjs.com/package/eslint-plugin-n8n-nodes-base ↗