2020-06-30 06:50:00 +08:00
# vue-next [![beta](https://img.shields.io/npm/v/vue/next.svg)](https://www.npmjs.com/package/vue/v/next) [![CircleCI](https://circleci.com/gh/vuejs/vue-next.svg?style=svg&circle-token=fb883a2d0a73df46e80b2e79fd430959d8f2b488)](https://circleci.com/gh/vuejs/vue-next)
2019-08-25 10:37:05 +08:00
2020-09-18 13:25:53 +08:00
This is the repository for Vue 3.0.
2019-10-04 21:35:29 +08:00
2020-09-18 13:25:53 +08:00
## Quickstart
2019-10-04 21:35:29 +08:00
2020-09-18 13:25:53 +08:00
- Via CDN: `<script src="https://unpkg.com/vue@next"></script>`
- In-browser playground on [Codepen ](https://codepen.io/yyx990803/pen/OJNoaZL )
- Scaffold via [Vite ](https://github.com/vitejs/vite ):
2020-04-17 04:40:46 +08:00
2020-09-18 13:25:53 +08:00
```bash
npm init vite-app hello-vue3 # OR yarn create vite-app hello-vue3
```
2020-04-17 04:40:46 +08:00
2020-09-18 13:25:53 +08:00
- Scaffold via [vue-cli ](https://cli.vuejs.org/ ):
2020-02-19 03:56:18 +08:00
2020-09-18 13:25:53 +08:00
```bash
npm install -g @vue/cli # OR yarn global add @vue/cli
vue create hello-vue3
# select vue 3 preset
```
2020-02-19 03:56:18 +08:00
2020-09-18 13:25:53 +08:00
## Changes from Vue 2
2019-08-25 10:37:05 +08:00
2020-09-18 13:25:53 +08:00
Please consult the [Migration Guide ](https://v3.vuejs.org/guide/migration/introduction.html ).
2020-07-23 08:59:05 +08:00
2020-09-18 13:25:53 +08:00
- Note: IE11 support is still pending.
## Supporting Libraries
2021-02-04 02:25:26 +08:00
All of our official libraries and tools now support Vue 3, but most of them are still in beta status and distributed under the `next` dist tag on NPM. **We are planning to stabilize and switch all projects to use the `latest` dist tag in early 2021.**
2020-09-18 13:25:53 +08:00
### Vue CLI
As of v4.5.0, `vue-cli` now provides built-in option to choose Vue 3 preset when creating a new project. You can upgrade `vue-cli` and run `vue create` to create a Vue 3 project today.
2020-06-30 06:50:00 +08:00
### Vue Router
2020-09-18 13:25:53 +08:00
Vue Router 4.0 provides Vue 3 support and has a number of breaking changes of its own. Check out its [Migration Guide ](https://next.router.vuejs.org/guide/migration/ ) for full details.
2020-08-26 15:37:11 +08:00
- [![beta ](https://img.shields.io/npm/v/vue-router/next.svg )](https://www.npmjs.com/package/vue-router/v/next)
2021-01-05 17:37:42 +08:00
- [GitHub ](https://github.com/vuejs/vue-router-next )
2020-06-30 06:50:00 +08:00
- [RFCs ](https://github.com/vuejs/rfcs/pulls?q=is%3Apr+is%3Amerged+label%3Arouter )
### Vuex
2020-09-18 13:25:53 +08:00
Vuex 4.0 provides Vue 3 support with largely the same API as 3.x. The only breaking change is [how the plugin is installed ](https://github.com/vuejs/vuex/tree/4.0#breaking-changes ).
2020-06-30 06:50:00 +08:00
- [![beta ](https://img.shields.io/npm/v/vuex/next.svg )](https://www.npmjs.com/package/vuex/v/next)
2021-01-05 17:37:42 +08:00
- [GitHub ](https://github.com/vuejs/vuex/tree/4.0 )
2020-06-30 06:50:00 +08:00
2020-09-18 13:25:53 +08:00
### Devtools Extension
2020-06-30 06:50:00 +08:00
2020-09-18 13:25:53 +08:00
We are working on a new version of the Devtools with a new UI and refactored internals to support multiple Vue versions. The new version is currently in beta and only supports Vue 3 (for now). Vuex and Router integration is also work in progress.
2020-07-03 21:17:51 +08:00
2020-09-18 13:25:53 +08:00
- For Chrome: [Install from Chrome web store ](https://chrome.google.com/webstore/detail/vuejs-devtools/ljjemllljcmogpfapbkkighbhhppjdbg?hl=en )
2020-07-03 21:17:51 +08:00
2020-09-18 13:25:53 +08:00
- Note: the beta channel may conflict with the stable version of devtools so you may need to temporarily disable the stable version for the beta channel to work properly.
2020-07-03 21:17:51 +08:00
2020-09-18 13:25:53 +08:00
- For Firefox: [Download the signed extension ](https://github.com/vuejs/vue-devtools/releases/tag/v6.0.0-beta.2 ) (`.xpi` file under Assets)
2020-07-03 21:17:51 +08:00
2020-09-18 13:29:34 +08:00
### IDE Support
It is recommended to use [VSCode ](https://code.visualstudio.com/ ) with our official extension [Vetur ](https://marketplace.visualstudio.com/items?itemName=octref.vetur ), which provides comprehensive IDE support for Vue 3.
2020-06-30 06:50:00 +08:00
### Other Projects
2020-09-18 13:25:53 +08:00
| Project | NPM | Repo |
| --------------------- | ----------------------------- | -------------------- |
2021-01-05 17:37:42 +08:00
| @vue/babel -plugin-jsx | [![rc][jsx-badge]][jsx-npm] | [[GitHub][jsx-code]] |
| eslint-plugin-vue | [![stable][epv-badge]][epv-npm] | [[GitHub][epv-code]] |
| @vue/test -utils | [![beta][vtu-badge]][vtu-npm] | [[GitHub][vtu-code]] |
| vue-class-component | [![beta][vcc-badge]][vcc-npm] | [[GitHub][vcc-code]] |
| vue-loader | [![beta][vl-badge]][vl-npm] | [[GitHub][vl-code]] |
| rollup-plugin-vue | [![beta][rpv-badge]][rpv-npm] | [[GitHub][rpv-code]] |
2020-09-18 13:25:53 +08:00
[jsx-badge]: https://img.shields.io/npm/v/@vue/babel-plugin-jsx.svg
[jsx-npm]: https://www.npmjs.com/package/@vue/babel-plugin-jsx
[jsx-code]: https://github.com/vuejs/jsx-next
2020-07-18 02:07:33 +08:00
[vd-badge]: https://img.shields.io/npm/v/@vue/devtools/beta.svg
[vd-npm]: https://www.npmjs.com/package/@vue/devtools/v/beta
[vd-code]: https://github.com/vuejs/vue-devtools/tree/next
2020-10-06 00:02:01 +08:00
[epv-badge]: https://img.shields.io/npm/v/eslint-plugin-vue.svg
[epv-npm]: https://www.npmjs.com/package/eslint-plugin-vue
2020-04-17 04:40:46 +08:00
[epv-code]: https://github.com/vuejs/eslint-plugin-vue
2020-06-30 06:50:00 +08:00
[vtu-badge]: https://img.shields.io/npm/v/@vue/test-utils/next.svg
[vtu-npm]: https://www.npmjs.com/package/@vue/test-utils/v/next
[vtu-code]: https://github.com/vuejs/vue-test-utils-next
[jsx-badge]: https://img.shields.io/npm/v/@ant-design-vue/babel-plugin-jsx.svg
[jsx-npm]: https://www.npmjs.com/package/@ant-design-vue/babel-plugin-jsx
[jsx-code]: https://github.com/vueComponent/jsx
[vcc-badge]: https://img.shields.io/npm/v/vue-class-component/next.svg
[vcc-npm]: https://www.npmjs.com/package/vue-class-component/v/next
[vcc-code]: https://github.com/vuejs/vue-class-component/tree/next
[vl-badge]: https://img.shields.io/npm/v/vue-loader/next.svg
[vl-npm]: https://www.npmjs.com/package/vue-loader/v/next
[vl-code]: https://github.com/vuejs/vue-loader/tree/next
[rpv-badge]: https://img.shields.io/npm/v/rollup-plugin-vue/next.svg
[rpv-npm]: https://www.npmjs.com/package/rollup-plugin-vue/v/next
[rpv-code]: https://github.com/vuejs/rollup-plugin-vue/tree/next