[{"data":1,"prerenderedAt":1096},["ShallowReactive",2],{"docs-navigation-en":3,"mdc--tctnej-key":338,"docs--en-docs-guide-deployment":351,"surround--en-docs-guide-deployment":1085,"-en-docs-guide-deployment-description":1088},[4],{"title":5,"path":6,"stem":7,"children":8,"page":113},"Docs","\u002Fen\u002Fdocs","en\u002Fdocs",[9,38,114,150,191,239],{"title":10,"path":11,"stem":12,"children":13,"category":16,"description":16,"icon":37},"Get Started","\u002Fen\u002Fdocs\u002Fgetting-started","en\u002Fdocs\u002F1.getting-started\u002F1.index",[14,19,25,31],{"title":15,"path":11,"stem":12,"category":16,"description":17,"icon":18},"Introduction",null,"Movk Nuxt Docs is a Nuxt Layer you can extend to get typography, navigation, search, SEO and AI features for a documentation site. This page explains what it suits, what is included by default and what you can turn on.","i-lucide-book-open",{"title":20,"path":21,"stem":22,"category":16,"description":23,"icon":24},"Installation","\u002Fen\u002Fdocs\u002Fgetting-started\u002Finstallation","en\u002Fdocs\u002F1.getting-started\u002F2.installation","Create a documentation site from an official template, or add @movk\u002Fnuxt-docs as a layer to an existing Nuxt project. This page compares the default, i18n and module templates and lists the runtime requirements and required dependencies.","i-lucide-download",{"title":26,"path":27,"stem":28,"category":16,"description":29,"icon":30},"Project Structure","\u002Fen\u002Fdocs\u002Fgetting-started\u002Fproject-structure","en\u002Fdocs\u002F1.getting-started\u002F3.project-structure","What each directory and file does in a Movk Nuxt Docs project, where content goes, how routes are generated, which files turn into the releases and showcase pages, and what the two config files control.","i-lucide-folder-tree",{"title":32,"path":33,"stem":34,"category":16,"description":35,"icon":36},"Migrating from v2","\u002Fen\u002Fdocs\u002Fgetting-started\u002Fmigration","en\u002Fdocs\u002F1.getting-started\u002F4.migration","Every breaking change when upgrading @movk\u002Fnuxt-docs from v2 to v3, each with a v2 and v3 comparison. Work through dependencies and feature flags, content paths, config fields, visual defaults and component overrides in order to finish the upgrade.","i-lucide-arrow-right-left","i-lucide-square-play",{"title":39,"category":16,"description":16,"icon":40,"path":41,"stem":42,"children":43,"page":113},"Guide","i-lucide-compass","\u002Fen\u002Fdocs\u002Fguide","en\u002Fdocs\u002F2.guide",[44,51,58,64,70,76,82,89,95,101,107],{"title":45,"path":46,"stem":47,"category":48,"description":49,"icon":50},"Configuration Overview","\u002Fen\u002Fdocs\u002Fguide\u002Fconfiguration","en\u002Fdocs\u002F2.guide\u002F1.configuration","basics","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.","i-lucide-settings",{"title":52,"path":53,"stem":54,"category":55,"description":56,"icon":57},"Troubleshooting","\u002Fen\u002Fdocs\u002Fguide\u002Ftroubleshooting","en\u002Fdocs\u002F2.guide\u002F10.troubleshooting","shipping","Fix common build and runtime errors involving optional dependencies, AI Chat and MCP, docs 404s, i18n configuration, pnpm build approvals and commit history.","i-lucide-life-buoy",{"title":59,"path":60,"stem":61,"category":55,"description":62,"icon":63},"FAQ","\u002Fen\u002Fdocs\u002Fguide\u002Ffaq","en\u002Fdocs\u002F2.guide\u002F11.faq","Answers to common questions about Movk Nuxt Docs, from how it relates to the Nuxt UI docs template, package managers and Node.js versions, and single-language sites, to turning off GitHub, using other AI providers, upgrading, overriding components and static hosting limits.","i-lucide-circle-help",{"title":65,"path":66,"stem":67,"category":48,"description":68,"icon":69},"Theme & Fonts","\u002Fen\u002Fdocs\u002Fguide\u002Ftheme","en\u002Fdocs\u002F2.guide\u002F2.theme","The default theme is editorial - a warm paper background, a vermilion accent, serif headings and monospaced metadata. This page covers the default colors and fonts, switching colors and heading fonts in app.config, adding a CJK serif font, the visitor theme picker and motion preferences.","i-lucide-palette",{"title":71,"path":72,"stem":73,"category":48,"description":74,"icon":75},"Navigation & Categories","\u002Fen\u002Fdocs\u002Fguide\u002Fnavigation","en\u002Fdocs\u002F2.guide\u002F3.navigation","Header links, the mobile menu and sidebar groups are declared in app.config, while the docs directory structure drives the section bar and the sidebar order. This page covers where each navigation comes from, localized labels and link prefixes, sidebar grouping rules, the sidebar filter and ⌘K search.","i-lucide-map",{"title":77,"path":78,"stem":79,"category":48,"description":80,"icon":81},"Feature Flags","\u002Fen\u002Fdocs\u002Fguide\u002Ffeatures","en\u002Fdocs\u002F2.guide\u002F4.features","Optional features such as component docs, Mermaid, AI Chat and accessibility checks are controlled by switches in nuxt.config, and features that are off bundle none of their dependencies. This page lists each flag's default, the dependencies to install when enabling it, and what happens when it is off.","i-lucide-toggle-right",{"title":83,"path":84,"stem":85,"category":86,"description":87,"icon":88},"Customization","\u002Fen\u002Fdocs\u002Fguide\u002Fcustomization","en\u002Fdocs\u002F2.guide\u002F5.customization","customization","Create a Vue file with the same name as a built-in component in your component directory to replace the header, sidebars, footer and other UI regions. This page lists the components v3 promises to keep stable, where each is mounted, and a minimal override for every one of them.","i-lucide-paintbrush",{"title":90,"path":91,"stem":92,"category":86,"description":93,"icon":94},"Pages & Layouts","\u002Fen\u002Fdocs\u002Fguide\u002Fpages","en\u002Fdocs\u002F2.guide\u002F6.pages","Besides docs pages, the layer generates the landing page, a releases page and a showcase page from files in the content directory, and you can write any Vue page in app\u002Fpages. This page covers when each built-in route is generated and its content format, header and footer switches for custom pages, and the built-in layouts.","i-lucide-layout-panel-top",{"title":96,"path":97,"stem":98,"category":86,"description":99,"icon":100},"Internationalization","\u002Fen\u002Fdocs\u002Fguide\u002Fi18n","en\u002Fdocs\u002F2.guide\u002F7.i18n","Turn on multiple languages with @nuxtjs\u002Fi18n. This page covers installation, the content directory layout, per-locale collections, UI text overrides and hreflang SEO. Without it the site stays single-language, and you can still switch the UI language.","i-lucide-languages",{"title":102,"path":103,"stem":104,"category":86,"description":105,"icon":106},"OG Images","\u002Fen\u002Fdocs\u002Fguide\u002Fog-image","en\u002Fdocs\u002F2.guide\u002F8.og-image","Every docs page gets a social sharing image (OG image) generated at build time. This page covers the fields the built-in template reads, generating images for custom pages, replacing the template, and what happens when the feature is off.","i-lucide-image",{"title":108,"path":109,"stem":110,"category":55,"description":111,"icon":112},"Deployment","\u002Fen\u002Fdocs\u002Fguide\u002Fdeployment","en\u002Fdocs\u002F2.guide\u002F9.deployment","Deploy the docs site to Vercel, Netlify, Cloudflare or any Node.js server, or generate a fully static site. This page lists the build commands, environment variables, per-platform notes and the features that are unavailable on static hosting.","i-lucide-rocket",false,{"title":115,"category":16,"description":16,"icon":116,"path":117,"stem":118,"children":119,"page":113},"AI","i-lucide-sparkles","\u002Fen\u002Fdocs\u002Fai","en\u002Fdocs\u002F3.ai",[120,126,132,138,144],{"title":121,"path":122,"stem":123,"category":16,"description":124,"icon":125},"AI Chat","\u002Fen\u002Fdocs\u002Fai\u002Fai-chat","en\u002Fdocs\u002F3.ai\u002F1.ai-chat","Turn on the built-in AI assistant for your docs site. Covers the enable conditions and dependencies, model and endpoint routing, adding other providers, and the component and composable API, so readers can ask the docs directly within minutes.","i-lucide-bot",{"title":127,"path":128,"stem":129,"category":16,"description":130,"icon":131},"MCP Server","\u002Fen\u002Fdocs\u002Fai\u002Fmcp","en\u002Fdocs\u002F3.ai\u002F2.mcp","Every docs site serves a Model Context Protocol server at \u002Fmcp by default. This page lists the built-in tools, resources and prompts, shows how to connect Claude Code, Cursor, VS Code and other clients, and explains how to disable, restrict or extend the server.","i-lucide-plug",{"title":133,"path":134,"stem":135,"category":16,"description":136,"icon":137},"Agent Skills","\u002Fen\u002Fdocs\u002Fai\u002Fskills","en\u002Fdocs\u002F3.ai\u002F3.skills","Publish the Agent Skills in your project's skills\u002F directory under \u002F.well-known\u002Fskills\u002F together with the docs site, so readers install them into Claude Code, Cursor and other assistants with one command. Covers layout, naming, publishing and the two built-in skills.","i-lucide-wand-sparkles",{"title":139,"path":140,"stem":141,"category":16,"description":142,"icon":143},"llms.txt","\u002Fen\u002Fdocs\u002Fai\u002Fllms-txt","en\u002Fdocs\u002F3.ai\u002F4.llms-txt","The docs site generates \u002Fllms.txt and \u002Fllms-full.txt automatically, giving language models an index and the full text of your docs. Learn where the defaults come from, how to set titles and sections, how they relate to each page's Markdown, and how to use them in Cursor and other tools.","i-lucide-file-text",{"title":145,"path":146,"stem":147,"category":16,"description":148,"icon":149},"Agent Discovery","\u002Fen\u002Fdocs\u002Fai\u002Fagent-discovery","en\u002Fdocs\u002F3.ai\u002F5.agent-discovery","The docs site serves AI agents a Markdown version of every page, a Markdown sitemap and a set of \u002F.well-known discovery documents, so agents can find and read content without parsing HTML. This page lists every endpoint, the negotiation rules and what the layer adds.","i-lucide-radar",{"title":151,"category":16,"description":16,"icon":152,"path":153,"stem":154,"children":155,"page":113},"Writing","i-lucide-square-pilcrow","\u002Fen\u002Fdocs\u002Fwriting","en\u002Fdocs\u002F4.writing",[156,162,168,174,179,185],{"title":157,"path":158,"stem":159,"category":16,"description":160,"icon":161},"Markdown Syntax","\u002Fen\u002Fdocs\u002Fwriting\u002Fmarkdown-syntax","en\u002Fdocs\u002F4.writing\u002F1.markdown-syntax","Docs pages are written in standard Markdown. Headings drive the table of contents and anchors, while emphasis, links, lists, tables and blockquotes structure the content. This page lists the common syntax and how Movk Nuxt Docs renders it.","i-lucide-heading",{"title":163,"path":164,"stem":165,"category":16,"description":166,"icon":167},"Code Blocks","\u002Fen\u002Fdocs\u002Fwriting\u002Fcode-blocks","en\u002Fdocs\u002F4.writing\u002F2.code-blocks","Code blocks are highlighted with github-light \u002F github-dark and support filenames, line highlights, a copy button, and color and icon previews. Use code-group, code-tree, code-preview and code-collapse for multi-file, multi-package-manager and long examples.","i-lucide-square-code",{"title":169,"path":170,"stem":171,"category":16,"description":172,"icon":173},"MDC Components","\u002Fen\u002Fdocs\u002Fwriting\u002Fmdc-components","en\u002Fdocs\u002F4.writing\u002F3.mdc-components","Embed Nuxt UI prose components in Markdown with MDC syntax, including callouts, badges, cards, accordions, tabs, steps, fields, icons and keyboard keys, to structure richer docs without writing Vue code.","i-lucide-puzzle",{"title":175,"path":176,"stem":177,"category":16,"description":178,"icon":106},"Images and Video","\u002Fen\u002Fdocs\u002Fwriting\u002Fmedia","en\u002Fdocs\u002F4.writing\u002F4.media","Insert remote or local images with Markdown image syntax, provide separate light and dark screenshots with `u-color-mode-image`, and embed videos with `:video`. Also covers where to put images and how to write alt text.",{"title":180,"path":181,"stem":182,"category":16,"description":183,"icon":184},"Mermaid Diagrams","\u002Fen\u002Fdocs\u002Fwriting\u002Fmermaid","en\u002Fdocs\u002F4.writing\u002F5.mermaid","With `movkNuxtDocs.mermaid` enabled and mermaid and dompurify installed, code blocks in the `mermaid` language render as flowcharts, sequence diagrams, class diagrams and more. Diagrams follow the color mode, load when scrolled into view and support copy and fullscreen.","i-lucide-workflow",{"title":186,"path":187,"stem":188,"category":16,"description":189,"icon":190},"Content Components","\u002Fen\u002Fdocs\u002Fwriting\u002Fcontent-components","en\u002Fdocs\u002F4.writing\u002F6.content-components","Content components the layer adds on top of Nuxt UI prose. Motion adds entrance animations, StarsBg lays an animated star field behind a section, and LandingCover, LandingSection and friends build an editorial landing page. All work directly in Markdown.","i-lucide-sparkle",{"title":192,"category":16,"description":16,"icon":193,"path":194,"stem":195,"children":196,"page":113},"Components","i-lucide-component","\u002Fen\u002Fdocs\u002Fcomponents","en\u002Fdocs\u002F5.components",[197,203,209,215,221,227,233],{"title":198,"path":199,"stem":200,"category":16,"description":201,"icon":202},"ComponentProps","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-props","en\u002Fdocs\u002F5.components\u002F1.component-props","Generate a props table for a Vue component with a single `:component-props` line. Names, defaults, types and JSDoc descriptions come from nuxt-component-meta, so the docs stay in sync with the component.","i-lucide-list",{"title":204,"path":205,"stem":206,"category":16,"description":207,"icon":208},"ComponentSlots","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-slots","en\u002Fdocs\u002F5.components\u002F2.component-slots","List every slot of a Vue component with a single `:component-slots` line. Slot names, scoped parameter types and JSDoc descriptions come from the `defineSlots` type, so there is nothing to write by hand.","i-lucide-layout-panel-left",{"title":210,"path":211,"stem":212,"category":16,"description":213,"icon":214},"ComponentEmits","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-emits","en\u002Fdocs\u002F5.components\u002F3.component-emits","List every event of a Vue component with a single `:component-emits` line. Event names, parameter signatures and JSDoc descriptions come from the `defineEmits` type and complete the API docs next to the props and slots tables.","i-lucide-radio-tower",{"title":216,"path":217,"stem":218,"category":16,"description":219,"icon":220},"ComponentExample","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-example","en\u002Fdocs\u002F5.components\u002F4.component-example","Render a Vue file from the examples directory as a live preview with its highlighted source below. Supports line highlights, collapsing, adjustable options and client-only rendering for showing components in realistic compositions.","i-lucide-app-window",{"title":222,"path":223,"stem":224,"category":16,"description":225,"icon":226},"ComponentCode","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcomponent-code","en\u002Fdocs\u002F5.components\u002F5.component-code","Drive any registered Vue component from a props matrix with `::component-code`. Readers switch prop values above the live preview and the Vue snippet below updates in sync, ready to copy.","i-lucide-sliders-horizontal",{"title":228,"path":229,"stem":230,"category":16,"description":231,"icon":232},"CommitChangelog","\u002Fen\u002Fdocs\u002Fcomponents\u002Fcommit-changelog","en\u002Fdocs\u002F5.components\u002F6.commit-changelog","Fetch the GitHub commit history of a component or source file with `:commit-changelog` and show it as a timeline grouped by release. The file path is inferred from the name and can be tuned by directory, extension, casing and author, or cover several files.","i-lucide-git-commit-horizontal",{"title":234,"path":235,"stem":236,"category":16,"description":237,"icon":238},"PageLastCommit","\u002Fen\u002Fdocs\u002Fcomponents\u002Fpage-last-commit","en\u002Fdocs\u002F5.components\u002F7.page-last-commit","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.","i-lucide-history",{"title":240,"category":16,"description":16,"icon":241,"path":242,"stem":243,"children":244,"page":113},"Reference","i-lucide-book-marked","\u002Fen\u002Fdocs\u002Freference","en\u002Fdocs\u002F6.reference",[245,251,257,332],{"title":246,"path":247,"stem":248,"category":16,"description":249,"icon":250},"app.config Reference","\u002Fen\u002Fdocs\u002Freference\u002Fapp-config","en\u002Fdocs\u002F6.reference\u002F1.app-config","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.","i-lucide-file-cog",{"title":252,"path":253,"stem":254,"category":16,"description":255,"icon":256},"nuxt.config Options","\u002Fen\u002Fdocs\u002Freference\u002Fnuxt-config","en\u002Fdocs\u002F6.reference\u002F2.nuxt-config","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.","i-lucide-settings-2",{"title":258,"category":16,"description":16,"icon":259,"path":260,"stem":261,"children":262,"page":113},"Composables","i-lucide-square-function","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables","en\u002Fdocs\u002F6.reference\u002F3.composables",[263,268,274,280,286,292,298,304,310,315,321,327],{"title":264,"path":265,"stem":266,"category":16,"description":267,"icon":100},"useMovkI18n","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-movk-i18n","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F1.use-movk-i18n","A single i18n entry point that works the same whether or not @nuxtjs\u002Fi18n is enabled. Read the current locale, translate built-in strings, build locale-prefixed links, and get the content collection and docs root for the current locale.",{"title":269,"path":270,"stem":271,"category":16,"description":272,"icon":273},"useLocaleSeo","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-locale-seo","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F10.use-locale-seo","Inject hreflang alternate links, x-default and og:locale on multilingual sites so search engines can tell the language versions apart. The layer's app.vue already calls it globally; call it yourself only when you rewrite app.vue.","i-lucide-globe",{"title":275,"path":276,"stem":277,"category":16,"description":278,"icon":279},"useFetchComponentMeta","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-meta","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F11.use-fetch-component-meta","Read the component metadata generated by nuxt-component-meta, including the types and descriptions of props, slots and events. ComponentProps and the other component docs components are built on it; call it directly to render your own API tables. Available only with component docs enabled.","i-lucide-braces",{"title":281,"path":282,"stem":283,"category":16,"description":284,"icon":285},"useFetchComponentExample","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-example","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F12.use-fetch-component-example","Read the source code, file path and name of example components under components\u002Fcontent\u002Fexamples. ComponentExample uses it to show example code; call it directly to display example source in your own components. Available only with component docs enabled.","i-lucide-file-code",{"title":287,"path":288,"stem":289,"category":16,"description":290,"icon":291},"useDocsNavigation","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-navigation","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F2.use-docs-navigation","Read the docs navigation tree that the shell has already loaded. The header section bar, sidebar and docs pages all take their navigation from here, so custom components reuse the same data without querying the collection again.","i-lucide-list-tree",{"title":293,"path":294,"stem":295,"category":16,"description":296,"icon":297},"useNavigation","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-navigation","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F3.use-navigation","Shape the docs navigation tree for the sidebar - top-level sections, the current section's pages grouped by docs.categories, and breadcrumbs for any path. Use it in a custom sidebar or table of contents to keep the default grouping rules.","i-lucide-panel-left",{"title":299,"path":300,"stem":301,"category":16,"description":302,"icon":303},"useHeader","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-header","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F4.use-header","Provides the desktop and mobile header navigation links. Declare them in header.nav and header.mobileNav in app.config; override the composable with a same-named file in your project only when links must be generated from runtime state.","i-lucide-panel-top",{"title":305,"path":306,"stem":307,"category":16,"description":308,"icon":309},"useCategory","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-category","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F5.use-category","Provides the sidebar category definitions that decide how pages with a category are grouped and ordered within a section. Declare them in docs.categories in app.config; override the composable in your project only when categories must be computed at runtime.","i-lucide-folders",{"title":311,"path":312,"stem":313,"category":16,"description":314,"icon":69},"useTheme","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-theme","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F6.use-theme","The state and actions behind the theme picker - primary color, neutral color, radius, icon set, black as primary and color mode. Visitor choices persist in localStorage and can be exported as app.config or CSS. Use it for a custom theme picker or to switch themes from a page.",{"title":316,"path":317,"stem":318,"category":16,"description":319,"icon":320},"useDocsRoute","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-route","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F7.use-docs-route","Check whether the current route is a docs page, covering \u002Fdocs\u002F* for the default locale and \u002F{locale}\u002Fdocs\u002F* for others. Use it in site-wide components such as a custom header or footer that should show something only on docs pages.","i-lucide-route",{"title":322,"path":323,"stem":324,"category":16,"description":325,"icon":326},"useDocsFilterConfig","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-filter-config","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F8.use-docs-filter-config","Config, visibility check and filter function behind the sidebar navigation filter, mapped to aside.filter in app.config. Use them in a custom sidebar top or sidebar body component to keep the default filtering behavior.","i-lucide-list-filter",{"title":328,"path":329,"stem":330,"category":16,"description":331,"icon":220},"useDocsShell","\u002Fen\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-shell","en\u002Fdocs\u002F6.reference\u002F3.composables\u002F9.use-docs-shell","The site shell shared by app.vue and error.vue. It loads the navigation tree and search index for the current locale, sets the html language, direction, font and grain attributes, and provides navigation to the component tree. Call it directly only when you rewrite app.vue or error.vue.",{"title":333,"path":334,"stem":335,"category":16,"description":336,"icon":337},"A–Z Index","\u002Fen\u002Fdocs\u002Freference\u002Fa-z","en\u002Fdocs\u002F6.reference\u002F9.a-z","Every documentation page listed alphabetically by title. Use it when you remember the name of a feature but not which section it lives in.","i-lucide-list-ordered",{"data":339,"body":340},{},{"type":341,"children":342},"root",[343],{"type":344,"tag":345,"props":346,"children":347},"element","p",{},[348],{"type":349,"value":350},"text","Copyright © 2024 - 2026",{"id":352,"title":108,"body":353,"category":55,"description":111,"difficulty":16,"extension":1078,"index":113,"keywords":16,"links":16,"meta":1079,"navigation":1080,"path":109,"requires":16,"seo":1081,"sitemap":1083,"stem":110,"__hash__":1084},"docs_en\u002Fen\u002Fdocs\u002F2.guide\u002F9.deployment.md",{"type":354,"value":355,"toc":1066},"minimark",[356,361,429,439,453,464,469,480,519,523,614,619,636,640,643,670,680,684,690,715,719,730,800,816,823,832,845,849,852,880,890,894,897,955,969,1039,1042,1046,1062],[357,358,360],"h2",{"id":359},"build","Build",[362,363,365,388,403,415],"code-group",{"sync":364},"package-manager",[366,367,373],"pre",{"className":368,"code":369,"filename":370,"language":371,"meta":372,"style":372},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm build\n","pnpm","bash","",[374,375,376],"code",{"__ignoreMap":372},[377,378,381,384],"span",{"class":379,"line":380},"line",1,[377,382,370],{"class":383},"snPdu",[377,385,387],{"class":386},"sIIMD"," build\n",[366,389,392],{"className":368,"code":390,"filename":391,"language":371,"meta":372,"style":372},"npm run build\n","npm",[374,393,394],{"__ignoreMap":372},[377,395,396,398,401],{"class":379,"line":380},[377,397,391],{"class":383},[377,399,400],{"class":386}," run",[377,402,387],{"class":386},[366,404,407],{"className":368,"code":405,"filename":406,"language":371,"meta":372,"style":372},"yarn build\n","yarn",[374,408,409],{"__ignoreMap":372},[377,410,411,413],{"class":379,"line":380},[377,412,406],{"class":383},[377,414,387],{"class":386},[366,416,419],{"className":368,"code":417,"filename":418,"language":371,"meta":372,"style":372},"bun run build\n","bun",[374,420,421],{"__ignoreMap":372},[377,422,423,425,427],{"class":379,"line":380},[377,424,418],{"class":383},[377,426,400],{"class":386},[377,428,387],{"class":386},[345,430,431,434,435,438],{},[374,432,433],{},"nuxt build"," prerenders the home page and every page reachable through links, and produces the server code in ",[374,436,437],{},".output\u002F",". Preview it locally:",[366,440,443],{"className":368,"code":441,"filename":442,"language":371,"meta":372,"style":372},"node .output\u002Fserver\u002Findex.mjs\n","terminal",[374,444,445],{"__ignoreMap":372},[377,446,447,450],{"class":379,"line":380},[377,448,449],{"class":383},"node",[377,451,452],{"class":386}," .output\u002Fserver\u002Findex.mjs\n",[345,454,455,456,459,460,463],{},"Building and running both need Node.js 22.22.3+ (22.x), 24.15.0+ (24.x), or 26+: Nuxt Content uses the built-in ",[374,457,458],{},"node:sqlite",", so ",[374,461,462],{},"better-sqlite3"," is not required.",[465,466,468],"h3",{"id":467},"catch-dead-links","Catch dead links",[345,470,471,472,475,476,479],{},"The layer sets ",[374,473,474],{},"nitro.prerender.failOnError: false",", so a dead link found during prerendering does not stop the build; it only logs ",[374,477,478],{},"[request error]",". Fail CI on that line instead:",[366,481,483],{"className":368,"code":482,"filename":442,"language":371,"meta":372,"style":372},"pnpm build 2>&1 | tee build.log\n! grep '\\[request error\\]' build.log\n",[374,484,485,505],{"__ignoreMap":372},[377,486,487,489,492,496,499,502],{"class":379,"line":380},[377,488,370],{"class":383},[377,490,491],{"class":386}," build",[377,493,495],{"class":494},"s8jYJ"," 2>&1",[377,497,498],{"class":494}," |",[377,500,501],{"class":383}," tee",[377,503,504],{"class":386}," build.log\n",[377,506,508,511,514,517],{"class":379,"line":507},2,[377,509,510],{"class":494},"!",[377,512,513],{"class":383}," grep",[377,515,516],{"class":386}," '\\[request error\\]'",[377,518,504],{"class":386},[357,520,522],{"id":521},"environment-variables","Environment variables",[524,525,526,542],"table",{},[527,528,529],"thead",{},[530,531,532,536,539],"tr",{},[533,534,535],"th",{},"Variable",[533,537,538],{},"Required",[533,540,541],{},"Description",[543,544,545,570,585,601],"tbody",{},[530,546,547,553,556],{},[548,549,550],"td",{},[374,551,552],{},"NUXT_GITHUB_TOKEN",[548,554,555],{},"In production",[548,557,558,559,564,565,569],{},"GitHub access token. ",[560,561,562],"a",{"href":229},[374,563,228],{}," and ",[560,566,567],{"href":235},[374,568,234],{}," show nothing without it; the releases page can call GitHub anonymously but is limited to 60 requests per hour",[530,571,572,577,580],{},[548,573,574],{},[374,575,576],{},"AI_API_KEY",[548,578,579],{},"No",[548,581,582,583],{},"Master switch for AI Chat: if present at build time, AI Chat is enabled. See ",[560,584,121],{"href":122},[530,586,587,592,594],{},[548,588,589],{},[374,590,591],{},"AI_BASE_URL",[548,593,579],{},[548,595,596,597,600],{},"OpenAI-compatible endpoint such as ",[374,598,599],{},"https:\u002F\u002Fapi.deepseek.com\u002Fv1","; when empty, requests go through the Vercel AI Gateway",[530,602,603,608,611],{},[548,604,605],{},[374,606,607],{},"NUXT_APP_SECRET",[548,609,610],{},"With runtime OG image signing",[548,612,613],{},"A stable private value of at least 32 characters, configured in the production runtime environment",[345,615,616,618],{},[374,617,576],{}," decides at build time whether AI Chat is bundled, and is used at runtime to call the model, so set it in both the build and the runtime environment. The token only needs read access to public repositories.",[345,620,621,622,625,626,628,629,635],{},"The layer enables ",[374,623,624],{},"ogImage.zeroRuntime"," by default, so prerendered OG images do not need an application secret. If you switch to runtime rendering and keep URL signing enabled, configure ",[374,627,607],{}," as described in the ",[560,630,634],{"href":631,"rel":632},"https:\u002F\u002Fnuxtseo.com\u002Fdocs\u002Fog-image\u002Fmigration-guide\u002Fv7#move-signing-to-nuxt_app_secret",[633],"nofollow","OG Image v7 migration guide",".",[357,637,639],{"id":638},"vercel","Vercel",[345,641,642],{},"Vercel detects Nuxt projects, so no build settings need to change after importing the repository:",[644,645,646,650,658],"ol",{},[647,648,649],"li",{},"Create a project on Vercel and import the Git repository;",[647,651,652,653,657],{},"Add the environment variables above under ",[654,655,656],"strong",{},"Settings → Environment Variables",";",[647,659,660,661,663,664,666,667,635],{},"Deploy. The build command is ",[374,662,433],{},", and Nitro picks the ",[374,665,638],{}," preset and writes to ",[374,668,669],{},".vercel\u002Foutput\u002F",[345,671,672,673,675,676,679],{},"With the ",[374,674,638],{}," preset, Markdown content negotiation for ",[560,677,678],{"href":146},"agent discovery"," is rewritten at the edge without invoking a function.",[357,681,683],{"id":682},"netlify","Netlify",[345,685,686,687,689],{},"Netlify also detects Nuxt projects, and Nitro picks the ",[374,688,682],{}," preset in Netlify builds:",[644,691,692,698,712],{},[647,693,694,695,697],{},"Import the Git repository on Netlify and keep ",[374,696,433],{}," as the build command;",[647,699,700,701,704,705,708,709,657],{},"Add the environment variables under ",[654,702,703],{},"Site configuration → Environment variables",", and set ",[374,706,707],{},"NODE_VERSION"," to a supported version listed above, such as ",[374,710,711],{},"24",[647,713,714],{},"Deploy.",[357,716,718],{"id":717},"cloudflare","Cloudflare",[345,720,721,722,725,726,729],{},"Use the ",[374,723,724],{},"cloudflare_module"," preset to deploy to Cloudflare Workers and let Nitro generate the Wrangler configuration with the ",[374,727,728],{},"ASSETS"," binding:",[366,731,736],{"className":732,"code":733,"filename":734,"language":735,"meta":372,"style":372},"language-ts shiki shiki-themes github-light github-light github-dark","export default defineNuxtConfig({\n  nitro: {\n    preset: 'cloudflare_module',\n    cloudflare: { deployConfig: true, nodeCompat: true }\n  }\n})\n","nuxt.config.ts","ts",[374,737,738,753,758,770,788,794],{"__ignoreMap":372},[377,739,740,743,746,749],{"class":379,"line":380},[377,741,742],{"class":494},"export",[377,744,745],{"class":494}," default",[377,747,748],{"class":383}," defineNuxtConfig",[377,750,752],{"class":751},"sxrX7","({\n",[377,754,755],{"class":379,"line":507},[377,756,757],{"class":751},"  nitro: {\n",[377,759,761,764,767],{"class":379,"line":760},3,[377,762,763],{"class":751},"    preset: ",[377,765,766],{"class":386},"'cloudflare_module'",[377,768,769],{"class":751},",\n",[377,771,773,776,780,783,785],{"class":379,"line":772},4,[377,774,775],{"class":751},"    cloudflare: { deployConfig: ",[377,777,779],{"class":778},"sBjJW","true",[377,781,782],{"class":751},", nodeCompat: ",[377,784,779],{"class":778},[377,786,787],{"class":751}," }\n",[377,789,791],{"class":379,"line":790},5,[377,792,793],{"class":751},"  }\n",[377,795,797],{"class":379,"line":796},6,[377,798,799],{"class":751},"})\n",[345,801,802,803,805,806,809,810,812,813,635],{},"The Workers runtime has no ",[374,804,458],{},", so under the Cloudflare preset Nuxt Content switches to a D1 database bound as ",[374,807,808],{},"DB",". Create a D1 database in the Cloudflare dashboard, bind it to the Worker as ",[374,811,808],{},", then deploy. Set environment variables under the Worker's ",[654,814,815],{},"Settings → Variables and Secrets",[345,817,818,819,822],{},"If the MCP Server is enabled, install ",[374,820,821],{},"agents"," for MCP Toolkit's Cloudflare transport.",[345,824,825,826,564,829,635],{},"For prerendered HTML pages, route the page requests through the Worker first so Nitro can negotiate Markdown. Test the same URL with both ",[374,827,828],{},"Accept: text\u002Fhtml",[374,830,831],{},"Accept: text\u002Fmarkdown",[833,834,835,836,839,840,635],"note",{},"For the full Cloudflare walkthrough and ",[374,837,838],{},"wrangler"," configuration, see the ",[560,841,844],{"href":842,"rel":843},"https:\u002F\u002Fnuxt.com\u002Fdeploy\u002Fcloudflare",[633],"Nuxt deployment docs",[357,846,848],{"id":847},"nodejs-server","Node.js server",[345,850,851],{},"Run the build output on any server with one of the supported Node.js versions above:",[366,853,855],{"className":368,"code":854,"filename":442,"language":371,"meta":372,"style":372},"NUXT_GITHUB_TOKEN=xxx PORT=3000 node .output\u002Fserver\u002Findex.mjs\n",[374,856,857],{"__ignoreMap":372},[377,858,859,861,864,867,870,872,875,878],{"class":379,"line":380},[377,860,552],{"class":751},[377,862,863],{"class":494},"=",[377,865,866],{"class":386},"xxx",[377,868,869],{"class":751}," PORT",[377,871,863],{"class":494},[377,873,874],{"class":386},"3000",[377,876,877],{"class":383}," node",[377,879,452],{"class":386},[345,881,882,883,885,886,889],{},"Copy the whole ",[374,884,437],{}," directory to the server; ",[374,887,888],{},"node_modules"," is not needed at runtime.",[357,891,893],{"id":892},"static-generation","Static generation",[345,895,896],{},"When no server is needed, generate a fully static site and deploy it to GitHub Pages, object storage or any static host:",[362,898,899,914,928,941],{"sync":364},[366,900,902],{"className":368,"code":901,"filename":370,"language":371,"meta":372,"style":372},"pnpm nuxt generate\n",[374,903,904],{"__ignoreMap":372},[377,905,906,908,911],{"class":379,"line":380},[377,907,370],{"class":383},[377,909,910],{"class":386}," nuxt",[377,912,913],{"class":386}," generate\n",[366,915,917],{"className":368,"code":916,"filename":391,"language":371,"meta":372,"style":372},"npx nuxt generate\n",[374,918,919],{"__ignoreMap":372},[377,920,921,924,926],{"class":379,"line":380},[377,922,923],{"class":383},"npx",[377,925,910],{"class":386},[377,927,913],{"class":386},[366,929,931],{"className":368,"code":930,"filename":406,"language":371,"meta":372,"style":372},"yarn nuxt generate\n",[374,932,933],{"__ignoreMap":372},[377,934,935,937,939],{"class":379,"line":380},[377,936,406],{"class":383},[377,938,910],{"class":386},[377,940,913],{"class":386},[366,942,944],{"className":368,"code":943,"filename":418,"language":371,"meta":372,"style":372},"bunx nuxt generate\n",[374,945,946],{"__ignoreMap":372},[377,947,948,951,953],{"class":379,"line":380},[377,949,950],{"class":383},"bunx",[377,952,910],{"class":386},[377,954,913],{"class":386},[345,956,957,958,961,962,964,965,968],{},"The output is in ",[374,959,960],{},".output\u002Fpublic\u002F",". Pages, full-text search, component props and examples, ",[374,963,139],{},", ",[374,966,967],{},"sitemap.xml"," and OG images are all produced at build time and work on static hosting. These features need a server and are unavailable on a static site:",[524,970,971,981],{},[527,972,973],{},[530,974,975,978],{},[533,976,977],{},"Feature",[533,979,980],{},"Reason",[543,982,983,996,1008,1027],{},[530,984,985,989],{},[548,986,987],{},[560,988,121],{"href":122},[548,990,991,992,995],{},"Conversations call the model through ",[374,993,994],{},"\u002Fapi\u002Fai-chat"," at runtime",[530,997,998,1002],{},[548,999,1000],{},[560,1001,127],{"href":128},[548,1003,1004,1007],{},[374,1005,1006],{},"\u002Fmcp"," is a runtime endpoint",[530,1009,1010,1020],{},[548,1011,1012,964,1016],{},[560,1013,1014],{"href":229},[374,1015,228],{},[560,1017,1018],{"href":235},[374,1019,234],{},[548,1021,1022,1023,1026],{},"They request ",[374,1024,1025],{},"\u002Fapi\u002Fgithub\u002F*"," from the browser, and a static site has no such endpoints",[530,1028,1029,1032],{},[548,1030,1031],{},"Markdown content negotiation",[548,1033,1034,1035,1038],{},"Returning Markdown based on the ",[374,1036,1037],{},"Accept"," header needs server middleware or an edge rewrite",[345,1040,1041],{},"Release data on the releases page is fetched during prerendering and baked into the page; it does not follow GitHub until the next build.",[357,1043,1045],{"id":1044},"resources","Resources",[1047,1048,1049,1055],"ul",{},[647,1050,1051],{},[560,1052,844],{"href":1053,"rel":1054},"https:\u002F\u002Fnuxt.com\u002Fdeploy",[633],[647,1056,1057],{},[560,1058,1061],{"href":1059,"rel":1060},"https:\u002F\u002Fnitro.build\u002Fdeploy",[633],"Nitro deployment guide",[1063,1064,1065],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":372,"searchDepth":507,"depth":507,"links":1067},[1068,1071,1072,1073,1074,1075,1076,1077],{"id":359,"depth":507,"text":360,"children":1069},[1070],{"id":467,"depth":760,"text":468},{"id":521,"depth":507,"text":522},{"id":638,"depth":507,"text":639},{"id":682,"depth":507,"text":683},{"id":717,"depth":507,"text":718},{"id":847,"depth":507,"text":848},{"id":892,"depth":507,"text":893},{"id":1044,"depth":507,"text":1045},"md",{},{"icon":112},{"title":108,"description":1082},"Deploy Movk Nuxt Docs to Vercel, Netlify, Cloudflare, a Node.js server or static hosting, with build commands, environment variables and static limits.",{"loc":109},"ZO5MDuQcZoKi89XDYIWDpOXw-BYIdm87QP0TknMZKEU",[1086,1087],{"title":102,"path":103,"stem":104,"description":105,"icon":106,"children":-1},{"title":121,"path":122,"stem":123,"description":124,"icon":125,"children":-1},{"data":1089,"body":1090},{},{"type":341,"children":1091},[1092],{"type":344,"tag":345,"props":1093,"children":1094},{},[1095],{"type":349,"value":111},1794996151201]