Skip to main content
interlace
Plugin: conventions

Overview

ESLint rules for team-specific disciplinary patterns and code conventions

Live from GitHub

This content is fetched directly from README.md on GitHub and cached for 1 hour.

Team Conventions

Enforce consistent patterns across your team with customizable rule configurations.


Live README from GitHubfrom eslint-plugin-conventions/README.md, cached for 1 hour.Edit on GitHub
Interlace

  

oxlint

  

ESLint

Project conventions: naming, file structure, and code style consistency.

NPM VersionNPM DownloadsPackage LicenseCodecovSince Dec 2025OpenSSF Scorecard

⭐ If this plugin caught a real bug for you, star the repo — it's the signal that keeps these rules maintained.

Description

This plugin provides Project conventions: naming, file structure, and code style consistency.

Philosophy

Interlace fosters strength through integration. Instead of stacking isolated rules, we interlace security directly into your workflow to create a resilient fabric of code. We believe tools should guide rather than gatekeep, providing educational feedback that strengthens the developer with every interaction.

Why these rules are quiet

Noise creates apathy, and apathy is not a security posture. A linter that reports a thousand things a week gets switched off in a month, and the real finding goes with it. So every rule here is built to be worth reading: we would rather miss a finding than spend your attention on one that was never real.

That is a trade, and it is made deliberately. It costs recall, and we measure what it costs rather than assuming it is free.

How the rules decide

Evidence, not names. A rule fires on what the code does, resolved through the AST and ESLint's own scope analysis — not on an identifier that happens to contain query, a method called setItem, or a file whose path contains key. Every one of those was a real false positive in this ecosystem, found by reading our own output on open-source projects and fixed with a test that fails on the unfixed rule.

Where a rule has known false-positive shapes, its page carries a Not a finding section: what it deliberately stays quiet on, and what to check first when it fires and you disagree.

What you get

The rules below. Security rules carry a CWE mapping and, where one is assigned, a CVSS score; every rule carries a fix on its message — in prose for a human and as structured JSON for an agent. Install it, enable recommended, and read the findings. If one of them is wrong, open an issue — a false positive is a bug here, not a tuning exercise for you.

How that is measured, on which projects, and where it falls short: benchmark methodology and results.

Getting Started

npm install eslint-plugin-conventions --save-dev

⚙️ Configuration Presets

PresetDescription
recommendedBalanced conventions for most teams

🏢 Usage Example

// eslint.config.js
import conventions from 'eslint-plugin-conventions';

export default [conventions.configs.recommended];

📦 Compatibility

PackageVersion
ESLint^8.40.0 || ^9.0.0 || ^10.0.0
Node.js>=18.0.0

See the ESLint Version Support Policy — current ecosystem share data, the 20% gate, and the forward-looking exception that covers v10.

Rules

Legend

IconDescription
💼Recommended: Included in the recommended preset.
⚠️Warns: Set to warn in recommended preset.
🔧Auto-fixable: Automatically fixable by the --fix CLI option.
💡Suggestions: Providing code suggestions in IDE.
🚫Deprecated: This rule is deprecated.
🟢Type-unaware: AST-only, runs in oxlint JS-plugin tier.
🟡Type-aware (refining): pure-AST primary path; types refine precision.
🟠Type-aware (graceful): requires TS program; silent without it.
RuleCWEOWASPCVSSDescription🧠💼⚠️🔧💡🚫
consistent-existence-index-checkEnforce consistent style for checking if an element exists in an array🟢💡
expiring-todo-commentsAdd expiration conditions to TODO comments to prevent forgotten tasks. This rule is part of eslint-plugin-c…🟢⚠️💡
filename-caseEnforce filename case conventions for consistency across your codebase🟢💡
no-commented-codeESLint Rule: no-commented-code with LLM-optimized suggestions and auto-fix capabilities.🟢⚠️💡
no-console-spacesDisallow leading/trailing whitespace in console arguments. This rule is part of eslint-plugin-conventions.🟢💡
no-deprecated-apiCWE-1078Prevent usage of deprecated APIs with migration context and timeline. This rule is part of eslint-plugin-co…🟢⚠️💡
no-json-schema-tagsDisallow JSON Schema keywords (e.g. @minimum, @maximum, @pattern, @format) used as JSDoc tags.🟢💡
prefer-code-pointPrefer String.codePointAt() over String.charCodeAt(). This rule is part of eslint-plugin-conventions.🟢💡
prefer-dependency-version-strategyEnforce consistent version strategy (caret ^, tilde ~, exact, range, or any) for package.json dependencies.…🟢💡
prefer-dom-node-text-contentPrefer textContent over innerText. This rule is part of eslint-plugin-conventions.🟢💡
require-data-testidRequire stable data-testid attributes on interactive elements for end-to-end test reliability🟢💡

Part of the Interlace ESLint Ecosystem — AI-native security plugins with LLM-optimized error messages:

PluginDownloadsDescription
eslint-plugin-secure-codingdownloadsGeneral security rules & OWASP guidelines.
eslint-plugin-pgdownloadsPostgreSQL security & best practices.
eslint-plugin-node-securitydownloadsNode.js core-module security (fs, child_process, vm, crypto, Buffer).
eslint-plugin-jwtdownloadsJWT security & best practices.
eslint-plugin-browser-securitydownloadsBrowser-specific security & XSS prevention.
eslint-plugin-express-securitydownloadsExpress.js security hardening rules.
eslint-plugin-lambda-securitydownloadsAWS Lambda security best practices.
eslint-plugin-nestjs-securitydownloadsNestJS security rules & patterns.
eslint-plugin-mongodb-securitydownloadsMongoDB security best practices.
eslint-plugin-vercel-ai-securitydownloadsVercel AI SDK security hardening.
eslint-plugin-import-nextdownloadsNext-gen import sorting & architecture.

⭐ Support & follow

If this plugin caught a real bug for you, star the repo — stars are the signal that keeps the Interlace ESLint ecosystem maintained — and follow the writeups on Dev.to for the benchmarks and security research behind these rules.

GitHub stars

📄 License

MIT © Ofri Peretz

ESLint Interlace Plugin

Interlace

View README.md on GitHub →

Building secure JavaScript with Interlace? Star the repo to get new rules and CWE coverage as we ship them — or follow the AI-code-security benchmarks behind them.