nuxt-eslint-skilld

name	nuxt-eslint-skilld
description	ALWAYS use when writing code importing "@nuxt/eslint". Consult for debugging, best practices, or modifying @nuxt/eslint, nuxt/eslint, nuxt eslint, eslint.
metadata	{"version":"1.16.0","generated_by":"Anthropic · Haiku 4.5","generated_at":"2026-06-25T00:00:00.000Z"}

nuxt/eslint @nuxt/eslint@1.16.0

Tags: next: 0.3.0-beta.10, latest: 1.16.0

References: package.json • README • Docs • Issues • Discussions

Search

Use skilld search "query" -p @nuxt/eslint instead of grepping .skilld/ directories. Run skilld search --guide -p @nuxt/eslint for full syntax, filters, and operators.

API Changes

This section documents version-specific API changes in @nuxt/eslint v1.16.0.

• BREAKING: @nuxtjs/eslint-module functionality merged into @nuxt/eslint via checker option — replaces module with @nuxt/eslint and options under eslint.checker source

• NEW: eslint:config:addons hook — register custom ESLint config integrations before config generation source

• NEW: features.tooling option (experimental) — module authors can enable unicorn, regexp and jsdoc rules for library/module best practices source

• NEW: features.typescript.tsconfigPath option — enable type-aware ESLint rules for TypeScript and Vue files source

• NEW: devtools option in config — customize ESLint Config Inspector integration in Nuxt DevTools with enabled (bool/'lazy') and port settings source

• NEW: configType: 'eslintrc' option in checker — run legacy .eslintrc config mode in dev server checker if needed source

• NEW: FlatConfigComposer chainable API — returns extended API with .prepend(), .override(), and other composition methods source

• NEW: config.autoInit option — disable auto-generation of eslint.config.mjs on server start (default: true) source

• NEW: config.standalone: false option — disable default JS/TS/Vue plugin setup to use custom config presets source

• NEW: config.stylistic option — enable and customize ESLint Stylistic rules with indent, semi, and other settings source

• NEW: checker: true option — enable optional dev server ESLint checker integration with vite-plugin-eslint2 or eslint-webpack-plugin source

• NEW: checker.lintOnStart option — lint files on dev server startup (default: true) source

• NEW: checker.fix option — run eslint --fix during dev server checks (default: false) source

• NEW: nuxt/prefer-import-meta rule — enforces import.meta.client/import.meta.server over process.client/process.server source

• NEW: createConfigForNuxt() factory function — creates project-aware ESLint flat config for Nuxt with chainable composition source

Also changed: defineFlatConfigs() utility · resolveOptions() for config resolution · .override() method for rule customization · flat config format as default (ESLint 8.45.0+) · legacy @nuxtjs/eslint-config packages in maintenance mode

Best Practices

• Start new Nuxt projects with the @nuxt/eslint module using npx nuxi module add eslint — it auto-generates project-aware flat config and includes DevTools integration, making it significantly easier than manual setup source

• Always use ESLint flat config format (supported since v8.45.0) — legacy .eslintrc configuration is not supported by this module and you should migrate to ensure future-proof setup source

• Install TypeScript as a dev dependency when using @nuxt/eslint with TypeScript — the module requires it for type inference and proper IDE support source

• Pass external ESLint configs inside an array when composing with withNuxt() — non-iterable single config objects cause Symbol.iterator errors; wrap each external config like withNuxt([unocss, { rules: {...} }]) source

• Create ignores as a separate config object without a name property to ensure they work correctly — named ignores may not function in ESLint flat config composition source

• Use .prepend() to add ignores before Nuxt rules when they need priority, ensuring patterns are evaluated before Nuxt's built-in configurations source

• Enable stylistic rules via the eslint.config.stylistic option in nuxt.config.ts if you prefer ESLint over Prettier for formatting — this integrates ESLint Stylistic rules directly source

• Set config.standalone: false when merging with other config presets like @antfu/eslint-config — this prevents duplicate plugin conflicts and allows your preset to handle base rules source

• Configure languageOptions.parserOptions.project to enable type-aware TypeScript rules like @typescript-eslint/no-floating-promises — without this, type-requiring rules fail with parser configuration errors source

// Use .prepend() for type-aware rule setup
export default withNuxt().prepend({
  languageOptions: {
    parserOptions: { project: "./tsconfig.json" }
  },
  rules: { "@typescript-eslint/no-floating-promises": "error" }
})

• Use the Nuxt DevTools ESLint Config Inspector to visually inspect and debug resolved flat config — this eliminates guesswork when composing complex configurations source

• In monorepo setups, export both withNuxt config (for Nuxt apps) and createConfigForNuxt config (for non-Nuxt packages) from a shared config package — this lets each package use the appropriate variant without re-implementation source

• Disable auto-init only if you are managing eslint.config.mjs manually or in CI pipelines — set config.autoInit: false to prevent automatic generation on server start source

• Chain FlatConfigComposer methods (.prepend(), .override(), .append()) to customize ESLint config — avoid rewriting the entire config; targeted mutations are safer and more maintainable source