@baybreezy/docd 0.0.1

package/nuxt.schema.ts

@@ -0,0 +1,288 @@
+import { field, group } from "@nuxt/content/preview";
+
+export default defineNuxtSchema({
+  appConfig: {
+    docd: group({
+      title: "Docd",
+      description: "Docd documentation layer configuration.",
+      icon: "i-lucide-settings",
+      fields: {
+        github: group({
+          title: "GitHub",
+          description: "GitHub repository configuration for edit links.",
+          icon: "i-simple-icons-github",
+          fields: {
+            repo: field({
+              type: "string",
+              title: "Repository URL",
+              description: "Full GitHub repository URL, e.g. https://github.com/user/repo",
+              icon: "i-simple-icons-github",
+              default: "",
+            }),
+            branch: field({
+              type: "string",
+              title: "Branch",
+              description: "Branch to link to for editing.",
+              icon: "i-lucide-git-branch",
+              default: "main",
+            }),
+            contentDir: field({
+              type: "string",
+              title: "Content Directory",
+              description: "Path inside the repo where content lives.",
+              icon: "i-lucide-folder",
+              default: "content",
+            }),
+          },
+        }),
+        ui: group({
+          title: "UI",
+          description: "UI customization options.",
+          icon: "i-lucide-palette",
+          fields: {
+            colorMode: field({
+              type: "string",
+              title: "Color Mode",
+              description:
+                "Force a specific color mode. Leave empty for system preference with toggle.",
+              icon: "i-lucide-monitor",
+              default: "",
+              required: ["", "light", "dark"],
+            }),
+            borderType: field({
+              type: "string",
+              title: "Border Type",
+              description:
+                "Controls whether decorative borders and rails render as dashed or solid.",
+              icon: "i-lucide-separator-horizontal",
+              default: "dashed",
+              required: ["dashed", "solid"],
+            }),
+            header: group({
+              title: "Header",
+              description: "Header configuration.",
+              icon: "i-lucide-layout",
+              fields: {
+                title: field({
+                  type: "string",
+                  title: "Title",
+                  description: "Title displayed in the header. Defaults to the site name.",
+                  icon: "i-lucide-type",
+                  default: "",
+                }),
+                hideSearch: field({
+                  type: "boolean",
+                  title: "Hide Search",
+                  description: "Whether to hide the search button in the header.",
+                  icon: "i-lucide-search",
+                  default: false,
+                }),
+                logo: group({
+                  title: "Logo",
+                  description: "Logo configuration for the header.",
+                  icon: "i-lucide-image",
+                  fields: {
+                    light: field({
+                      type: "media",
+                      title: "Light Mode Logo",
+                      description: "Logo image for light mode.",
+                      icon: "i-lucide-sun",
+                      default: "",
+                    }),
+                    dark: field({
+                      type: "media",
+                      title: "Dark Mode Logo",
+                      description: "Logo image for dark mode.",
+                      icon: "i-lucide-moon",
+                      default: "",
+                    }),
+                    alt: field({
+                      type: "string",
+                      title: "Alt Text",
+                      description: "Alt text for the logo image.",
+                      icon: "i-lucide-text",
+                      default: "",
+                    }),
+                    classes: field({
+                      type: "string",
+                      title: "CSS Classes",
+                      description: "Additional CSS classes to apply to the logo image.",
+                      icon: "i-lucide-paintbrush",
+                      default: "",
+                    }),
+                    display: field({
+                      type: "string",
+                      title: "Display",
+                      description:
+                        'Which logo variant to show in the header: "logo" or "wordmark".',
+                      icon: "i-lucide-layout",
+                      default: "logo",
+                      required: ["logo", "wordmark"],
+                    }),
+                    wordmark: group({
+                      title: "Wordmark",
+                      description: "Wordmark image configuration for header branding.",
+                      icon: "i-lucide-type",
+                      fields: {
+                        light: field({
+                          type: "media",
+                          title: "Light Mode Wordmark",
+                          description: "Wordmark image for light mode.",
+                          icon: "i-lucide-sun",
+                          default: "",
+                        }),
+                        dark: field({
+                          type: "media",
+                          title: "Dark Mode Wordmark",
+                          description: "Wordmark image for dark mode.",
+                          icon: "i-lucide-moon",
+                          default: "",
+                        }),
+                      },
+                    }),
+                    favicon: field({
+                      type: "media",
+                      title: "Favicon",
+                      description: "Path to the favicon file for brand asset references.",
+                      icon: "i-lucide-app-window",
+                      default: "/favicon.ico",
+                    }),
+                    brandAssetsUrl: field({
+                      type: "string",
+                      title: "Brand Assets URL",
+                      description: "Link to a page or folder containing brand assets.",
+                      icon: "i-lucide-palette",
+                      default: "",
+                    }),
+                    url: field({
+                      type: "string",
+                      title: "Click URL",
+                      description: "URL to navigate to when the logo is clicked.",
+                      icon: "i-lucide-link",
+                      default: "/",
+                    }),
+                  },
+                }),
+              },
+            }),
+            toc: group({
+              title: "Table of Contents",
+              description: "Table of contents sidebar configuration.",
+              icon: "i-lucide-list",
+              fields: {
+                title: field({
+                  type: "string",
+                  title: "Title",
+                  description: "Title displayed at the top of the ToC.",
+                  icon: "i-lucide-heading",
+                  default: "On this page",
+                }),
+                icon: field({
+                  type: "icon",
+                  title: "Icon",
+                  description: "Icon displayed next to the ToC title.",
+                  icon: "i-lucide-list",
+                  default: "lucide:list",
+                }),
+              },
+            }),
+            transition: group({
+              title: "Page Transition",
+              description: "Page transition animation configuration.",
+              icon: "i-lucide-sparkles",
+              fields: {
+                name: field({
+                  type: "string",
+                  title: "Transition Name",
+                  description: 'Transition preset to use. Set to "none" to disable.',
+                  icon: "i-lucide-play",
+                  default: "fade",
+                  required: [
+                    "none",
+                    "fade",
+                    "rightToLeft",
+                    "leftToRight",
+                    "upToDown",
+                    "downToUp",
+                    "zoom",
+                    "cupertino",
+                  ],
+                }),
+                duration: field({
+                  type: "number",
+                  title: "Duration",
+                  description: "Transition duration in seconds.",
+                  icon: "i-lucide-timer",
+                  default: 0.35,
+                }),
+                easing: field({
+                  type: "string",
+                  title: "Easing",
+                  description: "Easing function for the transition.",
+                  icon: "i-lucide-activity",
+                  default: "easeOut",
+                }),
+              },
+            }),
+            footer: group({
+              title: "Footer",
+              description: "Sidebar footer configuration.",
+              icon: "i-lucide-layout",
+              fields: {
+                hideThemeCustomizer: field({
+                  type: "boolean",
+                  title: "Hide Theme Customizer",
+                  description: "Whether to hide the theme customizer in the sidebar footer.",
+                  icon: "i-lucide-palette",
+                  default: false,
+                }),
+                hideLightDarkToggle: field({
+                  type: "boolean",
+                  title: "Hide Light/Dark Toggle",
+                  description: "Whether to hide the light/dark mode toggle in the sidebar footer.",
+                  icon: "i-lucide-moon",
+                  default: false,
+                }),
+              },
+            }),
+            extraLinks: field({
+              type: "array",
+              title: "Extra Links",
+              description: "Additional links rendered in the sidebar's extra section.",
+              icon: "i-lucide-link",
+              default: [],
+            }),
+          },
+        }),
+      },
+    }),
+    seo: group({
+      title: "SEO",
+      description: "SEO configuration.",
+      icon: "i-lucide-search",
+      fields: {
+        titleTemplate: field({
+          type: "string",
+          title: "Title Template",
+          description: "Template for page titles. Use %s as the page title placeholder.",
+          icon: "i-lucide-type",
+          default: "%s",
+        }),
+        title: field({
+          type: "string",
+          title: "Site Title",
+          description: "Default site title.",
+          icon: "i-lucide-type",
+          default: "",
+        }),
+        description: field({
+          type: "string",
+          title: "Description",
+          description: "Default site description.",
+          icon: "i-lucide-text",
+          default: "",
+        }),
+      },
+    }),
+  },
+});

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@baybreezy/docd",
+  "version": "0.0.1",
+  "description": "A Nuxt layer for building documentation sites with UI Thing.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BayBreezy/docd"
+  },
+  "files": [
+    "app",
+    "modules",
+    "server",
+    "utils",
+    "content.config.ts",
+    "index.d.ts",
+    "nuxt.config.ts",
+    "nuxt.schema.ts",
+    "tailwind.config.cjs"
+  ],
+  "type": "module",
+  "main": "./nuxt.config.ts",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./nuxt.config.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@baybreezy/file-extension-icon": "^0.0.4",
+    "@iconify-json/lucide": "^1.2.102",
+    "@iconify-json/simple-icons": "^1.2.79",
+    "@iconify/utils": "^3.1.0",
+    "@morev/vue-transitions": "^3.0.5",
+    "@nuxt/content": "3.13.0",
+    "@nuxt/fonts": "^0.14.0",
+    "@nuxt/icon": "^2.2.1",
+    "@nuxt/image": "2.0.0",
+    "@nuxt/kit": "^4.4.2",
+    "@nuxtjs/color-mode": "^4.0.0",
+    "@nuxtjs/mcp-toolkit": "^0.14.0",
+    "@nuxtjs/mdc": "^0.21.1",
+    "@nuxtjs/robots": "^6.0.7",
+    "@tailwindcss/forms": "^0.5.11",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tailwindcss/vite": "^4.2.4",
+    "@takumi-rs/core": "^1.0.16",
+    "@vueuse/core": "^14.2.1",
+    "@vueuse/nuxt": "^14.2.1",
+    "better-sqlite3": "^12.9.0",
+    "defu": "^6.1.7",
+    "git-url-parse": "^16.1.0",
+    "lodash-es": "^4.18.1",
+    "mermaid": "^11.14.0",
+    "motion-v": "^2.2.1",
+    "nuxt-component-meta": "^0.17.2",
+    "nuxt-gtag": "4.1.0",
+    "nuxt-llms": "^0.2.0",
+    "nuxt-og-image": "^6.4.6",
+    "pkg-types": "^2.3.0",
+    "reka-ui": "^2.9.6",
+    "shiki": "^4.0.2",
+    "tailwind-merge": "^3.5.0",
+    "tailwind-variants": "^3.2.2",
+    "tailwindcss": "^4.2.4",
+    "tw-animate-css": "^1.4.0",
+    "ufo": "^1.6.3",
+    "vaul-vue": "^0.4.1",
+    "vue-sonner": "^2.0.9",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
+    "nuxt": "^4.4.2",
+    "typescript": "^6.0.3",
+    "vue": "latest",
+    "vue-router": "^5.0.6"
+  },
+  "overrides": {
+    "@takumi-rs/core": "^1.0.16"
+  },
+  "packageManager": "bun@1.3.13",
+  "trustedDependencies": [
+    "@morev/vue-transitions",
+    "@parcel/watcher",
+    "esbuild",
+    "sharp",
+    "unrs-resolver",
+    "vue-demi"
+  ]
+}

