Transitioning to Vue.js 3.x

BootstrapVue evolves with @vue-compat!

With the release of v2.23.0, you can begin using BootstrapVue with the migration build of Vue.js 3.

While @vue/compat can assist with simple migrations, it is not intended for long-term use. We highly recommend migrating to BootstrapVueNext, a complete rewrite that supports Bootstrap v5 and fully utilizes Vue.js 3's capabilities.

Important Limitations

@vue-compat support is currently limited to the { MODE: 2 } configuration for both the compiler and Vue.js. For more details, refer to the compat configuration section of the migration guide.

This means that while you can configure individual components with { compatConfig: { MODE: 3 }}, you should maintain global configuration in legacy mode to ensure all BootstrapVue functions operate correctly.

<template>...</template>
<script>
export default {
  data() { /* ... */ },

  // Disable all Vue.js 2 legacy features for your component
  compatConfig: { MODE: 3 }

 // ... rest of your component configuration ... 
}
</script>

Getting Started

Follow the upgrade workflow to configure your application.
Upgrade to bootstrap-vue v2.23.0 or higher.
Ensure you are using Bootstrap v4.

For a reference implementation or to report issues with @vue/compat, you can use this sandbox.