eslint-plugin-vite

ESLint rules for Vite, Vitest, and Vitest bench configuration and runtime patterns.

Why this plugin exists

Vite and Vitest both rely on static conventions that are easy to violate accidentally:

• config helpers such as defineConfig(...) and defineWorkspace(...)
• client-safe env access through import.meta.env
• static glob imports through import.meta.glob(...)
• workspace and benchmark structure in Vitest

eslint-plugin-vite turns those conventions into reviewable lint rules.

Installation

npm install --save-dev @typpi/eslint-plugin-vite eslint

Quick start

import vite from "@typpi/eslint-plugin-vite";

export default [vite.configs.recommended];

Available presets

• vite.configs.recommended
• vite.configs.strict
• vite.configs.all
• vite.configs.configs
• vite.configs.client
• vite.configs.vitest
• vite.configs["vitest-bench"]

Common compositions

App code that uses import.meta.env and import.meta.glob

import vite from "@typpi/eslint-plugin-vite";

export default [vite.configs.recommended, vite.configs.client];

Vitest workspaces in a monorepo

import vite from "@typpi/eslint-plugin-vite";

export default [vite.configs.recommended, vite.configs.vitest];

Dedicated benchmark suites

import vite from "@typpi/eslint-plugin-vite";

export default [vite.configs.recommended, vite.configs["vitest-bench"]];

Documentation

• Rule overview
• Getting started
• Preset reference
• 📝 Adoption checklist

Rules

• Fix legend:
  • 🔧 = autofixable
  • 💡 = suggestions available
  • — = report only
• Preset key legend:
  • 🟡 — vite.configs.recommended
  • 🔴 — vite.configs.strict
  • 🟣 — vite.configs.all
  • ⚙️ — vite.configs.configs
  • 🌐 — vite.configs.client
  • 📚 — vite.configs.vitepress
  • 🧪 — vite.configs.vitest
  • 👟 — vite.configs["vitest-bench"]

Rule	Fix	Preset key
vite/config-require-define-config	—	🟡 🔴 🟣 ⚙️ 📚 🧪
vite/import-meta-glob-literal	—	🟡 🔴 🟣 🌐 📚
vite/no-deprecated-config-options	—	🔴 🟣 ⚙️
vite/no-disabled-vitest-isolation	—	🔴 🟣 ⚙️ 🧪
vite/no-disabled-vitest-typecheck	—	🔴 🟣 ⚙️ 🧪
vite/no-dynamic-import-meta-env-access	—	🟡 🔴 🟣 🌐 📚
vite/no-empty-env-prefix	—	🟡 🔴 🟣 ⚙️ 📚
vite/no-empty-optimize-deps-exclude	—	🔴 🟣 ⚙️
vite/no-empty-optimize-deps-include	—	🔴 🟣 ⚙️
vite/no-empty-ssr-external	—	🔴 🟣 ⚙️
vite/no-empty-ssr-noexternal	—	🔴 🟣 ⚙️
vite/no-empty-vitest-bench-exclude	—	🔴 🟣 ⚙️ 👟
vite/no-empty-vitest-bench-include	—	🔴 🟣 ⚙️ 👟
vite/no-empty-vitest-coverage-include	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-coverage-reporter	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-coverage-reports-directory	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-exclude	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-include	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-project-exclude	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-project-name	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-vitest-projects	—	🔴 🟣 ⚙️ 🧪
vite/no-empty-worker-plugins	—	🔴 🟣 ⚙️
vite/no-implicit-config-flags	—	🔴 🟣 ⚙️
vite/no-import-meta-env-in-config	—	🟡 🔴 🟣 ⚙️ 📚 🧪
vite/no-mixed-defineworkspace-and-test-projects	—	🔴 🟣 ⚙️ 🧪
vite/no-mixed-test-and-bench-apis	—	🟡 🔴 🟣 🧪 👟
vite/no-pass-with-no-tests	—	🔴 🟣 ⚙️ 🧪
vite/no-relative-resolve-alias	—	🟡 🔴 🟣 ⚙️
vite/no-restricted-import-meta-env	—	🔴 🟣 🌐 📚
vite/no-unsafe-server-options	—	🔴 🟣 ⚙️
vite/no-unsafe-vitest-flags	—	🔴 🟣 ⚙️ 🧪
vite/no-unsupported-project-options	—	🟡 🔴 🟣 🧪
vite/no-vitepress-empty-head	—	🔴 🟣 📚
vite/no-vitepress-empty-theme-config	—	🔴 🟣 📚
vite/no-vitest-bail-and-retry-conflict	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-coverage-all-false	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-coverage-clean-false	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-coverage-enabled-false-with-thresholds	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-coverage-reporter-text-only	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-coverage-skip-full-false-in-strict	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-coverage-temp-dir-in-repo-root	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-default-cache-dir-in-monorepo	—	🔴 🟣 🧪 👟
vite/no-vitest-env-leakage-combo	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-file-parallelism-disabled	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-globals	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-max-workers-zero	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-min-workers-greater-than-max-workers	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-single-thread-pool-by-default	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-timeout-triplet-mismatch	—	🔴 🟣 🧪 👟
vite/no-vitest-ui-in-config	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-unstub-envs-false	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-unstub-globals-false	—	🔴 🟣 ⚙️ 🧪
vite/no-vitest-watch-in-config	—	🔴 🟣 ⚙️ 🧪
vite/no-zero-vitest-slow-test-threshold	—	🔴 🟣 ⚙️ 🧪
vite/no-zero-vitest-timeout	—	🔴 🟣 ⚙️ 🧪
vite/prefer-define-project	—	🔴 🟣 🧪
vite/prefer-vitest-restore-mocks	—	🔴 🟣 ⚙️ 🧪
vite/require-inline-project-name	—	🟡 🔴 🟣 🧪
vite/require-vitepress-clean-urls-explicit	—	🔴 🟣 📚
vite/require-vitepress-title-or-titletemplate	—	🔴 🟣 📚
vite/require-vitest-coverage-provider-when-enabled	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-coverage-reporter-when-enabled	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-coverage-reports-directory	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-coverage-thresholds-when-enabled	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-environment-match-globs	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-explicit-environment	—	🔴 🟣 🧪 👟
vite/require-vitest-mock-reset-policy	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-sequence-seed-when-shuffle	—	🔴 🟣 ⚙️ 🧪
vite/require-vitest-slow-test-threshold	—	🔴 🟣 🧪 👟
vite/require-vitest-timeout-triplet	—	🔴 🟣 🧪 👟
vite/require-vitest-typecheck-tsconfig	—	🔴 🟣 ⚙️ 🧪
vite/workspace-unique-project-name	—	🟡 🔴 🟣 🧪

Scope notes

• This plugin is flat-config-first.
• Current rules do not require type-aware ESLint setup.
• The focus is Vite and Vitest behavior, not framework-specific UI rules.

License

MIT