VitePress
Discouraged
Not our default choice. We recommend Docusaurus or Astro Starlight for documentation sites.
What is it
VitePress is a Vue-powered static site generator designed for documentation, built on Vite by the Vue/Vite team (Evan You). It provides a fast dev experience, Markdown-based authoring with Vue components, built-in search, and a clean default theme. There's nothing wrong with VitePress itself — it's a solid, well-maintained tool.
Why it's not our default
- Vue dependency — we standardize on React. Adopting VitePress for docs means introducing Vue into the stack, creating a split ecosystem and additional tooling overhead.
- We already have two recommended doc frameworks — Docusaurus for React-based documentation sites (it powers this Web Hub) and Astro Starlight for zero-JS, Astro-based docs. A third option adds decision fatigue without clear benefit.
- Fewer Aliz developers with Vue experience — VitePress customization requires Vue knowledge, which limits who can contribute to and maintain the site.
When it makes sense
- Client requirement or existing VitePress site — if the client already runs VitePress or specifically requests it.
- Team already has Vue expertise and the docs site is self-contained — if the team knows Vue well and the documentation site won't need to share components or infrastructure with React-based projects.
Alternative
- Docusaurus — React-based, rich plugin ecosystem, powers the Aliz Web Hub.
- Astro Starlight — zero-JS by default, Astro-based, excellent performance.