`defineNuxtConfig()`

Type-safe wrapper for the nuxt.config file that defines app configuration.

Since Nuxt 3.0 Spec ↗

Syntax

export default defineNuxtConfig({ ... })

Parameters

Name	Type	Required	Description
`config`	`NuxtConfig`	Yes	The full configuration: `modules`, `runtimeConfig`, `app`, `css`, `routeRules`, `nitro`, `vite`, `experimental`, etc.

Returns

NuxtConfig — The typed configuration object.

Examples

// nuxt.config.ts
export default defineNuxtConfig({
  devtools: { enabled: true },
  modules: ['@nuxt/image', '@pinia/nuxt'],
  runtimeConfig: {
    apiSecret: '',
    public: { apiBase: '/api' },
  },
})

export default defineNuxtConfig({
  ssr: true,
  nitro: { preset: 'node-server' },
  routeRules: {
    '/blog/**': { isr: 3600 },
  },
})

Notes

Provides full IntelliSense and type checking for every Nuxt and module option. Lives at the project root as `nuxt.config.ts`. Module authors can augment its types so installed modules get autocompletion.