Configuration Overview

Movk Nuxt Docs is configured in two places. nuxt.config.ts decides at build time which modules and features are included; app.config.ts controls UI, text and navigation at runtime. This page explains the split, when each takes effect, and where common changes belong.
View source

Two configuration files

FileTakes effectControlsFull reference
nuxt.config.tsBuild timeExtending the layer, feature flags, AI models, MCP, llms.txt, i18n, site URLnuxt.config Options
app/app.config.tsRuntimeHeader, footer, navigation, sidebar categories, TOC, theme, GitHub integration, AI Chat UI textapp.config Reference

The rule of thumb: anything that changes which code is bundled or which routes and files are generated goes in nuxt.config.ts; anything that only changes what is shown on the page goes in app.config.ts.

app.config.ts must live in the app/ directory, and the project root must contain a nuxt.config.ts.

Minimal setup

After extending the layer, most sites only need a site name and navigation:

export default defineNuxtConfig({
  extends: ['@movk/nuxt-docs'],
  site: {
    name: 'My Docs',
    url: 'https://docs.example.com'
  }
})

Unset fields fall back to the layer defaults. The following are inferred at build time:

FieldSource
site.namename in package.json, then the Git repository name
site.urlNUXT_PUBLIC_SITE_URL, NUXT_SITE_URL, or the deployment URL injected by Vercel, Netlify, Cloudflare Pages or GitLab Pages
header.titlesite.name in start case
seo.title / seo.titleTemplatesite.name, with the template %s - {site.name}
seo.descriptiondescription in package.json
github.owner / name / url / branchLocal Git info or CI environment variables

Common tasks

GoalWhereSee
Change header links, the mobile menu or sidebar groupsheader.nav, header.mobileNav, docs.categories in app.configNavigation & Categories
Change the primary color, neutral color or heading fontui.colors and theme.* in app.configTheme & Fonts
Enable component docs, Mermaid or AI ChatmovkNuxtDocs.* and aiChat.* in nuxt.configFeature Flags
Replace the header logo, footer or other UI regionsCreate a component with the same name in app/components/Customization
Add a releases page, a showcase page or custom pagescontent/releases.yml, content/templates.yml, app/pages/Pages & Layouts
Serve multiple languagesi18n in nuxt.configInternationalization

SEO

Site-wide defaults go in app.config.ts; per-page overrides go in the Markdown frontmatter:

export default defineAppConfig({
  seo: {
    titleTemplate: '%s - My Docs',
    title: 'My Docs',
    description: 'One sentence about your project'
  }
})

Docs pages use seo.title for <title> and the OG image, falling back to title; descriptions work the same way.

GitHub integration

The layer infers the repository from local Git info. It powers the header GitHub icon, the "View source / Edit this page" links, PageLastCommit and CommitChangelog. Set rootDir when the docs are not at the repository root:

app/app.config.ts
export default defineAppConfig({
  github: {
    rootDir: 'docs',
    branch: 'main'
  }
})

Set github: false to turn the integration off entirely. In production, configure NUXT_GITHUB_TOKEN to avoid the rate limits of anonymous GitHub API requests.

See the app.config reference for every field, including github.since, github.perPage and github.dateFormat.
app/app.config.ts
export default defineAppConfig({
  toc: {
    title: 'On this page',
    bottom: {
      title: 'Community',
      links: [
        { icon: 'i-lucide-book-open', label: 'Nuxt UI', to: 'https://ui.nuxt.com', target: '_blank' }
      ]
    }
  },
  footer: {
    credits: 'Copyright © 2026 My Team · <span class="text-highlighted">MIT License</span>',
    socials: [
      { 'icon': 'i-simple-icons-github', 'to': 'https://github.com/my/repo', 'target': '_blank', 'aria-label': 'GitHub' }
    ]
  }
})

footer.credits is rendered as MDC, so it can contain links and inline HTML. The GitHub "Edit this page" link is appended below the TOC automatically.

Copyright © 2024 - 2026