Nuxt/docs/2.guide/2.directory-structure/3.nuxt-config.md

43 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

---
title: "nuxt.config.ts"
description: "Nuxt can be easily configured with a single nuxt.config file."
head.title: "nuxt.config.ts"
navigation.icon: i-ph-file
---
The `nuxt.config` file extension can either be `.js`, `.ts` or `.mjs`.
```ts twoslash [nuxt.config.ts]
export default defineNuxtConfig({
// My Nuxt config
})
```
::tip
`defineNuxtConfig` helper is globally available without import.
::
2022-10-12 09:42:07 +00:00
You can explicitly import `defineNuxtConfig` from `nuxt/config` if you prefer:
```ts twoslash [nuxt.config.ts]
import { defineNuxtConfig } from 'nuxt/config'
export default defineNuxtConfig({
// My Nuxt config
})
```
::read-more{to="/docs/api/configuration/nuxt-config"}
Discover all the available options in the **Nuxt configuration** documentation.
::
To ensure your configuration is up to date, Nuxt will make a full restart when detecting changes in the main configuration file, the [`.env`](/docs/guide/directory-structure/env), [`.nuxtignore`](/docs/guide/directory-structure/nuxtignore) and `.nuxtrc` dotfiles.
The `.nuxtrc` file can be used to configure Nuxt with a flat syntax. It is based on [`unjs/rc9`](https://github.com/unjs/rc9).
``` [.nuxtrc]
ssr=false
```
If present the properties in `.nuxtrc` file will overwrite the properties in the `nuxt.config` file.