# Introduction

There's so much here! Does that mean 3.0 is completely different, I'll have to learn the basics all over again, and migrating will be practically impossible?

We're glad you asked! The answer is no. We've gone to great lengths to ensure most of the API is the same and the core concepts haven't changed. It's long because we like to offer very detailed explanations and include a lot of examples. Rest assured, this is not something you have to read from top to bottom!

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.

# Overview

Start learning Vue 3 at Vue Mastery.

# New Features

Some of the new features to keep an eye on in Vue 3 include:

# Breaking

The following consists a list of breaking changes from 2.x:

# Removed


# Where should I start in a migration?

  1. Start by running the migration helper (still under development) on a current project. We've carefully minified and compressed a senior Vue dev into a simple command line interface. Whenever they recognize an obsolete feature, they'll let you know, offer suggestions, and provide links to more info.

  2. After that, browse through the table of contents for this page in the sidebar. If you see a topic you may be affected by, but the migration helper didn't catch, check it out.

  3. If you have any tests, run them and see what still fails. If you don't have tests, just open the app in your browser and keep an eye out for warnings or errors as you navigate around.

  4. By now, your app should be fully migrated. If you're still hungry for more though, you can read the rest of this page - or dive in to the new and improved guide from the beginning. Many parts will be skimmable, since you're already familiar with the core concepts.

# How long will it take to migrate a Vue 2.x app to 3.0?

It depends on a few factors:

  • The size of your app (small to medium-sized apps will probably be less than a day)

  • How many times you get distracted and start playing with a cool new feature. 😉  Not judging, it also happened to us while building 3.0!

  • Which obsolete features you're using. Most can be upgraded with find-and-replace, but others might take a few minutes. If you're not currently following best practices according to our styleguide, Vue 3.0 will also try harder to force you to. This is a good thing in the long run, but could also mean a significant (though possibly overdue) refactor.

# If I upgrade to Vue 3, will I also have to upgrade Vuex and Vue Router?

Yes, currently both Vuex and Vue Router are in beta

Deployed on Netlify.
Last updated: 8/10/2020, 4:03:29 PM