docus 5.5.0 → 5.6.0

package/app/app.vue

@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
+import { transformNavigation } from './utils/navigation'
 
 const { seo } = useAppConfig()
 const site = useSiteConfig()
@@ -45,11 +46,7 @@ if (isEnabled.value) {
 }
 
 const { data: navigation } = await useAsyncData(() => `navigation_${collectionName.value}`, () => queryCollectionNavigation(collectionName.value as keyof PageCollections), {
-  transform: (data: ContentNavigationItem[]) => {
-    const rootResult = data.find(item => item.path === '/docs')?.children || data || []
-
-    return rootResult.find((item: ContentNavigationItem) => item.path === `/${locale.value}`)?.children || rootResult
-  },
+  transform: (data: ContentNavigationItem[]) => transformNavigation(data, isEnabled.value, locale.value),
   watch: [locale],
 })
 const { data: files } = useLazyAsyncData(`search_${collectionName.value}`, () => queryCollectionSearchSections(collectionName.value as keyof PageCollections), {
@@ -81,8 +78,8 @@ provide('navigation', navigation)
         :navigation="navigation"
       />
       <template v-if="isAssistantEnabled">
-        <LazyAssistantFloatingInput />
         <LazyAssistantPanel />
+        <LazyAssistantFloatingInput />
       </template>
     </ClientOnly>
   </UApp>

package/app/composables/useSeo.ts

@@ -0,0 +1,207 @@
+import type { MaybeRefOrGetter } from 'vue'
+import type { BreadcrumbItem } from '../utils/navigation'
+import { joinURL, withoutTrailingSlash } from 'ufo'
+
+export interface UseSeoOptions {
+  /**
+   * Page title
+   */
+  title: MaybeRefOrGetter<string | undefined>
+  /**
+   * Page description
+   */
+  description: MaybeRefOrGetter<string | undefined>
+  /**
+   * Page type for og:type (default: 'article' for docs, 'website' for landing)
+   */
+  type?: MaybeRefOrGetter<'website' | 'article'>
+  /**
+   * Custom OG image URL (absolute)
+   */
+  ogImage?: MaybeRefOrGetter<string | undefined>
+  /**
+   * Published date for article schema
+   */
+  publishedAt?: MaybeRefOrGetter<string | undefined>
+  /**
+   * Modified date for article schema
+   */
+  modifiedAt?: MaybeRefOrGetter<string | undefined>
+  /**
+   * Breadcrumb items for BreadcrumbList schema
+   */
+  breadcrumbs?: MaybeRefOrGetter<BreadcrumbItem[] | undefined>
+}
+
+/**
+ * Composable for comprehensive SEO setup including:
+ * - Meta tags (title, description, og:*, twitter:*)
+ * - Canonical URLs
+ * - Hreflang tags for i18n
+ * - JSON-LD structured data
+ */
+export function useSeo(options: UseSeoOptions) {
+  const route = useRoute()
+  const site = useSiteConfig()
+  const { locale, locales, isEnabled: isI18nEnabled, switchLocalePath } = useDocusI18n()
+
+  const title = computed(() => toValue(options.title))
+  const description = computed(() => toValue(options.description))
+  const type = computed(() => toValue(options.type) || 'article')
+  const ogImage = computed(() => toValue(options.ogImage))
+  const publishedAt = computed(() => toValue(options.publishedAt))
+  const modifiedAt = computed(() => toValue(options.modifiedAt))
+  const breadcrumbs = computed(() => toValue(options.breadcrumbs))
+
+  // Build canonical URL
+  const canonicalUrl = computed(() => {
+    if (!site.url) return undefined
+    return joinURL(site.url, route.path)
+  })
+
+  // Base URL for building other URLs
+  const baseUrl = computed(() => site.url ? withoutTrailingSlash(site.url) : '')
+
+  // Set meta tags
+  useSeoMeta({
+    title,
+    description,
+    ogTitle: title,
+    ogDescription: description,
+    ogType: type,
+    ogUrl: canonicalUrl,
+    ogLocale: computed(() => isI18nEnabled.value ? locale.value : undefined),
+  })
+
+  // Set canonical link
+  useHead({
+    link: computed(() => {
+      const links: Array<{ rel: string, href?: string, hreflang?: string }> = []
+
+      // Canonical URL
+      if (canonicalUrl.value) {
+        links.push({
+          rel: 'canonical',
+          href: canonicalUrl.value,
+        })
+      }
+
+      // Hreflang tags for i18n
+      if (isI18nEnabled.value && baseUrl.value) {
+        for (const loc of locales) {
+          const localePath = switchLocalePath(loc.code)
+          if (localePath) {
+            links.push({
+              rel: 'alternate',
+              hreflang: loc.code,
+              href: joinURL(baseUrl.value, localePath),
+            })
+          }
+        }
+
+        // x-default hreflang (points to default locale)
+        const defaultLocalePath = switchLocalePath(locales[0]?.code || 'en')
+        if (defaultLocalePath) {
+          links.push({
+            rel: 'alternate',
+            hreflang: 'x-default',
+            href: joinURL(baseUrl.value, defaultLocalePath),
+          })
+        }
+      }
+
+      return links
+    }),
+  })
+
+  // Custom OG image handling
+  if (ogImage.value) {
+    useSeoMeta({
+      ogImage: ogImage.value,
+      twitterImage: ogImage.value,
+    })
+  }
+
+  // JSON-LD structured data
+  useHead({
+    script: computed(() => {
+      const scripts: Array<{ type: string, innerHTML: string }> = []
+
+      if (!baseUrl.value || !title.value) return scripts
+
+      const pageUrl = joinURL(baseUrl.value, route.path)
+
+      // Article schema for documentation pages
+      if (type.value === 'article') {
+        const articleSchema: Record<string, unknown> = {
+          '@context': 'https://schema.org',
+          '@type': 'Article',
+          'headline': title.value,
+          'description': description.value,
+          'url': pageUrl,
+          'mainEntityOfPage': {
+            '@type': 'WebPage',
+            '@id': pageUrl,
+          },
+        }
+
+        if (publishedAt.value) {
+          articleSchema.datePublished = publishedAt.value
+        }
+
+        if (modifiedAt.value) {
+          articleSchema.dateModified = modifiedAt.value
+        }
+
+        if (site.name) {
+          articleSchema.publisher = {
+            '@type': 'Organization',
+            'name': site.name,
+          }
+        }
+
+        scripts.push({
+          type: 'application/ld+json',
+          innerHTML: JSON.stringify(articleSchema),
+        })
+      }
+
+      // WebSite schema for landing pages
+      if (type.value === 'website') {
+        const websiteSchema: Record<string, unknown> = {
+          '@context': 'https://schema.org',
+          '@type': 'WebSite',
+          'name': site.name || title.value,
+          'description': description.value,
+          'url': baseUrl.value,
+        }
+
+        scripts.push({
+          type: 'application/ld+json',
+          innerHTML: JSON.stringify(websiteSchema),
+        })
+      }
+
+      // BreadcrumbList schema for navigation
+      if (breadcrumbs.value && breadcrumbs.value.length > 0) {
+        const breadcrumbSchema = {
+          '@context': 'https://schema.org',
+          '@type': 'BreadcrumbList',
+          'itemListElement': breadcrumbs.value.map((item, index) => ({
+            '@type': 'ListItem',
+            'position': index + 1,
+            'name': item.title,
+            'item': joinURL(baseUrl.value, item.path),
+          })),
+        }
+
+        scripts.push({
+          type: 'application/ld+json',
+          innerHTML: JSON.stringify(breadcrumbSchema),
+        })
+      }
+
+      return scripts
+    }),
+  })
+}

package/app/error.vue

@@ -2,6 +2,7 @@
 import type { NuxtError } from '#app'
 import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
+import { transformNavigation } from './utils/navigation'
 
 const props = defineProps<{
   error: NuxtError
@@ -47,11 +48,7 @@ if (isEnabled.value) {
 const collectionName = computed(() => isEnabled.value ? `docs_${locale.value}` : 'docs')
 
 const { data: navigation } = await useAsyncData(`navigation_${collectionName.value}`, () => queryCollectionNavigation(collectionName.value as keyof PageCollections), {
-  transform: (data: ContentNavigationItem[]) => {
-    const rootResult = data.find(item => item.path === '/docs')?.children || data || []
-
-    return rootResult.find(item => item.path === `/${locale.value}`)?.children || rootResult
-  },
+  transform: (data: ContentNavigationItem[]) => transformNavigation(data, isEnabled.value, locale.value),
   watch: [locale],
 })
 const { data: files } = useLazyAsyncData(`search_${collectionName.value}`, () => queryCollectionSearchSections(collectionName.value as keyof PageCollections), {

package/app/pages/[[lang]]/[...slug].vue

@@ -31,14 +31,16 @@ if (!page.value) {
 const title = page.value.seo?.title || page.value.title
 const description = page.value.seo?.description || page.value.description
 
-useSeoMeta({
+const headline = ref(findPageHeadline(navigation?.value, page.value?.path))
+const breadcrumbs = computed(() => findPageBreadcrumbs(navigation?.value, page.value?.path || ''))
+
+useSeo({
   title,
-  ogTitle: title,
   description,
-  ogDescription: description,
+  type: 'article',
+  modifiedAt: (page.value as unknown as Record<string, unknown>).modifiedAt as string | undefined,
+  breadcrumbs,
 })
-
-const headline = ref(findPageHeadline(navigation?.value, page.value?.path))
 watch(() => navigation?.value, () => {
   headline.value = findPageHeadline(navigation?.value, page.value?.path) || headline.value
 })
@@ -99,9 +101,8 @@ addPrerenderPath(`/raw${route.path}.md`)
         :value="page"
       />
 
-      <USeparator>
+      <USeparator v-if="github">
         <div
-          v-if="github"
           class="flex items-center gap-2 text-sm text-muted"
         >
           <UButton

package/app/templates/landing.vue

@@ -15,20 +15,14 @@ if (!page.value) {
 const title = page.value.seo?.title || page.value.title
 const description = page.value.seo?.description || page.value.description
 
-useSeoMeta({
+useSeo({
   title,
   description,
-  ogTitle: title,
-  ogDescription: description,
+  type: 'website',
+  ogImage: page.value?.seo?.ogImage as string | undefined,
 })
 
-if (page.value?.seo?.ogImage) {
-  useSeoMeta({
-    ogImage: page.value.seo.ogImage,
-    twitterImage: page.value.seo.ogImage,
-  })
-}
-else {
+if (!page.value?.seo?.ogImage) {
   defineOgImageComponent('Landing', {
     title,
     description,

package/app/utils/navigation.ts

@@ -5,3 +5,53 @@ export const flattenNavigation = (items?: ContentNavigationItem[]): ContentNavig
     ? flattenNavigation(item.children)
     : [item],
 ) || []
+
+/**
+ * Transform navigation data by stripping locale and docs levels
+ */
+export function transformNavigation(
+  data: ContentNavigationItem[],
+  isI18nEnabled: boolean,
+  locale?: string,
+): ContentNavigationItem[] {
+  if (isI18nEnabled && locale) {
+    // i18n: first strip locale level, then check for docs level
+    const localeResult = data.find(item => item.path === `/${locale}`)?.children || data
+    return localeResult.find(item => item.path === `/${locale}/docs`)?.children || localeResult
+  }
+  else {
+    // non-i18n: strip docs level if exists
+    return data.find(item => item.path === '/docs')?.children || data
+  }
+}
+
+export interface BreadcrumbItem {
+  title: string
+  path: string
+}
+
+/**
+ * Find breadcrumb path to a page in the navigation tree
+ */
+export function findPageBreadcrumbs(
+  navigation: ContentNavigationItem[] | undefined,
+  path: string,
+  currentPath: BreadcrumbItem[] = [],
+): BreadcrumbItem[] | undefined {
+  if (!navigation) return undefined
+
+  for (const item of navigation) {
+    const itemPath = [...currentPath, { title: item.title, path: item.path }]
+
+    if (item.path === path) {
+      return itemPath
+    }
+
+    if (item.children) {
+      const found = findPageBreadcrumbs(item.children, path, itemPath)
+      if (found) return found
+    }
+  }
+
+  return undefined
+}

package/content.config.ts

@@ -2,11 +2,15 @@ import type { DefinedCollection } from '@nuxt/content'
 import { defineContentConfig, defineCollection, z } from '@nuxt/content'
 import { useNuxt } from '@nuxt/kit'
 import { joinURL } from 'ufo'
+import { landingPageExists, docsFolderExists } from './utils/pages'
 
 const { options } = useNuxt()
 const cwd = joinURL(options.rootDir, 'content')
 const locales = options.i18n?.locales
 
+const hasLandingPage = landingPageExists(options.rootDir)
+const hasDocsFolder = docsFolderExists(options.rootDir)
+
 const createDocsSchema = () => z.object({
   links: z.array(z.object({
     label: z.string(),
@@ -22,21 +26,24 @@ if (locales && Array.isArray(locales)) {
   collections = {}
   for (const locale of locales) {
     const code = (typeof locale === 'string' ? locale : locale.code).replace('-', '_')
+    const hasLocaleDocs = docsFolderExists(options.rootDir, code)
 
-    collections[`landing_${code}`] = defineCollection({
-      type: 'page',
-      source: {
-        cwd,
-        include: `${code}/index.md`,
-      },
-    })
+    if (!hasLandingPage) {
+      collections[`landing_${code}`] = defineCollection({
+        type: 'page',
+        source: {
+          cwd,
+          include: `${code}/index.md`,
+        },
+      })
+    }
 
     collections[`docs_${code}`] = defineCollection({
       type: 'page',
       source: {
         cwd,
-        include: `${code}/**/*`,
-        prefix: `/${code}`,
+        include: hasLocaleDocs ? `${code}/docs/**` : `${code}/**/*`,
+        prefix: hasLocaleDocs ? `/${code}/docs` : `/${code}`,
         exclude: [`${code}/index.md`],
       },
       schema: createDocsSchema(),
@@ -45,22 +52,27 @@ if (locales && Array.isArray(locales)) {
 }
 else {
   collections = {
-    landing: defineCollection({
+    docs: defineCollection({
       type: 'page',
       source: {
         cwd,
-        include: 'index.md',
+        include: hasDocsFolder ? 'docs/**' : '**',
+        prefix: hasDocsFolder ? '/docs' : undefined,
+        exclude: ['index.md'],
       },
+      schema: createDocsSchema(),
     }),
-    docs: defineCollection({
+  }
+
+  // Only define landing collection if user doesn't have their own index.vue
+  if (!hasLandingPage) {
+    collections.landing = defineCollection({
       type: 'page',
       source: {
         cwd,
-        include: '**',
-        exclude: ['index.md'],
+        include: 'index.md',
       },
-      schema: createDocsSchema(),
-    }),
+    })
   }
 }
 

package/modules/assistant/index.ts

@@ -67,7 +67,7 @@ export default defineNuxtModule<AssistantModuleOptions>({
     )
 
     if (!hasApiKey) {
-      log.warn('[Docus] AI assistant disabled: AI_GATEWAY_API_KEY not found')
+      log.warn('AI assistant disabled: AI_GATEWAY_API_KEY not found')
       return
     }
 

package/modules/assistant/runtime/components/AssistantFloatingInput.vue

@@ -18,7 +18,7 @@ const placeholder = computed(() => t('assistant.placeholder'))
 const shortcutDisplayKeys = computed(() => {
   const shortcut = focusInputShortcut.value
   const parts = shortcut.split('_')
-  return parts.map(part => part === 'meta' ? 'meta' : part.toUpperCase())
+  return parts.map((part: string) => part === 'meta' ? 'meta' : part.toUpperCase())
 })
 
 function handleSubmit() {
@@ -62,43 +62,48 @@ defineShortcuts(shortcuts)
       :animate="{ y: 0, opacity: 1 }"
       :exit="{ y: 100, opacity: 0 }"
       :transition="{ duration: 0.2, ease: 'easeOut' }"
-      class="fixed bottom-6 left-1/2 -translate-x-1/2 z-50 px-4"
+      class="pointer-events-none fixed inset-x-0 z-10 bottom-[max(1.5rem,env(safe-area-inset-bottom))] px-4 sm:px-80"
       style="will-change: transform"
     >
-      <form @submit.prevent="handleSubmit">
-        <UInput
-          ref="inputRef"
-          v-model="input"
-          :placeholder="placeholder"
-          size="lg"
-          maxlength="1000"
-          :ui="{
-            root: 'group w-72 focus-within:w-96 transition-all duration-300 ease-out hover:scale-105 focus-within:scale-105',
-            base: 'bg-default shadow-lg rounded-xl',
-            trailing: 'pe-2',
-          }"
-          @keydown.enter.exact.prevent="handleSubmit"
-        >
-          <template #trailing>
-            <div class="flex items-center gap-2">
-              <div class="hidden sm:flex group-focus-within:hidden items-center gap-1">
-                <UKbd
-                  v-for="key in shortcutDisplayKeys"
-                  :key="key"
-                  :value="key"
+      <form
+        class="pointer-events-none flex w-full justify-center"
+        @submit.prevent="handleSubmit"
+      >
+        <div class="pointer-events-auto w-full max-w-96">
+          <UInput
+            ref="inputRef"
+            v-model="input"
+            :placeholder="placeholder"
+            size="lg"
+            maxlength="1000"
+            :ui="{
+              root: 'group w-full! min-w-0 sm:max-w-96 transition-all duration-300 ease-out [@media(hover:hover)]:hover:scale-105 [@media(hover:hover)]:focus-within:scale-105',
+              base: 'bg-default shadow-lg rounded-xl text-base',
+              trailing: 'pe-2',
+            }"
+            @keydown.enter.exact.prevent="handleSubmit"
+          >
+            <template #trailing>
+              <div class="flex items-center gap-2">
+                <div class="hidden sm:flex group-focus-within:hidden items-center gap-1">
+                  <UKbd
+                    v-for="key in shortcutDisplayKeys"
+                    :key="key"
+                    :value="key"
+                  />
+                </div>
+
+                <UButton
+                  type="submit"
+                  icon="i-lucide-arrow-up"
+                  color="primary"
+                  size="xs"
+                  :disabled="!input.trim()"
                 />
               </div>
-
-              <UButton
-                type="submit"
-                icon="i-lucide-arrow-up"
-                color="primary"
-                size="xs"
-                :disabled="!input.trim()"
-              />
-            </div>
-          </template>
-        </UInput>
+            </template>
+          </UInput>
+        </div>
       </form>
     </motion.div>
   </AnimatePresence>

package/modules/assistant/runtime/components/AssistantPanel.vue

@@ -263,7 +263,7 @@ onMounted(() => {
           maxlength="1000"
           :ui="{
             root: 'shadow-none!',
-            body: '*:p-0! *:rounded-none! *:text-sm!',
+            body: '*:p-0! *:rounded-none! *:text-base!',
           }"
           @submit="handleSubmit"
         >

package/modules/config.ts

@@ -16,7 +16,7 @@ export default defineNuxtModule({
     const url = inferSiteURL()
     const meta = await getPackageJsonMetadata(dir)
     const gitInfo = await getLocalGitInfo(dir) || getGitEnv()
-    const siteName = nuxt.options?.site?.name || meta.name || gitInfo?.name || ''
+    const siteName = (typeof nuxt.options.site === 'object' && nuxt.options.site?.name) || meta.name || gitInfo?.name || ''
 
     nuxt.options.llms = defu(nuxt.options.llms, {
       domain: url,

package/modules/css.ts

@@ -29,6 +29,8 @@ export default defineNuxtModule({
       },
     })
 
-    nuxt.options.css.unshift(cssTemplate.dst)
+    if (Array.isArray(nuxt.options.css)) {
+      nuxt.options.css.unshift(cssTemplate.dst)
+    }
   },
 })

package/modules/routing.ts

@@ -1,4 +1,5 @@
 import { defineNuxtModule, extendPages, createResolver } from '@nuxt/kit'
+import { landingPageExists } from '../utils/pages'
 
 export default defineNuxtModule({
   meta: {
@@ -19,23 +20,26 @@ export default defineNuxtModule({
       })
     })
 
-    extendPages((pages) => {
-      const landingTemplate = resolve('../app/templates/landing.vue')
+    // Only add landing if index.vue is not already defined
+    if (!landingPageExists(nuxt.options.rootDir)) {
+      extendPages((pages) => {
+        const landingTemplate = resolve('../app/templates/landing.vue')
 
-      if (isI18nEnabled) {
-        pages.push({
-          name: 'lang-index',
-          path: '/:lang?',
-          file: landingTemplate,
-        })
-      }
-      else {
-        pages.push({
-          name: 'index',
-          path: '/',
-          file: landingTemplate,
-        })
-      }
-    })
+        if (isI18nEnabled) {
+          pages.push({
+            name: 'lang-index',
+            path: '/:lang?',
+            file: landingTemplate,
+          })
+        }
+        else {
+          pages.push({
+            name: 'index',
+            path: '/',
+            file: landingTemplate,
+          })
+        }
+      })
+    }
   },
 })

package/nuxt.config.ts

@@ -20,14 +20,16 @@ export default defineNuxtConfig({
       extendViteConfig((config) => {
         config.optimizeDeps ||= {}
         config.optimizeDeps.include ||= []
-        config.optimizeDeps.include.push(
-          '@nuxt/content > slugify',
-          // Fix @vercel/oidc ESM export issue (transitive dep of @ai-sdk/gateway)
-          '@vercel/oidc',
-        )
+        config.optimizeDeps.include.push('@nuxt/content > slugify')
         config.optimizeDeps.include = config.optimizeDeps.include
           .map(id => id.replace(/^@nuxt\/content > /, 'docus > @nuxt/content > '))
-          .map(id => id.replace(/^@vercel\/oidc$/, 'docus > @vercel/oidc'))
+
+        // Fix @vercel/oidc ESM export issue (transitive dep of @ai-sdk/gateway)
+        // Only needed when AI assistant is enabled.
+        if (process.env.AI_GATEWAY_API_KEY) {
+          config.optimizeDeps.include.push('@vercel/oidc')
+          config.optimizeDeps.include.map(id => id.replace(/^@vercel\/oidc$/, 'docus > @vercel/oidc'))
+        }
       })
     },
   ],
@@ -35,6 +37,7 @@ export default defineNuxtConfig({
     enabled: true,
   },
   content: {
+    experimental: { sqliteConnector: 'native' },
     build: {
       markdown: {
         highlight: {
@@ -93,4 +96,13 @@ export default defineNuxtConfig({
   icon: {
     provider: 'iconify',
   },
+  robots: {
+    groups: [
+      {
+        userAgent: '*',
+        allow: '/',
+      },
+    ],
+    sitemap: '/sitemap.xml',
+  },
 })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.5.0",
+  "version": "5.6.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,27 +22,27 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.32",
-    "@ai-sdk/mcp": "^1.0.18",
-    "@ai-sdk/vue": "3.0.69",
-    "@iconify-json/lucide": "^1.2.88",
-    "@iconify-json/simple-icons": "^1.2.69",
-    "@iconify-json/vscode-icons": "^1.2.40",
-    "@nuxt/content": "^3.11.0",
+    "@ai-sdk/gateway": "^3.0.46",
+    "@ai-sdk/mcp": "^1.0.21",
+    "@ai-sdk/vue": "3.0.86",
+    "@iconify-json/lucide": "^1.2.91",
+    "@iconify-json/simple-icons": "^1.2.71",
+    "@iconify-json/vscode-icons": "^1.2.43",
+    "@nuxt/content": "^3.11.2",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.3.0",
+    "@nuxt/kit": "^4.3.1",
     "@nuxt/ui": "^4.4.0",
-    "@nuxtjs/i18n": "^10.2.1",
-    "@nuxtjs/mcp-toolkit": "^0.6.2",
-    "@nuxtjs/mdc": "^0.20.0",
+    "@nuxtjs/i18n": "^10.2.3",
+    "@nuxtjs/mcp-toolkit": "^0.7.0",
+    "@nuxtjs/mdc": "^0.20.1",
     "@nuxtjs/robots": "^5.7.0",
-    "@vueuse/core": "^14.2.0",
-    "ai": "6.0.69",
+    "@vueuse/core": "^14.2.1",
+    "ai": "6.0.86",
     "defu": "^6.1.4",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
-    "minimark": "^0.2.0",
-    "motion-v": "^1.10.2",
+    "minimark": "^1.0.0",
+    "motion-v": "^1.10.3",
     "nuxt-llms": "^0.2.0",
     "nuxt-og-image": "^5.1.13",
     "pkg-types": "^2.3.0",

package/server/routes/sitemap.xml.ts

@@ -2,6 +2,11 @@ import { queryCollection } from '@nuxt/content/server'
 import { getAvailableLocales, getCollectionsToQuery } from '../utils/content'
 import { inferSiteURL } from '../../utils/meta'
 
+interface SitemapUrl {
+  loc: string
+  lastmod?: string
+}
+
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig(event)
   const siteUrl = inferSiteURL() || ''
@@ -18,7 +23,7 @@ export default defineEventHandler(async (event) => {
     collections.push('landing')
   }
 
-  const urls: Array<{ loc: string }> = []
+  const urls: SitemapUrl[] = []
 
   for (const collection of collections) {
     try {
@@ -34,9 +39,16 @@ export default defineEventHandler(async (event) => {
         // Skip .navigation files (used for navigation configuration)
         if (pagePath.endsWith('.navigation') || pagePath.includes('/.navigation')) continue
 
-        urls.push({
+        const urlEntry: SitemapUrl = {
           loc: pagePath,
-        })
+        }
+
+        // Add lastmod if available (modifiedAt from content)
+        if (meta.modifiedAt && typeof meta.modifiedAt === 'string') {
+          urlEntry.lastmod = meta.modifiedAt.split('T')[0] // Use date part only (YYYY-MM-DD)
+        }
+
+        urls.push(urlEntry)
       }
     }
     catch {
@@ -50,11 +62,18 @@ export default defineEventHandler(async (event) => {
   return sitemap
 })
 
-function generateSitemap(urls: Array<{ loc: string }>, siteUrl: string): string {
+function generateSitemap(urls: SitemapUrl[], siteUrl: string): string {
   const urlEntries = urls
     .map((url) => {
       const loc = siteUrl ? `${siteUrl}${url.loc}` : url.loc
-      return `  <url>\n    <loc>${escapeXml(loc)}</loc>\n  </url>`
+      let entry = `  <url>\n    <loc>${escapeXml(loc)}</loc>`
+
+      if (url.lastmod) {
+        entry += `\n    <lastmod>${escapeXml(url.lastmod)}</lastmod>`
+      }
+
+      entry += `\n  </url>`
+      return entry
     })
     .join('\n')
 

package/utils/pages.ts

@@ -0,0 +1,22 @@
+import { existsSync } from 'node:fs'
+import { joinURL } from 'ufo'
+
+/**
+ * Checks if the user has their own index.vue file in the pages folder.
+ * When true, the layer should not define the landing collection and / route.
+ */
+export function landingPageExists(rootDir: string): boolean {
+  const vueLandingPath = joinURL(rootDir, 'app', 'pages', 'index.vue')
+  return existsSync(vueLandingPath)
+}
+
+/**
+ * Checks if a docs folder exists in the content directory.
+ * When true, docs should be prefixed with /docs and only include files from the docs folder.
+ */
+export function docsFolderExists(rootDir: string, locale?: string): boolean {
+  const docsPath = locale
+    ? joinURL(rootDir, 'content', locale, 'docs')
+    : joinURL(rootDir, 'content', 'docs')
+  return existsSync(docsPath)
+}