{"id":21621,"library":"nuxt-vite","title":"nuxt-vite","description":"Nuxt-vite brings Vite's fast development experience to Nuxt 2 (nuxt >= 2.15.0 required). At version 0.3.5, it is an experimental module that replaces webpack with Vite for Nuxt 2 projects, offering significantly faster hot module replacement and dev startup. It ships TypeScript types and relies on vite-plugin-vue2. Many Nuxt modules may be incompatible; it is actively maintained by the Nuxt team on GitHub.","status":"active","version":"0.3.5","language":"javascript","source_language":"en","source_url":"https://github.com/nuxt/vite","tags":["javascript","typescript"],"install":[{"cmd":"npm install nuxt-vite","lang":"bash","label":"npm"},{"cmd":"yarn add nuxt-vite","lang":"bash","label":"yarn"},{"cmd":"pnpm add nuxt-vite","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Vite is the core bundler and dev server.","package":"vite","optional":false},{"reason":"Provides Vue 2 support for Vite, a required peer dependency.","package":"vite-plugin-vue2","optional":false},{"reason":"Nuxt 2 (>=2.15.0) is required as the framework.","package":"nuxt","optional":true}],"imports":[{"note":"Nuxt config uses ES module exports by default.","wrong":"module.exports = { buildModules: ['nuxt-vite'] }","symbol":"default export (nuxt.config)","correct":"export default { buildModules: ['nuxt-vite'] }"},{"note":"defineNuxtConfig is available only when using Nuxt Bridge or Nuxt 3, not Nuxt 2 alone.","wrong":"const { defineNuxtConfig } = require('nuxt')","symbol":"defineNuxtConfig (if using Nuxt Bridge)","correct":"import { defineNuxtConfig } from 'nuxt'\nexport default defineNuxtConfig({ buildModules: ['nuxt-vite'] })"},{"note":"Nuxt 2 configs should use the string identifier in buildModules, not require the module directly.","wrong":"const nuxtVite = require('nuxt-vite')","symbol":"require('nuxt-vite') in legacy CJS config","correct":"// Not recommended; use buildModules array with string 'nuxt-vite'"}],"quickstart":{"code":"// nuxt.config.js\nexport default {\n  buildModules: [\n    'nuxt-vite'\n  ]\n}\n\n// Then run: npm run dev","lang":"javascript","description":"Shows minimal configuration to enable Vite in a Nuxt 2 project by adding nuxt-vite to buildModules."},"warnings":[{"fix":"Check module compatibility on https://vite.nuxtjs.org/advanced/modules.","message":"Experimental module; many Nuxt modules are incompatible and may break.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Migrate to Nuxt 3 for native Vite integration.","message":"nuxt-vite is deprecated in favor of Nuxt 3's built-in Vite support.","severity":"deprecated","affected_versions":">=0.3.0"},{"fix":"Upgrade Nuxt to at least 2.15.0.","message":"Requires Nuxt >= 2.15.0; older versions will fail to load.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Replace webpack-specific configuration with Vite equivalents.","message":"Vite configuration conflicts: custom webpack loaders may not work.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Disable HMR for problematic plugins or report issues.","message":"HMR may be unstable with some Vue 2 plugins.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"npm install -D nuxt-vite or yarn add --dev nuxt-vite","cause":"nuxt-vite not installed or not added as devDependency.","error":"Cannot find module 'nuxt-vite'"},{"fix":"npm install nuxt@latest (>=2.15.0)","cause":"Incompatible Nuxt version (<2.15.0) causing missing API.","error":"TypeError: Cannot read property 'extendRoutes' of undefined"},{"fix":"npm install -D vite-plugin-vue2","cause":"Missing vite-plugin-vue2 dependency.","error":"Module './vite-plugin-vue2' not found"},{"fix":"Check https://vite.nuxtjs.org/advanced/modules for compatibility or disable the module.","cause":"Using a module that does not support Vite.","error":"Error: Vite mode is experimental and many Nuxt modules are still incompatible"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}