package/server/mcp/tools/get-page.ts

@@ -0,0 +1,66 @@
+import type { Collections } from "@nuxt/content";
+import { queryCollection } from "@nuxt/content/server";
+import { z } from "zod";
+
+import { inferSiteURL } from "../../../utils/meta";
+
+export default defineMcpTool({
+  description: `Retrieves the full content and details of a specific documentation page.
+
+WHEN TO USE: Use this tool when you know the EXACT path to a documentation page. Common use cases:
+- User asks for a specific page: "Show me the getting started guide" → /getting-started/installation
+- User asks about a known topic with a dedicated page
+- You found a relevant path from list-pages and want the full content
+- User references a specific section or guide they want to read
+
+WHEN NOT TO USE: If you don't know the exact path and need to search/explore, use list-pages first.
+
+WORKFLOW: This tool returns the complete page content including title, description, and full markdown. Use this when you need to provide detailed answers or code examples from specific documentation pages.
+`,
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+  },
+  inputSchema: {
+    path: z
+      .string()
+      .describe(
+        "The page path from list-pages or provided by the user (e.g., /getting-started/installation)"
+      ),
+  },
+  inputExamples: [
+    { path: "/getting-started/installation" },
+    { path: "/getting-started/introduction" },
+  ],
+  cache: "1h",
+  handler: async ({ path }) => {
+    const event = useEvent();
+    const siteUrl = getRequestURL(event).origin || inferSiteURL();
+
+    try {
+      const page = await queryCollection(event, "docs" as keyof Collections)
+        .where("path", "=", path)
+        .select("title", "path", "description")
+        .first();
+
+      if (!page) {
+        throw createError({ statusCode: 404, message: "Page not found" });
+      }
+
+      const content = await event.$fetch<string>(`/raw${path}.md`);
+
+      return {
+        title: page.title,
+        path: page.path,
+        description: page.description,
+        content,
+        url: `${siteUrl}${page.path}`,
+      };
+    } catch (error) {
+      if ((error as { statusCode?: number }).statusCode === 404) throw error;
+      throw createError({ statusCode: 500, message: "Failed to get page" });
+    }
+  },
+});

