FredKSchott
commented
3 years ago exciting stuff! Just saw your performance numbers on Twitter, looks super promising.
These comparisons mainly exist for users who are looking to compare Astro to existing solutions. Vitepress downloads seem small (esp. compared to Vuepress) and it doesn't look like Vitepress is claiming to be ready for production usage yet. For ex, messages like this at the top of the README:
🔥 Note this is early WIP! Currently the focus is on making Vite stable and feature complete first. It is not recommended to use this for anything serious yet.
For now, I'm happy to add a note to the Vuepress section about Vitepress as the more modern alternative on the way. And then once Vitepress is considered more stable and production ready in a few weeks/months we can look into switching the section over entirely.
yyx990803
First of all, great work on Astro! I stumbled upon a comparison vs VuePress in the docs. Since VuePress v1 is a bit outdated, I want to suggest updating the comparison to target VitePress instead.
VitePress is the spiritual successor to VuePress. It replaces VuePress' Vue 2 + webpack internals with Vue 3 + Vite, and adds a number of production improvements. Most notably, it supports mixing Vue components in markdown with partial hydration (for the markdown part). It loads a lightweight Vue application upfront in return for faster, SPA-style subsequent navigations.
Vite's docs is built with VitePress, we are also in the process of rebuilding the Vue documentation with VitePress.
Also note that although the default theme is designed for documentation, both VuePress and VitePress actually support arbitrary custom themes using Vue. As an example, the Vue blog is built with VitePress and a custom blog theme.