app.config Reference
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.
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 |
PageLastCommit
The meta row below the lead of every docs page shows the latest commit of its Markdown file, with time, author and message. This page covers when it appears, date formatting and author detection for PR squash merges.
nuxt.config Options
Every nuxt.config option and environment variable the layer reads at build time, including feature flags, AI Chat, component metadata, MCP, llms.txt, agent discovery and site info. Changing these options requires a rebuild or a dev server restart.