package/server/mcp/tools/list-pages.ts

@@ -0,0 +1,61 @@
+import type { Collections } from "@nuxt/content";
+import { queryCollection } from "@nuxt/content/server";
+import { z } from "zod";
+
+import { inferSiteURL } from "../../../utils/meta";
+
+export default defineMcpTool({
+  description: `Lists all available documentation pages with their categories and basic information.
+
+WHEN TO USE: Use this tool when you need to EXPLORE or SEARCH for documentation about a topic but don't know the exact page path. Common scenarios:
+- "Find documentation about markdown features" - explore available guides
+- "Show me all getting started guides" - browse introductory content
+- "Search for advanced configuration options" - find specific topics
+- User asks general questions without specifying exact pages
+- You need to understand the overall documentation structure
+
+WHEN NOT TO USE: If you already know the specific page path (e.g., "/getting-started/installation"), use get-page directly instead.
+
+WORKFLOW: This tool returns page titles, descriptions, and paths. After finding relevant pages, use get-page to retrieve the full content of specific pages that match the user's needs.
+
+OUTPUT: Returns a structured list with:
+- title: Human-readable page name
+- path: Exact path for use with get-page
+- description: Brief summary of page content
+- url: Full URL for reference`,
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+  },
+  inputSchema: {
+    section: z
+      .string()
+      .optional()
+      .describe("Optional path prefix to filter pages by section, such as '/getting-started'"),
+  },
+  inputExamples: [{ section: "/getting-started" }, {}],
+  cache: "1h",
+  handler: async ({ section }) => {
+    const event = useEvent();
+    const siteUrl = getRequestURL(event).origin || inferSiteURL();
+
+    try {
+      const pages = await queryCollection(event, "docs" as keyof Collections)
+        .select("title", "path", "description")
+        .all();
+
+      return pages
+        .filter((page) => !section || page.path.startsWith(section))
+        .map((page) => ({
+          title: page.title,
+          path: page.path,
+          description: page.description,
+          url: `${siteUrl}${page.path}`,
+        }));
+    } catch {
+      throw createError({ statusCode: 500, message: "Failed to list pages" });
+    }
+  },
+});

