---
title: "app.config Reference"
description: "Every field of app.config.ts with its type, default value and description, generated from the layer's nuxt.schema.ts so it always matches the published version. Follow the links to the guides for usage details."
canonical_url: "https://docs.mhaibaraai.cn/en/docs/reference/app-config"
---
# app.config Reference

> Every field of app.config.ts with its type, default value and description, generated from the layer's nuxt.schema.ts so it always matches the published version. Follow the links to the guides for usage details.

This page lists every field available in `app/app.config.ts`. The tables are generated from `layer/nuxt.schema.ts`; run `pnpm docs:reference` after changing the schema.

`app.config` is read at runtime. Module-level switches (feature flags, AI models and so on) live in `nuxt.config.ts`, see [nuxt.config Options](https://docs.mhaibaraai.cn/en/docs/reference/nuxt-config).

## `i18n`

Multilingual and UI language settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `i18n.locale` | `string` | `"zh-CN"` | UI language when `@nuxtjs/i18n` is not enabled (e.g. `zh-CN`, `en`) |

## `theme`

Theme settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `theme.radius` | `number` | `0.25` | Global border radius in rem |
| `theme.blackAsPrimary` | `boolean` | `false` | Use black as the primary color |
| `theme.icons` | `string` | `"lucide"` | Global icon collection name |
| `theme.font` | `string` | `"editorial"` | `editorial` uses serif headings, `sans` uses sans-serif everywhere |
| `theme.grain` | `boolean` | `false` | Overlay a paper grain texture on the page background |

## `seo`

SEO settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `seo.titleTemplate` | `string` | `"%s"` | Page title template, with `%s` as the placeholder |
| `seo.title` | `string` | `""` | Default site title |
| `seo.description` | `string` | `""` | Default site description |

## `header`

Page header settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `header.title` | `string` | `""` | Title shown in the header |
| `header.avatar` | `string` | `""` | Avatar image URL |
| `header.to` | `string` | `"/"` | Link target when clicking the title |
| `header.search` | `boolean` | `true` | Show the search box |
| `header.colorMode` | `boolean` | `true` | Show the color mode toggle |
| `header.links` | `array` | `[]` | Icon buttons on the right side of the header |
| `header.nav` | `array` | `[]` | Top navigation links; `label` accepts a per-locale object and internal links get the locale prefix automatically |
| `header.mobileNav` | `array` | `[]` | Navigation links in the mobile menu; falls back to the desktop navigation when empty |

## `docs`

Docs sidebar settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `docs.categories` | `object` | `{}` | Group sidebar navigation by top-level directory; keys are directory slugs, values are category lists |

## `footer`

Page footer settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `footer.credits` | `string` | `""` | Copyright text shown in the footer |
| `footer.socials` | `array` | `[]` | Social link buttons shown in the footer |

## `toc`

Table of contents settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `toc.title` | `string` | `""` | Title of the table of contents; uses the built-in translation when empty |
| `toc.bottom.title` | `string` | `""` | Title of the area below the table of contents |
| `toc.bottom.links` | `array` | `[]` | Link buttons shown below the table of contents |

## `aside`

Docs sidebar settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `aside.filter.enabled` | `boolean` | `false` | Show a navigation filter at the top of the sidebar |
| `aside.filter.placeholder` | `string` | `""` | Placeholder of the filter input; uses the built-in translation when empty |
| `aside.filter.threshold` | `number` | `10` | Show the filter only when the current group has at least this many items |
| `aside.filter.shortcut` | `string` | `"/"` | Keyboard shortcut that focuses the filter; empty disables it |

## `github`

GitHub repository settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `github.owner` | `string` | `""` | GitHub repository owner |
| `github.name` | `string` | `""` | GitHub repository name |
| `github.url` | `string` | `""` | Full GitHub repository URL |
| `github.branch` | `string` | `"main"` | Default branch name |
| `github.rootDir` | `string` | `""` | Root directory of the docs inside the repository |
| `github.commitPath` | `string` | `"src"` | Repository directory used by `CommitChangelog` to resolve component / composable source files |
| `github.suffix` | `string` | `"vue"` | File extension, without the dot, used by `CommitChangelog` to resolve source files |
| `github.since` | `string` | `""` | Only fetch commits after this ISO date; empty means no limit |
| `github.until` | `string` | `""` | Only fetch commits before this ISO date; empty means no limit |
| `github.perPage` | `number` | `100` | Maximum number of commits fetched per file |
| `github.author` | `string` | `""` | Only show commits by this author |
| `github.casing` | `string` | `"auto"` | File naming style: `auto`, `kebab`, `camel` or `pascal` |
| `github.dateFormat.locale` | `string` | `"zh-CN"` | Locale used to format dates (e.g. `zh-CN`, `en-US`) |
| `github.dateFormat.options` | `object` | `{}` | `Intl.DateTimeFormat` options |

## `aiChat`

AI chat assistant settings

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `aiChat.floatingInput` | `boolean` | `true` | Show the floating input at the bottom of docs pages |
| `aiChat.explainWithAi` | `boolean` | `true` | Show the "Explain with AI" button in the docs sidebar |
| `aiChat.faqQuestions` | `array` | `[]` | Suggested questions; a string array, a categorized object array, or an object keyed by locale |
| `aiChat.shortcuts.focusInput` | `string` | `"meta_i"` | Shortcut that focuses the floating input |
| `aiChat.texts.title` | `string` | `""` | Title of the AI chat panel |
| `aiChat.texts.clearChat` | `string` | `""` | Text of the clear chat button |
| `aiChat.texts.close` | `string` | `""` | Text of the close button |
| `aiChat.texts.placeholder` | `string` | `""` | Placeholder of the floating input |
| `aiChat.texts.lineBreak` | `string` | `""` | Hint text for inserting a line break |
| `aiChat.texts.trigger` | `string` | `""` | Tooltip of the AI chat trigger button |
| `aiChat.texts.explainWithAi` | `string` | `""` | Text of the "Explain with AI" button |
| `aiChat.icons.trigger` | `string` | `"i-custom-ai"` | Icon of the AI chat trigger button |
| `aiChat.icons.explain` | `string` | `"i-lucide-bot-message-square"` | Icon of the "Explain with AI" button |
| `aiChat.icons.reasoning` | `string` | `"i-lucide-brain"` | Icon of the reasoning block |
| `aiChat.icons.clearChat` | `string` | `"i-lucide-list-x"` | Icon of the clear chat button |
| `aiChat.icons.close` | `string` | `"i-lucide-panel-right-close"` | Icon of the close button |
| `aiChat.icons.providers` | `object` | `{}` | Icons per AI provider; keys are provider names, values are icon names |


## Sitemap

See the full [sitemap](https://docs.mhaibaraai.cn/sitemap.md) for all pages.
