{"id":20245,"library":"nuxt-webpack-optimisations","title":"Nuxt Webpack Optimisations","description":"Nuxt.js module (v2.2.8) that automatically applies a set of webpack optimisations to make builds faster and smaller. Provides sensible defaults for production builds, including code splitting, minification, caching, and loader tweaks. Extends Nuxt 2's webpack configuration with minimal configuration. Actively maintained, with support for Nuxt 2.6+ and webpack 4/5. Distinct from other optimisation modules by focusing on zero-config defaults and safety (risky optimisations disabled by default).","status":"active","version":"2.2.8","language":"javascript","source_language":"en","source_url":"https://github.com/harlan-zw/nuxt-webpack-optimisations","tags":["javascript","nuxt","performance","build","webpack","typescript"],"install":[{"cmd":"npm install nuxt-webpack-optimisations","lang":"bash","label":"npm"},{"cmd":"yarn add nuxt-webpack-optimisations","lang":"bash","label":"yarn"},{"cmd":"pnpm add nuxt-webpack-optimisations","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for webpack optimisations","package":"webpack","optional":false}],"imports":[{"note":"ESM-only; CommonJS require is not supported for Nuxt configs.","wrong":"const { defineNuxtConfig } = require('nuxt/config')","symbol":"defineNuxtConfig","correct":"import { defineNuxtConfig } from 'nuxt/config'"},{"note":"Default export; the module is used in nuxt.config.js buildModules array. CJS require works in Nuxt 2 but ESM is recommended.","wrong":"const nuxtWebpackOptimisations = require('nuxt-webpack-optimisations')","symbol":"nuxtWebpackOptimisations","correct":"import nuxtWebpackOptimisations from 'nuxt-webpack-optimisations'"},{"note":"TypeScript only; this is a type export, not a runtime value.","wrong":"import { NuxtWebpackOptimisationsOptions } from 'nuxt-webpack-optimisations'","symbol":"NuxtWebpackOptimisationsOptions","correct":"import type { NuxtWebpackOptimisationsOptions } from 'nuxt-webpack-optimisations'"}],"quickstart":{"code":"// nuxt.config.js (or .ts)\nimport nuxtWebpackOptimisations from 'nuxt-webpack-optimisations'\n\nexport default {\n  buildModules: [\n    nuxtWebpackOptimisations,\n  ],\n  // Optional configuration:\n  webpackOptimisations: {\n    risky: false, // Disable risky optimisations (default: false)\n    minify: true, // Enable minification\n    splitChunks: true, // Enable code splitting\n  },\n}","lang":"typescript","description":"Add nuxt-webpack-optimisations to buildModules and optionally configure it in nuxt.config."},"warnings":[{"fix":"Update Nuxt to 2.6+ or use an older version of the module.","message":"Module requires Nuxt 2.6+ and webpack 4/5. Using with older versions may cause build failures.","severity":"gotcha","affected_versions":">=2.2.6"},{"fix":"If you relied on risky optimisations, explicitly set `risky: true` in your config.","message":"Defaults changed: 'risky' is now false by default (v2.2.3). Enabling risky optimisations may break builds.","severity":"breaking","affected_versions":">=2.2.3"},{"fix":"For Nuxt 3, consider native Vite optimisations or Webpack 5 configuration.","message":"The module is built for Nuxt 2 only. Nuxt 3 users should use other optimisation strategies.","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Use default import: `import nuxtWebpackOptimisations from 'nuxt-webpack-optimisations'`","message":"The module exports a default function, not a named export. Using named import like `import { nuxtWebpackOptimisations }` will result in undefined.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Switch to ESM import syntax.","message":"Using `require('nuxt-webpack-optimisations')` works in Nuxt 2 but is not type-safe and may break in future versions.","severity":"deprecated","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install --save-dev nuxt-webpack-optimisations` or equivalent.","cause":"Module not installed or not in node_modules.","error":"Cannot find module 'nuxt-webpack-optimisations'"},{"fix":"Change `import { nuxtWebpackOptimisations }` to `import nuxtWebpackOptimisations` in your nuxt.config.","cause":"Using named import instead of default import.","error":"nuxtWebpackOptimisations is not a function"},{"fix":"Ensure the module is added to `buildModules` array for Nuxt 2, not `modules`.","cause":"Misplaced the module in the wrong section of nuxt.config (e.g., `buildModules` vs `modules`).","error":"Expected 'loadNuxtConfig' to be called with a config object"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}