docus 3.1.0-20250617-135133-677078f → 4.0.0-beta.1

package/README.md

@@ -1,52 +1,91 @@
-[![docus](https://docus-puce.vercel.app/__og-image__/static/og.png)](https://docus.dev)
+# docus
 
-[![npm version][npm-version-src]][npm-version-href]
-[![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![License][license-src]][license-href]
-[![Nuxt][nuxt-src]][nuxt-href]
+> A minimal and beautiful Nuxt layer for documentation websites
 
-# Docus
+[![npm version](https://img.shields.io/npm/v/docus.svg)](https://www.npmjs.com/package/docus)
+[![npm downloads](https://img.shields.io/npm/dm/docus.svg)](https://www.npmjs.com/package/docus)
 
-Documentation Theme and CLI to write beautiful docs with Markdown.
+This is the official Nuxt layer for [Docus](https://docus.dev), providing a complete documentation theming. It works with the [Docus CLI](https://github.com/nuxtlabs/docus) for rapid project setup.
 
-Ship fast, flexible, and SEO-optimized documentation with beautiful design out of the box. Docus brings together the best of the Nuxt ecosystem:
-- [Nuxt 3](https://nuxt.com)
-- [Nuxt Content](https://content.nuxt.com/)
-- [Nuxt UI](https://ui.nuxt.com/)
-- [Nuxt Image](https://image.nuxt.com/)
-- [Nuxt LLMs](https://github.com/nuxtlabs/nuxt-llms)
-- [UnJS ecosystem](https://unjs.io/)
-- [Nuxt Studio](https://content.nuxt.com/studio) 
+## 🚀 Features
 
-## Contribution
+- ✨ **Beautiful Design** - Clean, modern documentation theme
+- 📱 **Responsive** - Mobile-first responsive design
+- 🌙 **Dark Mode** - Built-in dark/light mode support
+- 🔍 **Search** - Full-text search functionality
+- 📝 **Markdown Enhanced** - Extended markdown with custom components
+- 🎨 **Customizable** - Easy theming and customization
+- ⚡ **Fast** - Optimized for performance
+- 🔧 **TypeScript** - Full TypeScript support
+- 🛠️ **CLI Integration** - Works with Docus CLI for quick project setup
 
-<details>
-  <summary>Local development</summary>
+## 📦 Installation
 
-- Clone this repository
-- Install the latest LTS version of [Node.js](https://nodejs.org/en/)
-- Install dependencies using `pnpm install`
-- Run prepare command using `pnpm run dev:prepare`
-- Run dev documentation built on top of Docus using `pnpm run dev`
+```bash
+npm install docus
+```
 
-</details>
+## 🏗️ Quick Setup
 
-## License
+### Option 1: Docus CLI (Recommended)
 
-Published under the [MIT](https://github.com/unjs/undocs/blob/main/LICENSE) license.
+The easiest way to get started is using the Docus CLI, which automatically sets up a project with this layer:
 
-Docus v3 has been entirely rewritten from scratch and is inspired and copied from [undocs](https://github.com/unjs/undocs) made by [@pi0](https://github.com/pi0) 💚
+```bash
+# Create a new documentation project
+npx create docus my-docs
 
+# Navigate to your project
+cd my-docs
 
-<!-- Badges -->
-[npm-version-src]: https://img.shields.io/npm/v/docus/latest.svg?style=flat&colorA=020420&colorB=EEEEEE
-[npm-version-href]: https://npmjs.com/package/docus
+# Start development
+npm run dev
+```
 
-[npm-downloads-src]: https://img.shields.io/npm/dm/docus.svg?style=flat&colorA=020420&colorB=EEEEEE
-[npm-downloads-href]: https://npm.chart.dev/docus
+This creates a complete documentation project pre-configured with `docus`.
 
-[license-src]: https://img.shields.io/npm/l/docus.svg?style=flat&colorA=020420&colorB=EEEEEE
-[license-href]: https://npmjs.com/package/docus
+### Option 2: Manual Setup
 
-[nuxt-src]: https://img.shields.io/badge/Nuxt-020420?logo=nuxt.js
-[nuxt-href]: https://nuxt.com
+#### Option 2a: Nuxt Config (recommended)
+
+Add the layer to your `nuxt.config.ts`:
+
+```typescript
+export default defineNuxtConfig({
+  extends: ['docus']
+})
+```
+
+#### Option 2b: CLI Usage 
+
+Use directly with Nuxt CLI:
+
+```bash
+# Development
+nuxt dev --extends docus
+
+# Build
+nuxt build --extends docus
+```
+
+## 🔗 Related Packages
+
+- [`create-docus`](https://www.npmjs.com/package/create-docus) - CLI tool to scaffold Docus projects
+
+## 📄 License
+
+[MIT License](./LICENSE)
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📞 Support
+
+- 📖 [Documentation](https://docus.dev)
+- 🐛 [Issues](https://github.com/nuxtlabs/docus/issues)
+- 💬 [Discussions](https://github.com/nuxtlabs/docus/discussions)
+
+---
+
+Made with ❤️ for the Nuxt community 

package/app/{app/app.config.ts → app.config.ts}

@@ -9,7 +9,6 @@ export default defineAppConfig({
     contentNavigation: {
       slots: {
         linkLeadingIcon: 'size-4 mr-1',
-        listWithChildren: 'border-(--ui-bg-elevated)',
         linkTrailing: 'hidden',
       },
       variants: {
@@ -19,6 +18,9 @@ export default defineAppConfig({
           },
         },
       },
+      defaultVariants: {
+        variant: 'link',
+      },
     },
     pageLinks: {
       slots: {

package/app/{app/app.vue → app.vue}

@@ -2,7 +2,9 @@
 const { seo } = useAppConfig()
 const site = useSiteConfig()
 
-const { data: navigation } = await useAsyncData('navigation', () => queryCollectionNavigation('docs'))
+const { data: navigation } = await useAsyncData('navigation', () => queryCollectionNavigation('docs'), {
+  transform: data => data.find(item => item.path === '/docs')?.children || data || [],
+})
 const { data: files } = useLazyAsyncData('search', () => queryCollectionSearchSections('docs'), {
   server: false,
 })

package/app/{app/components → components}/IconMenuToggle.vue

@@ -1,31 +1,33 @@
 <script setup lang="ts">
 import { motion } from 'motion-v'
+import type { VariantType } from 'motion-v'
 
 const props = defineProps<{
   open: boolean
 }>()
 
-const lineVariants = {
+const variants: { [k: string]: VariantType | ((custom: unknown) => VariantType) } = {
   normal: {
     rotate: 0,
     y: 0,
     opacity: 1,
   },
-  close: (custom: number) => ({
-    rotate: custom === 1 ? 45 : custom === 3 ? -45 : 0,
-    y: custom === 1 ? 6 : custom === 3 ? -6 : 0,
-    opacity: custom === 2 ? 0 : 1,
-    transition: {
-      type: 'spring',
-      stiffness: 260,
-      damping: 20,
-    },
-  }),
+  close: (custom: unknown) => {
+    const c = custom as number
+    return {
+      rotate: c === 1 ? 45 : c === 3 ? -45 : 0,
+      y: c === 1 ? 6 : c === 3 ? -6 : 0,
+      opacity: c === 2 ? 0 : 1,
+      transition: {
+        type: 'spring',
+        stiffness: 260,
+        damping: 20,
+      },
+    }
+  },
 }
 
-const state = computed(() => {
-  return props.open ? 'close' : 'normal'
-})
+const state = computed(() => props.open ? 'close' : 'normal')
 </script>
 
 <template>
@@ -51,7 +53,7 @@ const state = computed(() => {
         y1="6"
         x2="20"
         y2="6"
-        :variants="lineVariants"
+        :variants="variants"
         :animate="state"
         :custom="1"
         class="outline-none"
@@ -61,7 +63,7 @@ const state = computed(() => {
         y1="12"
         x2="20"
         y2="12"
-        :variants="lineVariants"
+        :variants="variants"
         :animate="state"
         :custom="2"
         class="outline-none"
@@ -71,7 +73,7 @@ const state = computed(() => {
         y1="18"
         x2="20"
         y2="18"
-        :variants="lineVariants"
+        :variants="variants"
         :animate="state"
         :custom="3"
         class="outline-none"

package/app/components/docs/DocsPageHeaderLinks.vue

@@ -0,0 +1,77 @@
+<script setup lang="ts">
+import { useClipboard } from '@vueuse/core'
+
+const route = useRoute()
+const toast = useToast()
+const { copy, copied } = useClipboard()
+
+const markdownLink = computed(() => `${window?.location?.origin}/raw${route.path}.md`)
+
+const items = [
+  {
+    label: 'Copy Markdown link',
+    icon: 'i-lucide-link',
+    onSelect() {
+      copy(markdownLink.value)
+
+      toast.add({
+        title: 'Markdown link copied to clipboard',
+        icon: 'i-lucide-check-circle',
+        color: 'success',
+      })
+    },
+  },
+  {
+    label: 'View as Markdown',
+    icon: 'i-simple-icons:markdown',
+    target: '_blank',
+    to: markdownLink.value,
+  },
+  {
+    label: 'Open in ChatGPT',
+    icon: 'i-simple-icons:openai',
+    target: '_blank',
+    to: `https://chatgpt.com/?hints=search&q=${encodeURIComponent(`Read ${markdownLink.value} so I can ask questions about it.`)}`,
+  },
+  {
+    label: 'Open in Claude',
+    icon: 'i-simple-icons:anthropic',
+    target: '_blank',
+    to: `https://claude.ai/new?q=${encodeURIComponent(`Read ${markdownLink.value} so I can ask questions about it.`)}`,
+  },
+]
+</script>
+
+<template>
+  <UButtonGroup size="sm">
+    <UButton
+      label="Copy page"
+      :icon="copied ? 'i-lucide-copy-check' : 'i-lucide-copy'"
+      color="neutral"
+      variant="outline"
+      :ui="{
+        leadingIcon: [copied ? 'text-primary' : 'text-neutral', 'size-3.5'],
+      }"
+      @click="copy(markdownLink)"
+    />
+
+    <UDropdownMenu
+      size="sm"
+      :items="items"
+      :content="{
+        align: 'end',
+        side: 'bottom',
+        sideOffset: 8,
+      }"
+      :ui="{
+        content: 'w-48',
+      }"
+    >
+      <UButton
+        icon="i-lucide-chevron-down"
+        color="neutral"
+        variant="outline"
+      />
+    </UDropdownMenu>
+  </UButtonGroup>
+</template>

package/app/{app/layouts → layouts}/docs.vue

@@ -13,7 +13,6 @@ const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
 
           <UContentNavigation
             highlight
-            variant="link"
             :navigation="navigation"
           />
         </UPageAside>

package/app/{app/pages → pages}/[...slug].vue

@@ -1,7 +1,8 @@
 <script setup lang="ts">
-import type { ContentNavigationItem } from '@nuxt/content'
 import { kebabCase } from 'scule'
-import { findPageHeadline } from '#ui-pro/utils/content'
+import type { ContentNavigationItem } from '@nuxt/content'
+import { findPageHeadline } from '@nuxt/content/utils'
+import { addPrerenderPath } from '../utils/prerender'
 
 definePageMeta({
   layout: 'docs',
@@ -24,6 +25,9 @@ if (!page.value) {
   throw createError({ statusCode: 404, statusMessage: 'Page not found', fatal: true })
 }
 
+// Add the page path to the prerender list
+addPrerenderPath(`/raw${route.path}.md`)
+
 const title = page.value.seo?.title || page.value.title
 const description = page.value.seo?.description || page.value.description
 
@@ -34,13 +38,24 @@ useSeoMeta({
   ogDescription: description,
 })
 
-const headline = computed(() => findPageHeadline(navigation?.value, page.value))
+const headline = computed(() => findPageHeadline(navigation?.value, page.value?.path))
 defineOgImageComponent('Docs', {
   headline: headline.value,
 })
 
 const editLink = computed(() => {
-  return appConfig.github && `${appConfig.github.url}/edit/${appConfig.github.branch}/content/${page.value?.stem}.${page.value?.extension}`
+  if (!appConfig.github) {
+    return
+  }
+
+  return [
+    appConfig.github.url,
+    'edit',
+    appConfig.github.branch,
+    appConfig.github.rootDir,
+    'content',
+    `${page.value?.stem}.${page.value?.extension}`,
+  ].filter(Boolean).join('/')
 })
 </script>
 
@@ -49,13 +64,19 @@ const editLink = computed(() => {
     <UPageHeader
       :title="page.title"
       :description="page.description"
-      :links="page.links"
       :headline="headline"
       :ui="{
         wrapper: 'flex-row items-center flex-wrap justify-between',
       }"
     >
       <template #links>
+        <UButton
+          v-for="(link, index) in page.links"
+          :key="index"
+          size="sm"
+          v-bind="link"
+        />
+
         <DocsPageHeaderLinks />
       </template>
     </UPageHeader>
@@ -102,6 +123,7 @@ const editLink = computed(() => {
       #right
     >
       <UContentToc
+        highlight
         :title="appConfig.toc?.title || 'Table of Contents'"
         :links="page.body?.toc?.links"
       >

package/app/{app/pages → pages}/index.vue

@@ -4,6 +4,8 @@ if (!page.value) {
   throw createError({ statusCode: 404, statusMessage: 'Page not found', fatal: true })
 }
 
+// Reconsider it once this is implemented: https://github.com/nuxt/content/issues/3419
+const prose = page.value.meta.prose as boolean
 const title = page.value.seo?.title || page.value.title
 const description = page.value.seo?.description || page.value.description
 
@@ -32,6 +34,6 @@ else {
   <ContentRenderer
     v-if="page"
     :value="page"
-    :prose="false"
+    :prose="prose || false"
   />
 </template>

package/app/types/index.d.ts

@@ -0,0 +1,39 @@
+declare module 'nuxt/schema' {
+  interface AppConfig {
+    seo: {
+      titleTemplate: string
+      title: string
+      description: string
+    }
+    header: {
+      title: string
+      logo: {
+        light: string
+        dark: string
+        alt: string
+      }
+    }
+    socials: Record<string, string>
+    toc: {
+      title: string
+      bottom: {
+        title: string
+        links: {
+          icon: string
+          label: string
+          to: string
+          target: string
+        }[]
+      }
+    }
+    github: {
+      owner: string
+      name: string
+      url: string
+      branch: string
+      rootDir?: string
+    }
+  }
+}
+
+export {}

package/app/utils/prerender.ts

@@ -0,0 +1,12 @@
+export const addPrerenderPath = (path: string) => {
+  const event = useRequestEvent()
+  if (event) {
+    event.node.res.setHeader(
+      'x-nitro-prerender',
+      [
+        event.node.res.getHeader('x-nitro-prerender'),
+        path,
+      ].filter(Boolean).join(','),
+    )
+  }
+}

package/{app/content.config.ts → content.config.ts}

@@ -1,20 +1,23 @@
 import { defineContentConfig, defineCollection, z } from '@nuxt/content'
+import { useNuxt } from '@nuxt/kit'
+import { joinURL } from 'ufo'
+
+const { options } = useNuxt()
+const cwd = joinURL(options.rootDir, 'content')
 
 export default defineContentConfig({
   collections: {
     landing: defineCollection({
       type: 'page',
       source: {
-        // @ts-expect-error __DOCS_DIR__ is not defined
-        cwd: globalThis.__DOCS_DIR__,
+        cwd,
         include: 'index.md',
       },
     }),
     docs: defineCollection({
       type: 'page',
       source: {
-        // @ts-expect-error __DOCS_DIR__ is not defined
-        cwd: globalThis.__DOCS_DIR__,
+        cwd,
         include: '**',
         exclude: ['index.md'],
       },

package/{app/modules → modules}/default-configs.ts

@@ -1,7 +1,7 @@
-import { defineNuxtModule } from 'nuxt/kit'
+import { defineNuxtModule } from '@nuxt/kit'
 import { defu } from 'defu'
-import { inferSiteURL, getPackageJsonMetadata } from '../app/utils/meta'
-import { getGitBranch, getGitEnv, getLocalGitInfo } from '../app/utils/git'
+import { inferSiteURL, getPackageJsonMetadata } from '../utils/meta'
+import { getGitBranch, getGitEnv, getLocalGitInfo } from '../utils/git'
 
 export default defineNuxtModule({
   meta: {
@@ -14,7 +14,6 @@ export default defineNuxtModule({
     const gitInfo = await getLocalGitInfo(dir) || getGitEnv()
     const siteName = nuxt.options?.site?.name || meta.name || gitInfo?.name || ''
 
-    // @ts-expect-error llms is not defined in the schema
     nuxt.options.llms = defu(nuxt.options.llms, {
       domain: url,
       title: siteName,
@@ -31,22 +30,25 @@ export default defineNuxtModule({
       debug: false,
     })
 
-    nuxt.options.appConfig = defu(nuxt.options.appConfig, {
-      header: {
-        title: siteName,
-      },
-      github: {
-        owner: gitInfo?.owner,
-        name: gitInfo?.name,
-        url: gitInfo?.url,
-        branch: getGitBranch(),
-      },
-      seo: {
-        titleTemplate: `%s - ${siteName}`,
-        title: siteName,
-        description: meta.description || '',
-      },
-      toc: {},
+    nuxt.options.appConfig.header = defu(nuxt.options.appConfig.header, {
+      title: siteName,
+    })
+
+    nuxt.options.appConfig.seo = defu(nuxt.options.appConfig.seo, {
+      titleTemplate: `%s - ${siteName}`,
+      title: siteName,
+      description: meta.description || '',
+    })
+
+    nuxt.options.appConfig.github = defu(nuxt.options.appConfig.github, {
+      owner: gitInfo?.owner,
+      name: gitInfo?.name,
+      url: gitInfo?.url,
+      branch: getGitBranch(),
+    })
+
+    nuxt.options.appConfig.toc = defu(nuxt.options.appConfig.toc, {
+      title: 'On this page',
     })
   },
 })

package/{app/nuxt.config.ts → nuxt.config.ts}

@@ -1,7 +1,6 @@
-import { extendViteConfig } from '@nuxt/kit'
+import { extendViteConfig, createResolver } from '@nuxt/kit'
 
-// Flag enabled when developing docs theme
-const dev = !!process.env.NUXT_DOCS_DEV
+const { resolve } = createResolver(import.meta.url)
 
 export default defineNuxtConfig({
   modules: [
@@ -23,17 +22,24 @@ export default defineNuxtConfig({
     },
   ],
   devtools: {
-    enabled: dev,
+    enabled: true,
   },
-  css: ['../app/assets/css/main.css'],
-  future: {
-    compatibilityVersion: 4,
+  css: [resolve('./app/assets/css/main.css')],
+  content: {
+    build: {
+      markdown: {
+        highlight: {
+          langs: ['bash', 'diff', 'json', 'js', 'ts', 'html', 'css', 'vue', 'shell', 'mdc', 'md', 'yaml'],
+        },
+      },
+    },
   },
   nitro: {
     prerender: {
       routes: ['/'],
       crawlLinks: true,
       failOnError: false,
+      autoSubfolderIndex: false,
     },
   },
   icon: {

package/{app/nuxt.schema.ts → nuxt.schema.ts}

@@ -189,67 +189,30 @@ export default defineNuxtSchema({
     github: group({
       title: 'GitHub',
       description: 'GitHub configuration.',
-      icon: 'i-lucide-github',
+      icon: 'i-simple-icons-github',
       fields: {
         url: field({
           type: 'string',
           title: 'URL',
           description: 'GitHub URL.',
-          icon: 'i-lucide-github',
+          icon: 'i-simple-icons-github',
+          default: '',
+        }),
+        branch: field({
+          type: 'string',
+          title: 'Branch',
+          description: 'GitHub branch.',
+          icon: 'i-lucide-git-branch',
+          default: 'main',
+        }),
+        rootDir: field({
+          type: 'string',
+          title: 'Root Directory',
+          description: 'Root directory of the GitHub repository.',
+          icon: 'i-lucide-folder',
           default: '',
         }),
       },
     }),
   },
 })
-
-declare module '@nuxt/schema' {
-  interface AppConfig {
-    seo: {
-      titleTemplate: string
-      title: string
-      description: string
-    }
-    ui: {
-      colors: {
-        primary: string
-        neutral: string
-      }
-      icons: {
-        search: string
-        dark: string
-        light: string
-        external: string
-        chevron: string
-        hash: string
-      } & Record<string, string>
-    }
-    header: {
-      title: string
-      logo: {
-        light: string
-        dark: string
-        alt: string
-      }
-    }
-    socials: Record<string, string>
-    toc: {
-      title: string
-      bottom: {
-        title: string
-        links: {
-          icon: string
-          label: string
-          to: string
-          target: string
-        }[]
-      }
-    }
-    github: {
-      owner: string
-      name: string
-      url: string
-      branch: string
-    }
-  }
-}

package/package.json

@@ -1,77 +1,41 @@
 {
   "name": "docus",
-  "description": "Minimal Documentation theme and CLI for shared usage across Nuxt modules",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/nuxtlabs/docus"
-  },
+  "description": "Nuxt layer for Docus documentation theme",
+  "version": "4.0.0-beta.1",
+  "type": "module",
+  "main": "./nuxt.config.ts",
   "private": false,
-  "version": "3.1.0-20250617-135133-677078f",
-  "keywords": [],
-  "license": "MIT",
-  "bin": {
-    "docus": "./dist/main.mjs"
-  },
   "files": [
     "app",
-    "dist",
-    "!app/**/node_modules",
-    "!app/**/.nuxt",
-    "!app/**/tsconfig.json"
+    "content.config.ts",
+    "modules",
+    "nuxt.config.ts",
+    "nuxt.schema.ts",
+    "server",
+    "utils",
+    "README.md"
   ],
-  "scripts": {
-    "dev": "npm run docs:dev",
-    "docs:dev": "NUXT_DOCS_DEV=1 npm run docus dev docs",
-    "docs:build": "npm run docus build docs",
-    "dev:prepare": "nuxi prepare app && nuxi prepare docs",
-    "build": "tsup-node ./cli/main.ts --format esm",
-    "docus": "tsx ./cli/main.ts",
-    "test": "echo \"Error: no test specified\"",
-    "lint": "eslint .",
-    "release": "npm run lint && npm run test && npm run build && release-it"
-  },
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.47",
-    "@iconify-json/simple-icons": "^1.2.38",
-    "@iconify-json/vscode-icons": "^1.2.22",
-    "@nuxt/content": "^3.6.0",
+    "@iconify-json/lucide": "^1.2.57",
+    "@iconify-json/simple-icons": "^1.2.43",
+    "@iconify-json/vscode-icons": "^1.2.23",
+    "@nuxt/content": "^3.6.3",
     "@nuxt/image": "^1.10.0",
-    "@nuxt/kit": "^3.17.5",
-    "@nuxt/ui-pro": "^3.1.3",
-    "@nuxtjs/mdc": "^0.17.0",
-    "@nuxtjs/robots": "^5.2.10",
-    "c12": "^3.0.4",
-    "citty": "^0.1.6",
-    "dotenv": "^16.5.0",
-    "git-url-parse": "^16.1.0",
-    "minimark": "^0.2.0",
-    "motion-v": "^1.2.1",
-    "nuxi": "^3.25.1",
+    "@nuxt/kit": "^4.0.0",
+    "@nuxt/ui-pro": "^3.2.0",
+    "@nuxtjs/mdc": "^0.17.1",
+    "@nuxtjs/robots": "^5.4.0",
+    "@vueuse/core": "^13.5.0",
+    "defu": "^6.1.4",
+    "motion-v": "^1.5.0",
     "nuxt-llms": "^0.1.3",
-    "nuxt-og-image": "^5.1.6",
-    "pkg-types": "^2.1.0",
+    "nuxt-og-image": "^5.1.9",
     "scule": "^1.3.0",
-    "tailwindcss": "^4.1.8",
-    "ufo": "^1.6.1",
-    "unctx": "^2.4.1",
-    "unist-util-visit": "^5.0.0"
-  },
-  "devDependencies": {
-    "@nuxt/eslint-config": "^1.4.1",
-    "@release-it/conventional-changelog": "^10.0.1",
-    "@stylistic/eslint-plugin": "^4.4.1",
-    "@types/node": "^24.0.0",
-    "@typescript-eslint/parser": "^8.34.0",
-    "changelogen": "^0.6.1",
-    "eslint": "^9.28.0",
-    "release-it": "^19.0.3",
-    "tsup": "^8.5.0",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3"
+    "tailwindcss": "^4.1.11",
+    "ufo": "^1.6.1"
   },
   "peerDependencies": {
-    "better-sqlite3": "11.x",
-    "nuxt": "3.x"
-  },
-  "packageManager": "pnpm@10.12.1"
-}
+    "better-sqlite3": "12.x",
+    "nuxt": "4.x"
+  }
+} 

package/{app/server → server}/routes/raw/[...slug].md.get.ts

@@ -1,5 +1,6 @@
-import { stringify } from 'minimark/stringify'
 import { withLeadingSlash } from 'ufo'
+import { stringify } from 'minimark/stringify'
+import { queryCollection } from '@nuxt/content/nitro'
 
 export default eventHandler(async (event) => {
   const slug = getRouterParams(event)['slug.md']

package/{app/app/utils → utils}/git.ts

@@ -29,8 +29,10 @@ export function getGitBranch() {
     }
   }
   catch {
-    return 'main'
+    // Ignore error
   }
+
+  return 'main'
 }
 
 export async function getLocalGitInfo(rootDir: string): Promise<GitInfo | undefined> {
@@ -63,7 +65,7 @@ async function getLocalGitRemote(dir: string): Promise<string | undefined> {
   }
 }
 
-export function getGitEnv(): GitInfo | undefined {
+export function getGitEnv(): GitInfo {
   // https://github.com/unjs/std-env/issues/59
   const envInfo = {
     // Provider

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) NuxtLabs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/app/app/components/docs/DocsPageHeaderLinks.vue

@@ -1,91 +0,0 @@
-<template>
-  <UButtonGroup>
-    <UButton
-      label="Copy page"
-      :icon="copyStatus === 'copied' ? 'i-lucide-copy-check' : 'i-lucide-copy'"
-      color="neutral"
-      variant="outline"
-      :loading="copyStatus === 'copying'"
-      size="xs"
-      :ui="{
-        leadingIcon: [copyStatus === 'copied' ? 'text-primary' : 'text-neutral', 'size-3.5'],
-      }"
-      @click="copyPage"
-    />
-    <UDropdownMenu
-      size="sm"
-      :items="items"
-      :content="{
-        align: 'end',
-        side: 'bottom',
-        sideOffset: 8,
-      }"
-      :ui="{
-        content: 'w-48',
-      }"
-    >
-      <UButton
-        icon="i-lucide-chevron-down"
-        size="sm"
-        color="neutral"
-        variant="outline"
-      />
-    </UDropdownMenu>
-  </UButtonGroup>
-</template>
-
-<script setup lang="ts">
-const route = useRoute()
-const copyStatus = ref<'idle' | 'copying' | 'copied'>('idle')
-
-const items = [
-  {
-    label: 'Copy Markdown link',
-    icon: 'i-lucide-link',
-    onSelect() {
-      navigator.clipboard.writeText(`${window.location.origin}/raw${route.path}.md`)
-    },
-  },
-  {
-    label: 'View as Markdown',
-    icon: 'i-simple-icons:markdown',
-    target: '_blank',
-    onSelect() {
-      window.open(`${window.location.origin}/raw${route.path}.md`, '_blank')
-    },
-  },
-  {
-    label: 'Open in ChatGPT',
-    icon: 'i-simple-icons:openai',
-    target: '_blank',
-    onSelect() {
-      window.open(`https://chatgpt.com/?hints=search&q=${encodeURIComponent(`Read ${window.location.origin}/raw${route.path}.md so I can ask questions about it.`)}`, '_blank')
-    },
-  },
-  {
-    label: 'Open in Claude',
-    icon: 'i-simple-icons:anthropic',
-    target: '_blank',
-    onSelect() {
-      window.open(`https://claude.ai/new?q=${encodeURIComponent(`Read ${window.location.origin}/raw${route.path}.md so I can ask questions about it.`)}`, '_blank')
-    },
-  },
-]
-
-async function copyPage() {
-  copyStatus.value = 'copying'
-  const markdown = await $fetch<string>(`${window.location.origin}/raw${route.path}.md`)
-  copyToClipboard(markdown)
-  copyStatus.value = 'copied'
-  setTimeout(() => {
-    copyStatus.value = 'idle'
-  }, 2000)
-}
-
-function copyToClipboard(text: string) {
-  // Fix for iOS Safari: https://stackoverflow.com/questions/62327358/javascript-clipboard-api-safari-ios-notallowederror-message
-  setTimeout(async () => {
-    await navigator.clipboard.writeText(text)
-  }, 0)
-}
-</script>

package/dist/main.mjs

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-
-// cli/main.ts
-import * as dotenv from "dotenv";
-
-// cli/cli.ts
-import { resolve as resolve2 } from "path";
-import { defineCommand, runMain } from "citty";
-
-// cli/setup.ts
-import { fileURLToPath } from "url";
-import { resolve } from "path";
-var appDir = fileURLToPath(new URL("../app", import.meta.url));
-var pkgDir = fileURLToPath(new URL("..", import.meta.url));
-async function getNuxtConfig(dir, _opts = {}) {
-  global.__DOCS_DIR__ = resolve(dir, "content");
-  return {
-    compatibilityDate: "2025-06-17",
-    extends: [appDir],
-    modulesDir: [resolve(pkgDir, "node_modules"), resolve(appDir, "node_modules")]
-  };
-}
-
-// cli/cli.ts
-function createCLI(opts) {
-  const sharedArgs = {
-    dir: {
-      type: "positional",
-      description: "Docs directory",
-      required: true,
-      default: "."
-    }
-  };
-  const init = defineCommand({
-    meta: {
-      name: "init",
-      description: "Initialize a fresh Docus project"
-    },
-    args: { ...sharedArgs },
-    async setup({ args }) {
-      const dir = resolve2(args.dir);
-      const { runCommand } = await import("nuxi");
-      await runCommand("init", [dir, "-t", "gh:nuxtlabs/docus/.starter", dir]);
-    }
-  });
-  const dev = defineCommand({
-    meta: {
-      name: "dev",
-      description: "Start docs in development mode"
-    },
-    args: { ...sharedArgs },
-    async setup({ args }) {
-      const dir = resolve2(args.dir);
-      const nuxtConfig = await getNuxtConfig(dir, {
-        ...opts.setup,
-        dev: true
-      });
-      const { runCommand } = await import("nuxi");
-      await runCommand("dev", [dir, "--no-fork", "--port", process.env.PORT || "4000"], { overrides: nuxtConfig });
-    }
-  });
-  const build = defineCommand({
-    meta: {
-      name: "build",
-      description: "Build docs for production"
-    },
-    args: { ...sharedArgs },
-    async setup({ args }) {
-      const dir = resolve2(args.dir);
-      const nuxtConfig = await getNuxtConfig(dir, opts.setup);
-      const { runCommand } = await import("nuxi");
-      await runCommand("build", [dir], { overrides: nuxtConfig });
-    }
-  });
-  const main = defineCommand({
-    meta: {
-      name: opts.name,
-      description: opts.description
-    },
-    subCommands: {
-      init,
-      dev,
-      build
-    }
-  });
-  return {
-    runMain: () => runMain(main)
-  };
-}
-
-// cli/main.ts
-dotenv.config();
-var cli = createCLI({
-  name: "Docus",
-  description: "Docus Docs CLI",
-  setup: {
-    defaults: {}
-  }
-});
-cli.runMain();

package/app/{app/components → components}/docs/DocsAsideRightBottom.vue

@@ -1,3 +1,7 @@
+<script setup lang="ts">
+const appConfig = useAppConfig()
+</script>
+
 <template>
   <div
     v-if="appConfig.toc?.bottom?.links?.length"
@@ -11,7 +15,3 @@
     />
   </div>
 </template>
-
-<script setup lang="ts">
-const appConfig = useAppConfig()
-</script>