Presets

Use one of these presets based on where Vite or Vitest mistakes are most likely to happen in your repository.

Each preset page in this section includes:

• when to use it
• the exact flat-config key
• a copy/paste configuration example
• the exact rules wired by the preset

Related guides:

• 🎯 Preset selection strategy
• 📝 Adoption checklist
• 🛠️ Rollout and fix safety

Rule matrix

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