Registry / testing / eslint-config-vuetify

eslint-config-vuetify

library4.6.2jsnpmunverified

An opinionated ESLint flat config for Vuetify and Vue.js projects, maintained by the Vuetify team. Current stable version is 4.6.2 (March 2025). Actively maintained with monthly releases. Supports ESLint 9+ (including v10), TypeScript, Vue 3, Vitest, Jest, and accessibility rules. Automatically detects project features like TypeScript and Vitest, with zero-config setup. Ships TypeScript types for full IDE support. Key differentiator: official Vuetify linting config, flat config only (no legacy .eslintrc), and integrates vuejs-accessibility and no-only-tests plugins out of the box.

testing

npm install eslint-config-vuetify

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESLINT-CONFIG-VUET

eslint-config-vuetify

testingjavascriptv4.6.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (vuetify function)

✓ import vuetify from 'eslint-config-vuetify'

✗ const { vuetify } = require('eslint-config-vuetify')

Package is ESM-only; default export is a factory function that returns an ESLint flat config array. CommonJS require will fail.

TypeScript types

✓ import type { VuetifyConfig } from 'eslint-config-vuetify'

TypeScript types are shipped but not publicly documented; use at your own risk.

Calling with additional config

✓ export default vuetify({ vue: true }, { rules: {} })

✗ export default vuetify({ rules: {} })

Second and subsequent arguments are merged as additional flat config objects. First argument is options object.

Shows minimal flat config setup with vue and TypeScript enabled, using the default export factory function.

// Install: npm install -D eslint-config-vuetify // eslint.config.js import vuetify from 'eslint-config-vuetify' export default vuetify({ vue: true, ts: { preset: 'all', }, }) // This config automatically detects TypeScript, Vitest, and Jest. The vuetify() call returns an array of flat configs.

Debug

Known issues

breakingVersion 4.x requires ESLint 9+ with flat config only. Legacy .eslintrc is not supported.

fix

Migrate to eslint.config.js flat config and upgrade ESLint to ^9.5.0 or ^10.0.0.

affects: >=4.0.0

breakingThe package is ESM-only. CommonJS require() will fail with ERR_REQUIRE_ESM.

fix

Use import syntax in the config file, or rename config file to .mjs or set type: module in package.json.

affects: >=4.0.0

deprecatedVersion 3.x is no longer maintained. Users should upgrade to v4 for ESLint 9+ support.

fix

Update to version 4.x and migrate to flat config.

affects: >=3.0.0 <4.0.0

gotchaThe vuetify() factory returns an array, not a single config object. Spreading or assigning incorrectly may break the config.

fix

Use export default vuetify(...) as shown in docs. Do not spread the result.

affects: >=4.0.0

gotchaPeer dependencies must be installed manually. Missing peer deps can cause runtime errors or missing rules.

fix

Install all peer dependencies: eslint, @vitest/eslint-plugin, eslint-plugin-jest, eslint-plugin-no-only-tests, eslint-plugin-vuejs-accessibility.

affects: >=4.0.0

gotchaAutomatic detection may fail in monorepos if the root package.json does not contain all tools. Explicit configuration is required.

fix

Declare vue, ts, vitest, jest options explicitly when using workspaces.

affects: >=4.0.0

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module /path/node_modules/eslint-config-vuetify/index.js not supported.

Using CommonJS require() on an ESM-only package.

fix

Convert your eslint config to ESM by renaming to .mjs or setting type:module in package.json, then use import vuetify from 'eslint-config-vuetify'.

ESLint couldn't find the config 'eslint-config-vuetify'. Check that the package is installed.

Package not installed or improperly resolved.

fix

Run npm install -D eslint-config-vuetify@latest and ensure it's in devDependencies.

Failed to load plugin 'eslint-plugin-vuejs-accessibility': Cannot find module 'eslint-plugin-vuejs-accessibility'

Missing peer dependency.

fix

Install the missing peer: npm install -D eslint-plugin-vuejs-accessibility.

TypeError: vuetify is not a function

Default import is a factory function, not a config object. Often caused by spreading the import incorrectly.

fix

Use export default vuetify() not export default ...vuetify.

Parsing error: The keyword 'import' is reserved

Using import in a CommonJS file without ESM support.

fix

Rename file to .mjs, or add type:module to package.json.

Upgrade

Version history

4.6.2latest on npm

Audit

Dependencies

@vitest/eslint-pluginoptionalPeer dependency for Vitest rule support (detected automatically)

eslintrequiredPeer dependency - requires ESLint ^9.5.0 || ^10.0.0

eslint-plugin-jestoptionalPeer dependency for Jest rule support (detected automatically)

eslint-plugin-no-only-testsoptionalPeer dependency for no-only-tests rule

eslint-plugin-vuejs-accessibilityoptionalPeer dependency for Vue accessibility rules

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/vuetifyjs/eslint-config-vuetify ↗

packagehttps://www.npmjs.com/package/eslint-config-vuetify ↗

homepagehttps://vuetifyjs.com ↗