🌉 Nuxt Bridge

Reduce the differences with Nuxt 3 and reduce the burden of migration to Nuxt 3.

Bridge is a forward-compatibility layer that allows you to experience many of the new Nuxt 3 features by simply installing and enabling a Nuxt module.

Using Nuxt Bridge, you can make sure your project is (almost) ready for Nuxt 3 and you can gradually proceed with the transition to Nuxt 3.

⚠️ Note: Nuxt Bridge provides identical features to Nuxt 3 (Nuxt 3 docs) but there are some limitations, notably that useAsyncData and useFetch composables are not available. Please read the rest of this page for details.

⚠️ Note: Nuxt Bridge does not support Internet Explorer. Supported browsers are listed at https://caniuse.com/es6-module-dynamic-import.

🌱 Note: If you're starting a fresh Nuxt project, please skip this module and directly go to the Nuxt 3 Installation.

Docs

Visit the documentation site for migration guide.

💻 Development

• Clone repository
• Ensure you have the latest LTS version of Node.js installed
• Enable Corepack using corepack enable to enable pnpm and yarn
• Install dependencies with pnpm install
• Run pnpm dev:prepare to activate passive development
• Open playground with pnpm dev

Learn more about in our documentation on how to contribute to Nuxt.

License

MIT

Changelog

v3.1.0

compare changes

🚀 Enhancements

• Port upstream dedupe options (#1082)
• Add useRequestURL to match upstream (#1110)
• Add esbuild option for webpack + typescript (#1065)

🩹 Fixes

• Change isTSX option to opt-in (#1064)
• Resolve hookable to installed version (#1086)
• Update return for useRequestEvent to include undefined (#1089)
• Prevent duplicate manifest generation (#1070)
• Support script setup and script together in webpack (#1104)
• Ignore CallExpression other than defineComponent (#1109)
• Early return from transform when no arguments (#1124)
• Align error param in showError/createError with H3 (#1127)

🏡 Chore

• Use workspace version of bridge-schema (#1068)
• Add release script (cffcd07)
• Mention contributors in release changelog/notes (977d55f)

❤️ Contributors

• Daniel Roe (@danielroe)
• Ryota Watanabe (@wattanx)