Join the Nuxt Team at Frontend Nation 4-7 June.


ESLint module for Nuxt


npm versionnpm downloadsGithub Actions CICodecovLicense

ESLint module for Nuxt

📖 Release Notes

Note: This branch is for Nuxt 3 or Nuxt Bridge compatible module. Checkout the nuxt2 branch for Nuxt 2 support.


You need to ensure that you have eslint >= 7 installed:

With pnpm

pnpm add -D eslint

Or, with yarn

yarn add -D eslint

Or, with npm

npm install -D eslint


  1. Add @nuxtjs/eslint-module dependency to your project

With pnpm

pnpm add -D @nuxtjs/eslint-module

Or, with yarn

yarn add -D @nuxtjs/eslint-module

Or, with npm

npm install -D @nuxtjs/eslint-module
  1. Add @nuxtjs/eslint-module to the modules section of nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    // Simple usage

    // With options
    ['@nuxtjs/eslint-module', { /* module options */ }]

Using top level options

export default defineNuxtConfig({
  modules: [
  eslint: {
    /* module options */


You can pass eslint options.

Note that the config option you provide will be passed to the ESLint class. This is a different set of options than what you'd specify in package.json or .eslintrc. See the eslint docs for more details.


  • Type: Boolean
  • Default: true

Note: The cache is enabled by default to decrease execution time.


  • Type: String|Array[String]
  • Default: [nuxt.options.srcDir.'/**/*.{js,jsx,ts,tsx,vue}']

Specify directories, files, or globs.


  • Type: Array[String]
  • Default: ['**/node_modules/**', nuxt.options.buildDir]

Specify the files and/or directories to exclude.


  • Type: String
  • Default: eslint

Path to eslint instance that will be used for linting.


  • Type: String|Function
  • Default: 'stylish'

Accepts a function that will have one argument: an array of eslint messages (object). The function must return the output as a string. You can use official eslint formatters.


  • Type: Boolean
  • Default: true

Check all matching files on project startup, too slow, turn on discreetly.


  • Type: Boolean
  • Default: true

The warnings found will be printed.


  • Type: Boolean
  • Default: true

The errors found will be printed.


  • Type: Boolean
  • Default: false

Will cause the module build to fail if there are any warnings, based on emitWarning.


  • Type: Boolean
  • Default: false

Will cause the module build to fail if there are any errors, based on emitError.


You can contribute to this module online with CodeSandBox:

Edit @nuxtjs/robots

Or locally:

  1. Clone this repository
  2. Install dependencies using pnpm install
  3. Prepare development server using pnpm dev:prepare
  4. Build module using pnpm build
  5. Launch playground using pnpm dev


MIT License

Copyright (c) Nuxt Community