🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

Evan You cab9541ffd refactor(compiler-sfc): improve TLA codegen 4 lat temu
.github f243d2fbdc ci: lock node version to 16.8 4 lat temu
.vscode b015892de6 workflow: cross platform vscode jest debugging (#414) 5 lat temu
packages cab9541ffd refactor(compiler-sfc): improve TLA codegen 4 lat temu
scripts fb43aab117 chore: remove wrongly placed type casts 4 lat temu
test-dts 4178d5d7d9 fix(type): fix prop type infer (#4530) 4 lat temu
.eslintrc.js db8dc753c0 feat(experimental): standalone ref transform 4 lat temu
.gitignore 0478ca4cdb chore: add the yarn error log file to git ignore (#150) 6 lat temu
.prettierrc 69344ff1ae feat(types): map declared emits to onXXX props in inferred prop types (#3926) 4 lat temu
CHANGELOG.md 781d2d4d58 release: v3.2.11 4 lat temu
LICENSE 34989ef7fe chore: license 6 lat temu
README.md 1015700e1e docs: update vite init command (#4176) [ci skip] 4 lat temu
api-extractor.json e4dc03a8b1 feat(types): adjust type exports for manual render function and tooling usage 5 lat temu
jest.config.js b49f446ad0 chore(deps): update jest to v27 (#4472) 4 lat temu
package.json 781d2d4d58 release: v3.2.11 4 lat temu
rollup.config.js 22a9b3711c build: fix compat build exports (again) 4 lat temu
tsconfig.json 2788154f77 fix(build): fix generated code containing unprocessed class field syntax 4 lat temu
yarn.lock a5f1e679e7 chore(sfc-playground): dark mode 4 lat temu

README.md

vue-next npm build status

This is the repository for Vue 3.0.

Quickstart

  • Via CDN: <script src="https://unpkg.com/vue@next"></script>
  • In-browser playground on Codepen
  • Scaffold via Vite:

    # npm 6.x
    npm init vite@latest my-vue-app --template vue
    # npm 7+, extra double-dash is needed:
    npm init vite@latest my-vue-app -- --template vue
    # yarn
    yarn create vite my-vue-app --template vue
    
  • Scaffold via vue-cli:

    npm install -g @vue/cli # OR yarn global add @vue/cli
    vue create hello-vue3
    # select vue 3 preset
    

Changes from Vue 2

Please consult the Migration Guide.

Also note: Vue 3 does not support IE11 (RFC | Discussion).

Supporting Libraries

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.

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.

Vue Router

Vue Router 4.0 provides Vue 3 support and has a number of breaking changes of its own. Check out its Migration Guide for full details.

Vuex

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.

Devtools Extension

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.

IDE Support

It is recommended to use VSCode. There are currently two viable extensions for Single-File Components (SFCs) support:

  • Vetur (recommended if you are used to Vetur features)
  • Volar (recommended if using TypeScript with SFCs, or <script setup> syntax)

TypeScript Support

  • All Vue 3 packages ship with types.
  • vue-tsc perform TypeScript type checks / diagnostics on Vue SFCs via the command line.
  • vue-dts-gen: generate TypeScript definitions from Vue SFCs.

Other Projects

Project NPM Repo
@vue/babel-plugin-jsx rc [GitHub]
eslint-plugin-vue stable [GitHub]
@vue/test-utils beta [GitHub]
vue-class-component beta [GitHub]
vue-loader beta [GitHub]
rollup-plugin-vue beta [GitHub]