package/server/routes/sitemap.xml.ts

@@ -0,0 +1,73 @@
+import { queryCollection } from "@nuxt/content/server";
+
+import { getCollectionsToQuery } from "../utils/content";
+
+interface SitemapUrl {
+  loc: string;
+  lastmod?: string;
+}
+
+export default defineEventHandler(async (event) => {
+  const config = useRuntimeConfig(event);
+  const siteUrl = (config.public.siteUrl as string | undefined) || "";
+
+  const collections = getCollectionsToQuery();
+  const urls: SitemapUrl[] = [];
+
+  for (const collection of collections) {
+    try {
+      const pages = await (
+        queryCollection as unknown as (
+          event: unknown,
+          collection: string
+        ) => { all: () => Promise<Array<Record<string, unknown> & { path?: string }>> }
+      )(event, collection).all();
+
+      for (const page of pages) {
+        const pagePath = page.path || "/";
+
+        if (page.sitemap === false) continue;
+        if (pagePath.endsWith(".navigation") || pagePath.includes("/.navigation")) continue;
+
+        const entry: SitemapUrl = { loc: pagePath };
+
+        if (page.modifiedAt && typeof page.modifiedAt === "string") {
+          entry.lastmod = (page.modifiedAt as string).split("T")[0];
+        }
+
+        urls.push(entry);
+      }
+    } catch {
+      // Collection may not exist in this app — skip
+    }
+  }
+
+  setResponseHeader(event, "content-type", "application/xml");
+  return generateSitemap(urls, siteUrl);
+});
+
+function generateSitemap(urls: SitemapUrl[], siteUrl: string): string {
+  const urlEntries = urls
+    .map((url) => {
+      const loc = siteUrl ? `${siteUrl}${url.loc}` : url.loc;
+      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");
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlEntries}
+</urlset>`;
+}
+
+function escapeXml(str: string): string {
+  return str
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+}

package/server/utils/content.ts

@@ -0,0 +1,3 @@
+export function getCollectionsToQuery(): string[] {
+  return ["docs", "landing"];
+}

package/tailwind.config.cjs

@@ -0,0 +1,55 @@
+/**@type {import('tailwindcss').Config} */
+module.exports = {
+  theme: {
+    extend: {
+      typography: () => ({
+        DEFAULT: {
+          css: {
+            "--tw-prose-body": "var(--color-foreground)",
+            "--tw-prose-headings": "var(--color-foreground)",
+            "--tw-prose-lead": "var(--color-muted-foreground)",
+            "--tw-prose-links": "var(--color-foreground)",
+            "--tw-prose-bold": "var(--color-foreground)",
+            "--tw-prose-counters": "var(--color-muted-foreground)",
+            "--tw-prose-bullets": "--alpha(var(--color-primary) / 50%)",
+            "--tw-prose-hr": "var(--color-border)",
+            "--tw-prose-quotes": "var(--color-foreground)",
+            "--tw-prose-quote-borders": "var(--color-border)",
+            "--tw-prose-captions": "var(--color-muted-foreground)",
+            "--tw-prose-kbd": "var(--color-foreground)",
+            "--tw-prose-kbd-shadows": "var(--color-foreground)",
+            "--tw-prose-code": "var(--color-foreground)",
+            "--tw-prose-pre-code": "var(--color-background)",
+            "--tw-prose-pre-bg": "--alpha(var(--color-background) / 60%)",
+            "--tw-prose-th-borders": "var(--color-border)",
+            "--tw-prose-td-borders": "var(--color-border)",
+            "--tw-prose-invert-body": "var(--color-foreground)",
+            "--tw-prose-invert-headings": "var(--color-foreground)",
+            "--tw-prose-invert-lead": "var(--color-muted-foreground)",
+            "--tw-prose-invert-links": "var(--color-foreground)",
+            "--tw-prose-invert-bold": "var(--color-foreground)",
+            "--tw-prose-invert-counters": "var(--color-muted-foreground)",
+            "--tw-prose-invert-bullets": "--alpha(var(--color-primary) / 50%)",
+            "--tw-prose-invert-hr": "var(--color-border)",
+            "--tw-prose-invert-quotes": "var(--color-foreground)",
+            "--tw-prose-invert-quote-borders": "var(--color-border)",
+            "--tw-prose-invert-captions": "var(--color-muted-foreground)",
+            "--tw-prose-invert-kbd": "var(--color-foreground)",
+            "--tw-prose-invert-kbd-shadows": "var(--color-foreground)",
+            "--tw-prose-invert-code": "var(--color-foreground)",
+            "--tw-prose-invert-pre-code": "var(--color-foreground)",
+            "--tw-prose-invert-pre-bg": "--alpha(var(--color-background) / 50%)",
+            "--tw-prose-invert-th-borders": "var(--color-border)",
+            "--tw-prose-invert-td-borders": "var(--color-border)",
+            "code::before": {
+              content: "",
+            },
+            "code::after": {
+              content: "",
+            },
+          },
+        },
+      }),
+    },
+  },
+};