Vuepress: Vue 3 support

Created on 3 Aug 2020 · 10Comments · Source: vuejs/vuepress

Feature request

What problem does this feature solve?

As far as I can tell, Vue 2 and 3 are not compatible, i.e. you cannot bundle a Vue 2 component using Rollup and then consume it from a Vue 3 component. This means component libraries that document their components using Vuepress won't be able to upgrade to Vue 3 until Vuepress supports it.

Are you willing to work on this yourself?

I'm not super familiar with Vuepress, but I'm happy to help. The reason I'm asking is because I would like to upgrade a Vue project I work on to Vue 3 as soon as it's released, but that entails upgrading its dependencies first. One of those dependencies is a component library that uses Vuepress for its documentation, so they can't upgrade until Vuepress does.

Is there an existing branch where work on Vue 3 compatibility has been started? If not, can one be created so we can open pull requests to it?

question or discussion vue-3-support

Source

vvanpo

👀2 👍1

Most helpful comment

FYI, currently we have an experimental prototype for vue 3.

https://github.com/vuepress/vuepress-next

It's a entirely refactored version of vuepress, and may or may not be the next major version.

meteorlxy on 6 Aug 2020

👍7 👀4

All 10 comments

As far as I can tell, Vue 2 and 3 are not compatible

Where did you read this?

If you read this guide you will find following snippets:

We've gone to great lengths to ensure most of the API is the same and the core concepts haven't changed.

Possibly the biggest change is our new Composition API, which is entirely additive- the previous Options API will continue to be supported, as the Composition API is an advanced feature.

gabrielwillemann on 3 Aug 2020

@gabrielwillemann I didn't read it, I've tried it. The APIs for .vue files themselves might be somewhat similar, but this is not at all true for compiled files. The compiled render functions have entirely different APIs, for example.

vvanpo on 3 Aug 2020

👍4

There are also 25 official breaking changes in Vue 3: https://github.com/vuejs/rfcs/issues?q=is%3Aclosed+label%3A3.x+label%3A%22breaking+change%22+

Some of these, like the functional components API, are impossible to make work in both Vue 2 and 3. Global mounting using createApp is another example of this.

I don't think any application or library of sufficient size (or maybe just any, period) will be able to support both Vue 2 and 3 simultaneously.

vvanpo on 3 Aug 2020

Another reason to upgrade!: https://github.com/vuejs/vue-test-utils-next/issues/171#issuecomment-669631152

@ulivz can we refresh the next branch so that it matches master, and then we can start opening PRs against it?

vvanpo on 6 Aug 2020

@vvanpo As of right now, we are currently seeing how the status of VitePress goes for Vue 3 support. Once that is more stable, we'll have more official announcements regarding Vue 3 support for VuePress. Hope this helps!