The Wire · Showcase
VITEPRESS FIXES SEARCH LOCALIZATION AND REWRITE HANDLING ACROSS FOUR CRITICAL PATHS
By RepoJournal · Filed · About Vue.js
VitePress shipped fixes for locale-aware search indexing, Windows drive letter normalization, and sidebar link resolution that were breaking sites using rewrites and multi-language setups.
The headline fix lands in local search: pages using rewritten paths now map to the correct locale index instead of landing in root, solving the problem for sites that keep source files outside locale directories [1]. That same rewrite system broke on Windows when Vite reported uppercase drive letters from lowercase working directories, but normalization of just the drive prefix keeps paths stable across case mismatches [2]. Sidebar links with configured base paths were getting the base applied to external URLs, which snapped them in half; that's fixed, with external links now skipping base resolution entirely [3]. A separate fix ensures heading anchors work when the included Markdown file has frontmatter by stripping it before both the heading lookup and the line slice [4]. These are all in flight but not shipped yet.
Action items
- → Watch for VitePress patch release with locale search fix before deploying multi-language sites with rewrites vuejs/vitepress [monitor]
- → If running Windows builds with VitePress rewrites, pull the drive normalization fix when available vuejs/vitepress [plan]
References
- [1] fix: index rewritten local search pages by locale ↗ vuejs/vitepress
- [2] fix(build): normalize rewrite drive letters ↗ vuejs/vitepress
- [3] fix: preserve external sidebar links with base ↗ vuejs/vitepress
- [4] fix: strip frontmatter before heading includes ↗ vuejs/vitepress
FAQ
- What changed in Vue.js on June 29, 2026?
- VitePress shipped fixes for locale-aware search indexing, Windows drive letter normalization, and sidebar link resolution that were breaking sites using rewrites and multi-language setups.
- What should Vue.js teams do about it?
- Watch for VitePress patch release with locale search fix before deploying multi-language sites with rewrites • If running Windows builds with VitePress rewrites, pull the drive normalization fix when available
- Which Vue.js repositories shipped on June 29, 2026?
- vuejs/vitepress