nuxt-vite

library0.3.5jsnpmunverified

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.

web-framework devops

npm install nuxt-vite

github ↗package ↗

INSTALL

IMPORT

SIG · NUXT-VITE

nuxt-vite

web-frameworkjavascriptv0.3.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default export (nuxt.config)

✓ export default { buildModules: ['nuxt-vite'] }

✗ module.exports = { buildModules: ['nuxt-vite'] }

Nuxt config uses ES module exports by default.

defineNuxtConfig (if using Nuxt Bridge)

✓ import { defineNuxtConfig } from 'nuxt' export default defineNuxtConfig({ buildModules: ['nuxt-vite'] })

✗ const { defineNuxtConfig } = require('nuxt')

defineNuxtConfig is available only when using Nuxt Bridge or Nuxt 3, not Nuxt 2 alone.

require('nuxt-vite') in legacy CJS config

✓ // Not recommended; use buildModules array with string 'nuxt-vite'

✗ const nuxtVite = require('nuxt-vite')

Nuxt 2 configs should use the string identifier in buildModules, not require the module directly.

Shows minimal configuration to enable Vite in a Nuxt 2 project by adding nuxt-vite to buildModules.

// nuxt.config.js export default { buildModules: [ 'nuxt-vite' ] } // Then run: npm run dev

Debug

Known issues

breakingExperimental module; many Nuxt modules are incompatible and may break.

fix

Check module compatibility on https://vite.nuxtjs.org/advanced/modules.

affects: >=0.0.0

deprecatednuxt-vite is deprecated in favor of Nuxt 3's built-in Vite support.

fix

Migrate to Nuxt 3 for native Vite integration.

affects: >=0.3.0

gotchaRequires Nuxt >= 2.15.0; older versions will fail to load.

fix

Upgrade Nuxt to at least 2.15.0.

affects: >=0.0.0

gotchaVite configuration conflicts: custom webpack loaders may not work.

fix

Replace webpack-specific configuration with Vite equivalents.

affects: >=0.0.0

gotchaHMR may be unstable with some Vue 2 plugins.

fix

Disable HMR for problematic plugins or report issues.

affects: >=0.0.0

Errors

Common errors & fixes

Cannot find module 'nuxt-vite'

nuxt-vite not installed or not added as devDependency.

fix

npm install -D nuxt-vite or yarn add --dev nuxt-vite

TypeError: Cannot read property 'extendRoutes' of undefined

Incompatible Nuxt version (<2.15.0) causing missing API.

fix

npm install nuxt@latest (>=2.15.0)

Module './vite-plugin-vue2' not found

Missing vite-plugin-vue2 dependency.

fix

npm install -D vite-plugin-vue2

Error: Vite mode is experimental and many Nuxt modules are still incompatible

Using a module that does not support Vite.

fix

Check https://vite.nuxtjs.org/advanced/modules for compatibility or disable the module.

Upgrade

Version history

0.3.5latest on npm

Audit

Dependencies

viterequiredVite is the core bundler and dev server.

vite-plugin-vue2requiredProvides Vue 2 support for Vite, a required peer dependency.

nuxtoptionalNuxt 2 (>=2.15.0) is required as the framework.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/nuxt/vite ↗

packagehttps://www.npmjs.com/package/nuxt-vite ↗