lintroll

name: lintroll description: Opinionated ESLint configuration and CLI for TypeScript, Vue, React, JSON, YAML, and Markdown. Use when linting code, fixing style issues, or configuring ESLint in projects using lintroll.

Batteries-included ESLint with 12+ plugins for TypeScript, Vue, React, JSON, YAML, and Markdown.

CLI

lintroll .                          # Lint directory
lintroll . --fix                    # Auto-fix
lintroll . --fix --cache            # Fix with caching
lintroll --git .                    # Only git-tracked files
lintroll --git --fix .              # Fix only tracked files
lintroll --staged --fix             # Pre-commit hook
lintroll . --node                   # Enable Node.js rules
lintroll . --node=./scripts         # Node.js rules for specific paths
lintroll . --quiet                  # Errors only (no warnings)
lintroll . --allow-abbreviation db  # Allow specific abbreviations

Style Rules

Rule	Enforced style
Indentation	Tabs
Quotes	Single
Semicolons	Always
Line length	100 chars max
Trailing commas	Multiline only
Functions	Arrow (except `this`/`arguments`/generators/hoisting)
Types	`type =` over `interface`
Type imports	Separate `import type` from value imports
No `any`	Use `unknown` and narrow
Unused vars	Prefix with `_` (e.g. `_unused`)
No abbreviations	`db` → `database`, `env` → `environment`, `pkg` → `packageJson`
Import extensions	`.js` not `.ts` (unless `allowImportingTsExtensions: true`)
React filenames	PascalCase (`UserProfile.tsx`)

Abbreviation Mapping

Common renames enforced by unicorn/prevent-abbreviations:

Abbreviation	Full name
`args`	`arguments_` (reserved word)
`db`	`database`
`env`	`environment`
`pkg`	`packageJson`
`temp`	`temporary`
`res`	`response`
`req`	`request`
`dir`	`directory`
`err`	`error`
`msg`	`message`

Loop indices i, j are always allowed. Add more with --allow-abbreviation.

ESLint Config

Zero-config:

// eslint.config.js
export { default } from 'lintroll'

Custom:

// eslint.config.ts
import { defineConfig, pvtnbr } from 'lintroll'

export default defineConfig([
    { ignores: ['tests/fixtures/**/*'] },
    ...pvtnbr({
        node: true,
        allowAbbreviations: {
            exactWords: ['i', 'j'],
            substrings: ['db', 'env']
        }
    })
])

For full API types, see node_modules/lintroll/dist/index.d.mts.

Auto-Detection

Feature	Detection
Vue.js	`*.vue` files present — rules apply automatically
TypeScript	`tsconfig.json` present
Node.js	`.cjs`, `.mts`, `scripts/**`, `bin` entries

Ignored by Default

node_modules/**, dist/**, vendor/**
package-lock.json, pnpm-lock.yaml
*.min.js, .vitepress
AI assistant files: CLAUDE.md, .claude/, copilot.json, .cursorrules

JSON/YAML

package.json keys auto-sorted: name → version → description → ... → scripts → dependencies → devDependencies
JSON style: tabs, trailing commas, spaces around braces { "key": "value" }

Gotchas

Abbreviation rules disabled in .d.ts — declaration files follow standard conventions
.ts extensions in imports — use .js unless tsconfig has allowImportingTsExtensions: true
Markdown code blocks in skills/ directories — automatically ignored (not linted as project code)