Skip to content

docs: promote Vitest as recommended test runner#2805

Merged
cexbrayat merged 2 commits intovuejs:mainfrom
mvanhorn:docs/promote-vitest
Apr 7, 2026
Merged

docs: promote Vitest as recommended test runner#2805
cexbrayat merged 2 commits intovuejs:mainfrom
mvanhorn:docs/promote-vitest

Conversation

@mvanhorn
Copy link
Copy Markdown
Contributor

@mvanhorn mvanhorn commented Apr 3, 2026

Summary

Updates the installation docs to recommend Vitest over Jest for Vue projects.

Changes

docs/installation/index.md:

  • Added a "Vitest (Recommended)" section with install command and link to the Vitest getting started guide
  • Moved Jest to a secondary "Jest" subsection as an alternative
  • Removed outdated references to vue-jest alpha status and the vtu-next-demo repo

Why Vitest

Vue CLI and create-vue both use Vite. Vitest works with Vite out of the box with no transform configuration needed for .vue files. The current docs recommend Jest as "the easiest way" which hasn't been accurate since the Vue ecosystem moved to Vite.

Closes #2531

This contribution was developed with AI assistance (Claude Code).

Update the installation docs to recommend Vitest over Jest for Vue
projects. Vitest is built on Vite, supports .vue files without
additional transform configuration, and provides a faster testing
experience with native ESM support.

Jest instructions are kept as an alternative for webpack-based
projects.

Closes vuejs#2531
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 3, 2026

Deploy Preview for vue-test-utils-docs ready!

Name Link
🔨 Latest commit 2c2964e
🔍 Latest deploy log https://app.netlify.com/projects/vue-test-utils-docs/deploys/69cff40a7c17740008ed3cc6
😎 Deploy Preview https://deploy-preview-2805--vue-test-utils-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Member

@cexbrayat cexbrayat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea! 👍

Would you mind updating the docs in other languages as well (your favorite LLM should be able to do the job, and we'll review)?

Apply the same Vitest promotion changes to the fr and zh translations,
matching the structure of the English installation page.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@mvanhorn
Copy link
Copy Markdown
Contributor Author

mvanhorn commented Apr 3, 2026

Done - updated both the French and Chinese installation pages to match the English version (Vitest recommended section + Jest as alternative).

@cexbrayat cexbrayat merged commit 2257f0c into vuejs:main Apr 7, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Promote Vitest at documentation

3 participants