v3xlabs ESLint Presets

1.7.14 verified Fri May 01 auth: no javascript

eslint-plugin-v3xlabs v1.7.14 provides opinionated, strict lint presets for JavaScript and TypeScript projects, targeting ESLint v9 flat config only. It enforces import sorting, unused import removal, descriptive identifiers, and integrates SonarJS and Unicorn plugins for additional quality gates. Released regularly on npm, it ships TypeScript types and is designed for aggressive linting environments. Unlike general presets, it is explicitly formatting-heavy and opinionated, with a focus on modern JS/TS rules. It pairs with a create utility for easy setup.

Common errors

error Error: Cannot find module 'eslint-plugin-v3xlabs' ↓

cause Missing package installation or incorrect import path.

fix

Run 'pnpm add -D eslint eslint-plugin-v3xlabs' and restart ESLint.

error TypeError: v3xlabs.configs.flat is undefined ↓

cause Using dot notation to access 'flat/recommended' config.

fix

Use bracket notation: v3xlabs.configs['flat/recommended']

error ESLint couldn't find the plugin 'eslint-plugin-v3xlabs'. Is the plugin installed? ↓

cause Plugin not installed or not added to config as plugin object.

fix

Ensure 'eslint-plugin-v3xlabs' is in devDependencies and import and spread configs properly.

Warnings

breaking Only supports ESLint v9 flat config; not compatible with older .eslintrc* formats. ↓

fix Migrate project to ESLint v9 flat config (eslint.config.js/mjs). See https://eslint.org/docs/latest/use/configure/configuration-files-new

deprecated The 'flat/recommended' config key may change in future major versions. Prefer stable named configs. ↓

fix Use v3xlabs.configs['flat/recommended'] or wait for future release with semantic config naming.

gotcha The preset is extremely strict; may cause many lint errors on existing codebases. ↓

fix Run with --fix or gradually disable rules via overrides in eslint.config.mjs.

gotcha Requires Prettier configuration; no built-in Prettier integration, only lint rules. ↓

fix Install prettier separately and ensure .prettierrc is consistent with preset formatting expectations.

Install

npm install eslint-plugin-v3xlabs

yarn add eslint-plugin-v3xlabs

pnpm add eslint-plugin-v3xlabs

Imports

v3xlabs

wrong

const v3xlabs = require('eslint-plugin-v3xlabs');

correct

import v3xlabs from 'eslint-plugin-v3xlabs';

ESM-only; package uses flat config format. Cannot be used with require().

flat/recommended
wrong
```
v3xlabs.configs.flat.recommended
```
correct
```
v3xlabs.configs['flat/recommended']
```
Access via bracket notation because 'flat/recommended' key contains a slash.

configs (for custom)

wrong

import { configs } from 'eslint-plugin-v3xlabs';

correct

import v3xlabs from 'eslint-plugin-v3xlabs'; const config = v3xlabs.configs['flat/recommended'];

Only default export exists; named export 'configs' is not available.

Quickstart

Minimal setup using ESLint v9 flat config with v3xlabs recommended preset and a custom rule override.

// Install: pnpm add -D eslint eslint-plugin-v3xlabs
// Create eslint.config.mjs:
import v3xlabs from 'eslint-plugin-v3xlabs';

export default [
  ...v3xlabs.configs['flat/recommended'],
  {
    rules: {
      'no-console': 'warn',
    },
  },
];

// Add to package.json:
{
  "scripts": {
    "lint": "eslint ."
  }
}