VitePress 1.0 replaces VuePress for docs
VitePress 1.0 replaces VuePress, powering docs for Vite, Pinia, and Vitest. It serves static HTML for SEO, then hydrates into a Vue 3 SPA with sub-100ms edits. Migrate legacy VuePress docs or choose it for new content sites.
WHY IT MATTERS: Documentation performance directly impacts developer adoption, search rankings, and support ticket volume. VitePress 1.0 is the stable successor to VuePress and already powers documentation for major ecosystems including Vite, Rollup, Pinia, VueUse, Vitest, D3, and UnoCSS. For teams running docs on legacy static site generators or struggling with slow build times and poor lighthouse scores, this release offers a production-ready migration target that balances developer experience with end-user performance without requiring a separate frontend architecture.
WHAT CHANGED: VitePress 1.0 ships as a Vite and Vue 3 based static site generator. It produces static HTML for every page at build time, ensuring fast initial loads and complete search engine optimization. After the first page loads, the site hydrates into a Vue Single Page Application, meaning subsequent navigation feels instant because the browser fetches only page content instead of performing full reloads. The framework also pre-fetches chunks for links visible in the viewport. For authors, every Markdown file is treated as a Vue Single-File Component, allowing standard Vue templating and imported components directly inside content. The development server starts instantly and reflects edits in under 100 milliseconds. The default theme is optimized for technical documentation, but the custom theme API supports blogs, portfolios, and marketing sites using the full Vite plugin ecosystem and remote data loading.
WHAT TO WATCH: If you currently maintain a VuePress site, plan a migration evaluation this quarter because VuePress is effectively succeeded by VitePress. If you are selecting a documentation stack for a new project, compare VitePress against alternatives like Docusaurus, Nextra, or Astro Starlight, noting that VitePress offers tighter Vue integration and superior SPA hydration performance through Vue compiler optimizations that separate static and dynamic content. Watch for community plugins that extend the data loading API, which enables remote data fetching and dynamic route generation at build time for use cases beyond documentation.
Source: Vue Blog
Read the original → Vue Blog
Get five bites like this every day.
Tezvyn delivers a daily feed of 60-second tech bites with quizzes to lock in what you learn.