mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-25 07:05:11 +00:00
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
---
|
|
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.
|
|
::
|
|
|
|
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.
|