Nuxt Configuration Reference
Discover all the options you can use in your nuxt.config.ts file.
This file is auto-generated from the source code.
alias
- Type:
object
- Default
{ "~~": "/<rootDir>", "@@": "/<rootDir>", "~": "/<rootDir>", "@": "/<rootDir>", "assets": "/<rootDir>/assets", "public": "/<rootDir>/public"}
You can improve your DX by defining additional aliases to access custom directories within your JavaScript and CSS.
Note: Within a webpack context (image sources, CSS - but not JavaScript) you must access
your alias by prefixing it with ~
.
Note: These aliases will be automatically added to the generated .nuxt/tsconfig.json
so you can get full
type support and path auto-complete. In case you need to extend options provided by ./.nuxt/tsconfig.json
further, make sure to add them here or within the typescript.tsConfig
property in nuxt.config
.
Example:
export default { alias: { 'images': fileURLToPath(new URL('./assets/images', import.meta.url)), 'style': fileURLToPath(new URL('./assets/style', import.meta.url)), 'data': fileURLToPath(new URL('./assets/other/data', import.meta.url)) }}
app
Nuxt App configuration.
baseURL
- Type:
string
- Default:
"/"
The base path of your Nuxt application.
This can be set at runtime by setting the NUXT_APP_BASE_URL environment variable.
Example:
NUXT_APP_BASE_URL=/prefix/ node .output/server/index.mjs
buildAssetsDir
- Type:
string
- Default:
"/_nuxt/"
The folder name for the built site assets, relative to
baseURL
(orcdnURL
if set). This is set at build time and should not be customized at runtime.
cdnURL
- Type:
string
- Default:
""
An absolute URL to serve the public folder from (production-only).
This can be set to a different value at runtime by setting the NUXT_APP_CDN_URL
environment variable.
Example:
NUXT_APP_CDN_URL=https://mycdn.org/ node .output/server/index.mjs
head
- Type:
object
- Default
{ "meta": [ { "name": "viewport", "content": "width=device-width, initial-scale=1" }, { "charset": "utf-8" } ], "link": [], "style": [], "script": [], "noscript": []}
Set default configuration for
<head>
on every page.
Example:
app: { head: { meta: [ // <meta name="viewport" content="width=device-width, initial-scale=1"> { name: 'viewport', content: 'width=device-width, initial-scale=1' } ], script: [ // <script src="https://myawesome-lib.js"></script> { src: 'https://awesome-lib.js' } ], link: [ // <link rel="stylesheet" href="https://myawesome-lib.css"> { rel: 'stylesheet', href: 'https://awesome-lib.css' } ], // please note that this is an area that is likely to change style: [ // <style type="text/css">:root { color: red }</style> { children: ':root { color: red }', type: 'text/css' } ], noscript: [ // <noscript>JavaScript is required</noscript> { children: 'JavaScript is required' } ] }}
keepalive
- Type:
boolean
- Default:
false
Default values for KeepAlive configuration between pages.
This can be overridden with definePageMeta
on an individual page. Only JSON-serializable values are allowed.
See: https://vuejs.org/api/built-in-components.html#keepalive
layoutTransition
- Type:
boolean
- Default:
false
Default values for layout transitions.
This can be overridden with definePageMeta
on an individual page. Only JSON-serializable values are allowed.
See: https://vuejs.org/api/built-in-components.html#transition
pageTransition
- Type:
boolean
- Default:
false
Default values for page transitions.
This can be overridden with definePageMeta
on an individual page. Only JSON-serializable values are allowed.
See: https://vuejs.org/api/built-in-components.html#transition
rootId
- Type:
string
- Default:
"__nuxt"
Customize Nuxt root element id.
rootTag
- Type:
string
- Default:
"div"
Customize Nuxt root element tag.
appConfig
Additional app configuration
For programmatic usage and type support, you can directly provide app config with this option. It will be merged with app.config
file as default value.
build
Shared build configuration.
analyze
- Type:
boolean
- Default:
false
Nuxt uses
webpack-bundle-analyzer
to visualize your bundles and how to optimize them.
Set to true
to enable bundle analysis, or pass an object with options: for webpack or for vite.
Example:
analyze: { analyzerMode: 'static'}
templates
- Type:
array
You can provide your own templates which will be rendered based on Nuxt configuration. This feature is specially useful for using with modules.
Templates are rendered using lodash.template
.
Example:
templates: [ { src: '~/modules/support/plugin.js', // `src` can be absolute or relative dst: 'support.js', // `dst` is relative to project `.nuxt` dir options: { // Options are provided to template as `options` key live_chat: false } }]
transpile
- Type:
array
If you want to transpile specific dependencies with Babel, you can add them here. Each item in transpile can be a package name, a function, a string or regex object matching the dependency's file name.
You can also use a function to conditionally transpile. The function will receive an object ({ isDev, isServer, isClient, isModern, isLegacy }).
Example:
transpile: [({ isLegacy }) => isLegacy && 'ky']
buildDir
- Type:
string
- Default:
"/<rootDir>/.nuxt"
Define the directory where your built Nuxt files will be placed.
Many tools assume that .nuxt
is a hidden directory (because it starts with a .
). If that is a problem, you can use this option to prevent that.
Example:
export default { buildDir: 'nuxt-build'}
builder
- Type:
string
- Default:
"@nuxt/vite-builder"
The builder to use for bundling the Vue part of your application.
components
- Type:
object
- Default
{ "dirs": [ { "path": "~/components/global", "global": true }, "~/components" ]}
Configure Nuxt component auto-registration.
Any components in the directories configured here can be used throughout your pages, layouts (and other components) without needing to explicitly import them.
See: https://nuxt.com/docs/guide/directory-structure/components
css
- Type:
array
You can define the CSS files/modules/libraries you want to set globally (included in every page).
Nuxt will automatically guess the file type by its extension and use the appropriate pre-processor. You will still need to install the required loader if you need to use them.
Example:
css: [ // Load a Node.js module directly (here it's a Sass file). 'bulma', // CSS file in the project '@/assets/css/main.css', // SCSS file in the project '@/assets/css/main.scss']
debug
- Type:
boolean
- Default:
false
Set to
true
to enable debug mode.
At the moment, it prints out hook names and timings on the server, and logs hook arguments as well in the browser.
dev
- Type:
boolean
- Default:
false
Whether Nuxt is running in development mode.
Normally, you should not need to set this.
devServer
host
- Type:
string
- Default:
"localhost"
Dev server listening host
https
- Type:
boolean
- Default:
false
Whether to enable HTTPS.
Example:
import { fileURLToPath } from 'node:url'
export default {
server: {
https: {
key: fs.readFileSync(fileURLToPath(new URL('./server.key', import.meta.url))),
cert: fs.readFileSync(fileURLToPath(new URL('./server.crt', import.meta.url)))
}
}
}
port
- Type:
number
- Default:
3000
Dev server listening port
url
- Type:
string
- Default:
"http://localhost:3000"
Listening dev server url
devServerHandlers
- Type:
array
Nitro development-only server handlers.
See: https://nitro.unjs.io/guide/introduction/routing
dir
Customize default directory structure used by Nuxt.
It is better to stick with defaults unless needed.
assets
- Type:
string
- Default:
"assets"
The assets directory (aliased as
~assets
in your build).
layouts
- Type:
string
- Default:
"layouts"
The layouts directory, each file of which will be auto-registered as a Nuxt layout.
middleware
- Type:
string
- Default:
"middleware"
The middleware directory, each file of which will be auto-registered as a Nuxt middleware.
pages
- Type:
string
- Default:
"pages"
The directory which will be processed to auto-generate your application page routes.
plugins
- Type:
string
- Default:
"plugins"
The plugins directory, each file of which will be auto-registered as a Nuxt plugin.
public
- Type:
string
- Default:
"public"
The directory containing your static files, which will be directly accessible via the Nuxt server and copied across into your
dist
folder when your app is generated.
static
- Type:
string
- Default:
"public"
experimental
asyncEntry
- Type:
boolean
- Default:
false
Set to true to generate an async entry point for the Vue bundle (for module federation support).
componentIslands
- Type:
boolean
- Default:
false
Experimental component islands support with
and .island.vue files.
configSchema
- Type:
boolean
- Default:
false
Enable experimental config schema support
See: https://github.com/nuxt/nuxt/issues/15592
crossOriginPrefetch
- Type:
boolean
- Default:
false
Enable cross-origin prefetch using the Speculation Rules API.
externalVue
- Type:
boolean
- Default:
true
Externalize
vue
,@vue/*
andvue-router
when building.
See: https://github.com/nuxt/nuxt/issues/13632
inlineSSRStyles
- Type:
boolean
- Default:
true
Inline styles when rendering HTML (currently vite only).
You can also pass a function that receives the path of a Vue component and returns a boolean indicating whether to inline the styles for that component.
noScripts
- Type:
boolean
- Default:
false
Turn off rendering of Nuxt scripts and JS resource hints.
payloadExtraction
- Type:
boolean
- Default:
false
When this option is enabled (by default) payload of pages generated with
nuxt generate
are extracted
reactivityTransform
- Type:
boolean
- Default:
false
Enable Vue's reactivity transform
See: https://vuejs.org/guide/extras/reactivity-transform.html
treeshakeClientOnly
- Type:
boolean
- Default:
true
Tree shakes contents of client-only components from server bundle.
See: https://github.com/nuxt/framework/pull/5750
viteNode
- Type:
boolean
- Default:
true
Use vite-node for on-demand server chunk loading
viteServerDynamicImports
- Type:
boolean
- Default:
true
Split server bundle into multiple chunks and dynamically import them.
See: https://github.com/nuxt/nuxt/issues/14525
writeEarlyHints
- Type:
boolean
- Default:
false
Write early hints when using node server.
Note: nginx does not support 103 Early hints in the current version.
extends
- Default:
null
Extend project from multiple local or remote sources.
Value should be either a string or array of strings pointing to source directories or config path relative to current config.
You can use github:
, gitlab:
, bitbucket:
or https://
to extend from a remote git repository.
extensions
- Type:
array
- Default
[ ".js", ".jsx", ".mjs", ".ts", ".tsx", ".vue"]
The extensions that should be resolved by the Nuxt resolver.
generate
exclude
- Type:
array
This option is no longer used. Instead, use
nitro.prerender.ignore
.
routes
- Type:
array
The routes to generate.
If you are using the crawler, this will be only the starting point for route generation. This is often necessary when using dynamic routes.
It is preferred to use nitro.prerender.routes
.
Example:
routes: ['/users/1', '/users/2', '/users/3']
hooks
- Default:
null
Hooks are listeners to Nuxt events that are typically used in modules, but are also available in
nuxt.config
.
Internally, hooks follow a naming pattern using colons (e.g., build:done).
For ease of configuration, you can also structure them as an hierarchical object in nuxt.config
(as below).
Example:
import fs from 'node:fs'
import path from 'node:path'
export default {
hooks: {
build: {
done(builder) {
const extraFilePath = path.join(
builder.nuxt.options.buildDir,
'extra-file'
)
fs.writeFileSync(extraFilePath, 'Something extra')
}
}
}
}
ignore
- Type:
array
- Default
[ "**/*.stories.{js,ts,jsx,tsx}", "**/*.{spec,test}.{js,ts,jsx,tsx}", "**/*.d.ts", ".output", "**/-*.*"]
More customizable than
ignorePrefix
: all files matching glob patterns specified inside theignore
array will be ignored in building.
ignoreOptions
Pass options directly to
node-ignore
(which is used by Nuxt to ignore files).
See: node-ignoreExample:
ignoreOptions: { ignorecase: false}
ignorePrefix
- Type:
string
- Default:
"-"
Any file in
pages/
,layouts/
,middleware/
orstore/
will be ignored during building if its filename starts with the prefix specified byignorePrefix
.
imports
Configure how Nuxt auto-imports composables into your application.
See: Nuxt 3 documentation
dirs
- Type:
array
An array of custom directories that will be auto-imported. Note that this option will not override the default directories (~/composables, ~/utils).
Example:
imports: { // Auto-import pinia stores defined in `~/stores` dirs: ['stores']}
global
- Type:
boolean
- Default:
false
modules
- Type:
array
Modules are Nuxt extensions which can extend its core functionality and add endless integrations.
Each module is either a string (which can refer to a package, or be a path to a file), a tuple with the module as first string and the options as a second object, or an inline module function.
Nuxt tries to resolve each item in the modules array using node require path (in node_modules
) and then will be resolved from project srcDir
if ~
alias is used.
Note: Modules are executed sequentially so the order is important.
Example:
modules: [ // Using package name '@nuxtjs/axios', // Relative to your project srcDir '~/modules/awesome.js', // Providing options ['@nuxtjs/google-analytics', { ua: 'X1234567' }], // Inline definition function () {}]
modulesDir
- Type:
array
- Default
[ "/<rootDir>/node_modules", "/Users/daniel/code/nuxt.js/packages/schema/node_modules"]
Used to set the modules directories for path resolving (for example, webpack's
resolveLoading
,nodeExternals
andpostcss
).
The configuration path is relative to options.rootDir
(default is current working directory).
Setting this field may be necessary if your project is organized as a yarn workspace-styled mono-repository.
Example:
export default { modulesDir: ['../../node_modules']}
nitro
Configuration for Nitro.
See: https://nitro.unjs.io/config/
routeRules
- Type:
object
pages
- Type:
boolean
Whether to use the vue-router integration in Nuxt 3. If you do not provide a value it will be enabled if you have a
pages/
directory in your source folder.
plugins
- Type:
array
An array of nuxt app plugins.
Each plugin can be a string (which can be an absolute or relative path to a file). If it ends with .client
or .server
then it will be automatically loaded only in the appropriate context.
It can also be an object with src
and mode
keys.
Note: Plugins are also auto-registered from the ~/plugins
directory
and these plugins do not need to be listed in nuxt.config
unless you
need to customize their order. All plugins are deduplicated by their src path.
See: https://nuxt.com/docs/guide/directory-structure/pluginsExample:
plugins: [ '~/plugins/foo.client.js', // only in client side '~/plugins/bar.server.js', // only in server side '~/plugins/baz.js', // both client & server { src: '~/plugins/both-sides.js' }, { src: '~/plugins/client-only.js', mode: 'client' }, // only on client side { src: '~/plugins/server-only.js', mode: 'server' } // only on server side]
postcss
plugins
Options for configuring PostCSS plugins.
autoprefixer
cssnano
- Type:
boolean
- Default:
true
postcss-import
- Type:
object
postcss-url
rootDir
- Type:
string
- Default:
"/<rootDir>"
Define the root directory of your application.
This property can be overwritten (for example, running nuxt ./my-app/
will set the rootDir
to the absolute path of ./my-app/
from the current/working directory.
It is normally not needed to configure this option.
routeRules
Global route options applied to matching server routes.
Experimental: This is an experimental feature and API may change in the future. See: https://nitro.unjs.io/config/#routes
router
options
Additional options passed to
vue-router
.
Note: Only JSON serializable options should be passed by nuxt config.
For more control, you can use app/router.options.ts
file.
See: documentation.
runtimeConfig
- Type:
object
- Default
{ "public": {}, "app": { "baseURL": "/", "buildAssetsDir": "/_nuxt/", "cdnURL": "" }}
Runtime config allows passing dynamic config and environment variables to the Nuxt app context.
The value of this object is accessible from server only using useRuntimeConfig
.
It mainly should hold private configuration which is not exposed on the frontend. This could include a reference to your API secret tokens.
Anything under public
and app
will be exposed to the frontend as well.
Values are automatically replaced by matching env variables at runtime, e.g. setting an environment variable NUXT_API_KEY=my-api-key NUXT_PUBLIC_BASE_URL=/foo/
would overwrite the two values in the example below.
Example:
export default { runtimeConfig: { apiKey: '' // Default to an empty string, automatically set at runtime using process.env.NUXT_API_KEY public: { baseURL: '' // Exposed to the frontend as well. } }}
serverDir
- Type:
string
- Default:
"/<rootDir>/server"
Define the server directory of your Nuxt application, where Nitro routes, middleware and plugins are kept.
If a relative path is specified, it will be relative to your rootDir
.
serverHandlers
- Type:
array
Nitro server handlers.
Each handler accepts the following options: - handler: The path to the file defining the handler. - route: The route under which the handler is available. This follows the conventions of https://github.com/unjs/radix3. - method: The HTTP method of requests that should be handled. - middleware: Specifies whether it is a middleware handler. - lazy: Specifies whether to use lazy loading to import the handler.
See: https://nuxt.com/docs/guide/directory-structure/server
Note: Files from server/api
, server/middleware
and server/routes
will be automatically registered by Nuxt.
Example:
serverHandlers: [ { route: '/path/foo/**:name', handler: '~/server/foohandler.ts' }]
sourcemap
- Type:
object
- Default
{ "server": true, "client": false}
Whether to generate sourcemaps.
srcDir
- Type:
string
- Default:
"/<rootDir>"
Define the source directory of your Nuxt application.
If a relative path is specified, it will be relative to the rootDir
.
Example:
export default { srcDir: 'src/'}
This would work with the following folder structure:
-| app/---| node_modules/---| nuxt.config.js---| package.json---| src/------| assets/------| components/------| layouts/------| middleware/------| pages/------| plugins/------| static/------| store/------| server/
ssr
- Type:
boolean
- Default:
true
Whether to enable rendering of HTML - either dynamically (in server mode) or at generate time. If set to
false
and combined withstatic
target, generated pages will simply display a loading screen with no content.
telemetry
- Type:
boolean
Manually disable nuxt telemetry.
See: Nuxt Telemetry for more information.
test
- Type:
boolean
- Default:
false
Whether your app is being unit tested.
theme
- Type:
string
- Default:
null
Extend project from a local or remote source.
Value should be a string pointing to source directory or config path relative to current config.
You can use github:
, gitlab:
, bitbucket:
or https://
to extend from a remote git repository.
typescript
Configuration for Nuxt's TypeScript integration.
includeWorkspace
- Type:
boolean
- Default:
false
Include parent workspace in the Nuxt project. Mostly useful for themes and module authors.
shim
- Type:
boolean
- Default:
true
Generate a
*.vue
shim.
We recommend instead either enabling Take Over Mode or adding TypeScript Vue Plugin (Volar)** 👉 [Download].
strict
- Type:
boolean
- Default:
true
TypeScript comes with certain checks to give you more safety and analysis of your program. Once you’ve converted your codebase to TypeScript, you can start enabling these checks for greater safety. Read More
tsConfig
You can extend generated
.nuxt/tsconfig.json
using this option.
typeCheck
- Type:
boolean
- Default:
false
Enable build-time type checking.
If set to true, this will type check in development. You can restrict this to build-time type checking by setting it to build
. Requires to install typescript
and vue-tsc
as dev dependencies.
See: https://nuxt.com/docs/guide/concepts/typescript
vite
Configuration that will be passed directly to Vite.
See https://vitejs.dev/config for more information. Please note that not all vite options are supported in Nuxt.
build
assetsDir
- Type:
string
- Default:
"_nuxt/"
emptyOutDir
- Type:
boolean
- Default:
false
clearScreen
- Type:
boolean
- Default:
false
define
- Type:
object
- Default
{ "process.dev": false}
esbuild
jsxFactory
- Type:
string
- Default:
"h"
jsxFragment
- Type:
string
- Default:
"Fragment"
tsconfigRaw
- Type:
string
- Default:
"{}"
logLevel
- Type:
string
- Default:
"info"
mode
- Type:
string
- Default:
"production"
optimizeDeps
exclude
- Type:
array
- Default
[ "vue-demi"]
publicDir
- Type:
string
- Default:
"/<rootDir>/public"
resolve
extensions
- Type:
array
- Default
[ ".mjs", ".js", ".ts", ".jsx", ".tsx", ".json", ".vue"]
root
- Type:
string
- Default:
"/<rootDir>"
server
fs
allow
- Type:
array
- Default
[ "/<rootDir>/.nuxt", "/<rootDir>", "/<rootDir>", "/<rootDir>", "/<rootDir>/node_modules", "/Users/daniel/code/nuxt.js/packages/schema/node_modules"]
vue
isProduction
- Type:
boolean
- Default:
true
template
compilerOptions
- Type:
object
vue
Vue.js config
compilerOptions
Options for the Vue compiler that will be passed at build time.
See: documentation
watchers
The watchers property lets you overwrite watchers configuration in your
nuxt.config
.
chokidar
Options to pass directly to
chokidar
.
See: chokidar
ignoreInitial
- Type:
boolean
- Default:
true
rewatchOnRawEvents
An array of event types, which, when received, will cause the watcher to restart.
webpack
watchOptions
to pass directly to webpack.
See: webpack@4 watch options.
aggregateTimeout
- Type:
number
- Default:
1000
webpack
aggressiveCodeRemoval
- Type:
boolean
- Default:
false
Hard-replaces
typeof process
,typeof window
andtypeof document
to tree-shake bundle.
analyze
- Type:
boolean
- Default:
false
Nuxt uses
webpack-bundle-analyzer
to visualize your bundles and how to optimize them.
Set to true
to enable bundle analysis, or pass an object with options: for webpack or for vite.
Example:
analyze: { analyzerMode: 'static'}
cssSourceMap
- Type:
boolean
- Default:
false
Enables CSS source map support (defaults to
true
in development).
devMiddleware
See webpack-dev-middleware for available options.
stats
- Type:
string
- Default:
"none"
extractCSS
- Type:
boolean
- Default:
true
Enables Common CSS Extraction using Vue Server Renderer guidelines.
Using extract-css-chunks-webpack-plugin under the hood, your CSS will be extracted into separate files, usually one per component. This allows caching your CSS and JavaScript separately and is worth trying if you have a lot of global or shared CSS.
Example:
export default { webpack: { extractCSS: true, // or extractCSS: { ignoreOrder: true } }}
Example:
export default { webpack: { extractCSS: true, optimization: { splitChunks: { cacheGroups: { styles: { name: 'styles', test: /\.(css|vue)$/, chunks: 'all', enforce: true } } } } }}
filenames
Customize bundle filenames.
To understand a bit more about the use of manifests, take a look at this webpack documentation.
Note: Be careful when using non-hashed based filenames in production as most browsers will cache the asset and not detect the changes on first load.
Example:
filenames: { chunk: ({ isDev }) => (isDev ? '[name].js' : '[id].[contenthash].js')}
app
- Type:
function
chunk
- Type:
function
css
- Type:
function
font
- Type:
function
img
- Type:
function
video
- Type:
function
friendlyErrors
- Type:
boolean
- Default:
true
Set to
false
to disable the overlay provided by FriendlyErrorsWebpackPlugin.
hotMiddleware
See webpack-hot-middleware for available options.
loaders
Customize the options of Nuxt's integrated webpack loaders.
css
esModule
- Type:
boolean
- Default:
false
importLoaders
- Type:
number
- Default:
0
url
filter
- Type:
function
cssModules
esModule
- Type:
boolean
- Default:
false
importLoaders
- Type:
number
- Default:
0
modules
localIdentName
- Type:
string
- Default:
"[local]_[hash:base64:5]"
url
filter
- Type:
function
file
esModule
- Type:
boolean
- Default:
false
fontUrl
esModule
- Type:
boolean
- Default:
false
limit
- Type:
number
- Default:
1000
imgUrl
esModule
- Type:
boolean
- Default:
false
limit
- Type:
number
- Default:
1000
less
- Default
{ "sourceMap": false}
pugPlain
sass
sassOptions
indentedSyntax
- Type:
boolean
- Default:
true
scss
- Default
{ "sourceMap": false}
stylus
- Default
{ "sourceMap": false}
vue
compilerOptions
- Type:
object
productionMode
- Type:
boolean
- Default:
true
transformAssetUrls
embed
- Type:
string
- Default:
"src"
object
- Type:
string
- Default:
"src"
source
- Type:
string
- Default:
"src"
video
- Type:
string
- Default:
"src"
vueStyle
- Default
{ "sourceMap": false}
optimization
Configure webpack optimization.
minimize
- Type:
boolean
- Default:
true
Set minimize to
false
to disable all minimizers. (It is disabled in development by default).
minimizer
You can set minimizer to a customized array of plugins.
runtimeChunk
- Type:
string
- Default:
"single"
splitChunks
automaticNameDelimiter
- Type:
string
- Default:
"/"
cacheGroups
chunks
- Type:
string
- Default:
"all"
optimizeCSS
- Type:
boolean
- Default:
false
OptimizeCSSAssets plugin options.
Defaults to true when extractCSS
is enabled.
See: css-minimizer-webpack-plugin documentation.
plugins
- Type:
array
Add webpack plugins.
Example:
import webpack from 'webpack'import { version } from './package.json'// ...plugins: [ new webpack.DefinePlugin({ 'process.VERSION': version })]
postcss
Customize PostCSS Loader. Same options as https://github.com/webpack-contrib/postcss-loader#options
execute
- Type:
undefined
implementation
- Type:
undefined
order
- Type:
string
- Default:
""
postcssOptions
config
plugins
- Type:
object
- Default
{ "postcss-import": {}, "postcss-url": {}, "autoprefixer": {}, "cssnano": true}
sourceMap
- Type:
undefined
profile
- Type:
boolean
- Default:
false
Enable the profiler in webpackbar.
It is normally enabled by CLI argument --profile
.
See: webpackbar.
serverURLPolyfill
- Type:
string
- Default:
"url"
The polyfill library to load to provide URL and URLSearchParams.
Defaults to 'url'
(see package).
terser
Terser plugin options.
Set to false to disable this plugin, or pass an object of options.
See: terser-webpack-plugin documentation.
Note: Enabling sourceMap will leave //# sourceMappingURL
linking comment at
the end of each output file if webpack config.devtool
is set to source-map
.
warningIgnoreFilters
- Type:
array
Filters to hide build warnings.
workspaceDir
- Type:
string
- Default:
"/<rootDir>"
Define the workspace directory of your application.
Often this is used when in a monorepo setup. Nuxt will attempt to detect your workspace directory automatically, but you can override it here. It is normally not needed to configure this option.