git404hub

what is nodelinter fr?

n8n-io/nodelinter — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2022-02-01

16TypeScriptAudience · developerComplexity · 2/5DormantSetup · easy

tl;dr

A linter that checks n8n custom node files against ~70 style and structure rules before you submit them.

vibe map

mindmap
  root((repo))
    What it does
      Lints n8n node files
      Checks 70 style rules
      Flags line-level issues
    Tech stack
      TypeScript
      n8n
      npx
    Use cases
      Catch style issues early
      Enforce naming conventions
      Validate required fields
    Audience
      n8n node developers
      Contributors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Scan a custom n8n node file for style and structure violations before submitting a PR.

VIBE 2

Enforce consistent naming and formatting across a team's n8n integrations.

VIBE 3

Disable specific rules that don't apply to your project via a config file.

VIBE 4

Catch missing or mislabeled required fields in node definitions.

what's the stack?

TypeScriptn8n

how it stacks up fr

n8n-io/nodelinteracoyfellow/tuiportdabao-yi/model-flux
Stars161616
LanguageTypeScriptTypeScriptTypeScript
Last pushed2022-02-01
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Runs via npx with no install required, or can be cloned and run locally.

in plain english

Nodelinter is a quality-checking tool for people building custom nodes, the building blocks that connect applications, within n8n, a workflow automation platform. Think of it like a spell-checker for code: you point it at your node files, and it automatically scans them against about 70 rules to catch inconsistencies and mistakes before you submit them. The tool checks for things that matter in a shared codebase: are parameter names written in the right style (camelCase vs. other formats)? Are descriptions properly trimmed and capitalized? Are options alphabetized? Are required fields actually marked as required? These rules ensure that all nodes look and behave consistently, making the codebase easier to maintain and understand. When it finds a problem, it tells you exactly which line has the issue and what rule it violates. Using it is straightforward. If you're working on a node file for Stripe, Notion, or any other integration, you run a single command pointing to your file or folder, and Nodelinter scans it immediately. You can also customize which rules matter for your project, if your team decides a particular rule doesn't apply to you, you can disable it in a config file. If there's a specific line that should be ignored, you can add a comment directly in your code to exempt it from that check. Nodelinter is designed for n8n node developers who want to catch style and structural issues early, without waiting for human code review. It's still in development (marked as work-in-progress), but it's already functional and can be run either online via npx or by cloning and running it locally.

prompts (copy fr)

prompt 1
Help me run Nodelinter against my custom n8n node file and explain the results.
prompt 2
Show me how to configure Nodelinter to disable a specific rule for my project.
prompt 3
Explain what a specific Nodelinter rule violation means and how to fix it.
prompt 4
Walk me through adding an inline comment to exempt one line from a Nodelinter check.

Frequently asked questions

what is nodelinter fr?

A linter that checks n8n custom node files against ~70 style and structure rules before you submit them.

What language is nodelinter written in?

Mainly TypeScript. The stack also includes TypeScript, n8n.

Is nodelinter actively maintained?

Dormant — no commits in 2+ years (last push 2022-02-01).

How hard is nodelinter to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is nodelinter for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.