What's new in version 2.0?

[alephpi]

As a user since 1.0 beta, I'm just curious about why vitepress decides to make a major update? Is there anything super cool to come that justifies the migration from 1 to 2?

[jgaehring]

Version 2 is still in alpha, so I don't think migrating is necessarily recommended, certainly not for production, unless you're willing to take on the burden of trouble-shooting breaking changes, implementing and maintaining your own workarounds/patches, etc.

If you're still inclined, the best place to start is the CHANGELOG.md. You'll have to comb through each release one by one and evaluate the breaking changes and what new features are introduced, but it's pretty thorough from what I can tell (I started a new branch to try upgrading my own site, going through the alphas one by one, but didn't get too far). Hopefully this will be consolidated into an official migration guide once a general release for v2 comes out, which is another good reason to wait, imo.

My gloss on it is a lot of the changes have to do with upgrades to the underlying Vite engine. You'll see that v2.0.0-alpha.1, which is almost a year old now, first upgraded from Vite 5 (as in v1.6.4) to Vite 6, then as of 2 weeks ago, v2.0.0-alpha.18 upgraded to Vite 8. Someone more knowledgeable should correct me, but I think those represent the biggest changes, though there are certainly additions to the theming API and other features/changes too.