ModuleContainer Class

All modules will be called within context of ModuleContainer instance.

Tapable plugins

We can register hooks on certain life cycle events.

nuxt.moduleContainer.plugin('ready', async moduleContainer => {
    // Do this after all modules where ready

Inside modules context we can use this instead:

this.plugin('ready', async moduleContainer => {
    // Do this after all modules where ready
Plugin Arguments When
ready moduleContainer All modules in nuxt.config.js has been initialized


addVendor (vendor)

Adds to and apply unique filter.

addTemplate (template)

  • template: String or Object
    • src
    • options
    • fileName

Renders given template using lodash template during build into project buildDir (.nuxt).

If fileName is not provided or template is string, target file name defaults to [dirName].[fileName].[pathHash].[ext].

This method returns final { dist, src, options } object.

addPlugin (template)

Registers a plugin using addTemplate and adds it to first of plugins[] option.

You can use template.ssr: false to disable plugin including in SSR bundle.

addServerMiddleware (middleware)

Pushes middleware into options.serverMiddleware.

extendBuild (fn)

Allows easily extending webpack build config by chaining function.

extendRoutes (fn)

Allows easily extending routes by chaining function.

addModule (moduleOpts, requireOnce)

Registers module. moduleOpts can be string or [src, options]. If requireOnce is true and resolved module exports meta prevents registering same module twice.

requireModule (moduleOpts)

Is shortcut to addModule(moduleOpts, true)

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub!