blodemd 0.0.9 → 0.0.11

package/docs/app/globals.css

@@ -347,7 +347,7 @@
     border-color: var(--border);
     border-width: 0px;
     border-radius: var(--radius-xl);
-    @apply -mx-1 md:-mx-1;
+    @apply md:-mx-1;
 
     &:has([data-rehype-pretty-code-title]) [data-slot="copy-button"] {
       top: calc(var(--spacing) * 1.5) !important;

package/docs/components/animate-ui/primitives/buttons/button.tsx

@@ -0,0 +1,14 @@
+"use client";
+
+import type * as React from "react";
+
+type ButtonProps = React.ComponentProps<"button">;
+
+const Button = ({ children, ...props }: ButtonProps) => (
+  <button type="button" {...props}>
+    {children}
+  </button>
+);
+
+export { Button };
+export type { ButtonProps };

package/docs/components/docs/copy-page-menu.tsx

@@ -203,9 +203,25 @@ export const CopyPageMenu = ({
 
   const handleCopy = useCallback(async () => {
     try {
-      const nextContent = await getContent();
-      const markdown = formatMarkdownForCopy(nextContent, title);
-      await navigator.clipboard.writeText(markdown);
+      // iOS Safari loses the user gesture context after any async gap (e.g. a
+      // fetch). To keep clipboard access working, we call clipboard.write()
+      // synchronously within the gesture and pass a Promise to ClipboardItem
+      // so the content resolves later while the gesture context stays alive.
+      const blobPromise = (async () => {
+        const nextContent = await getContent();
+        const markdown = formatMarkdownForCopy(nextContent, title);
+        return new Blob([markdown], { type: "text/plain" });
+      })();
+
+      if (typeof ClipboardItem === "undefined") {
+        const blob = await blobPromise;
+        await navigator.clipboard.writeText(await blob.text());
+      } else {
+        await navigator.clipboard.write([
+          new ClipboardItem({ "text/plain": blobPromise }),
+        ]);
+      }
+
       setTemporaryCopyStatus("copied");
       closeMenu();
     } catch {

package/docs/components/docs/doc-shell.tsx

@@ -185,8 +185,8 @@ export const DocShell = ({
             <div className="flex flex-col gap-2">
               <Breadcrumbs basePath={basePath} breadcrumbs={breadcrumbs} />
               <div className="flex flex-col gap-2">
-                <div className="flex items-center justify-between md:items-start">
-                  <h1 className="scroll-m-24 text-3xl font-semibold tracking-tight sm:text-3xl">
+                <div className="flex flex-col items-start gap-3 sm:flex-row sm:justify-between">
+                  <h1 className="min-w-0 scroll-m-24 text-3xl font-semibold tracking-tight sm:text-3xl">
                     {pageTitle}
                     {deprecated ? (
                       <span className="ml-3 inline-flex translate-y-[-2px] items-center rounded-md bg-yellow-100 px-2 py-0.5 align-middle text-xs font-medium text-yellow-800 dark:bg-yellow-900/40 dark:text-yellow-300">
@@ -212,7 +212,7 @@ export const DocShell = ({
                 ) : null}
               </div>
             </div>
-            <div className="grid gap-4.5 leading-relaxed [&_blockquote]:border-l-3 [&_blockquote]:border-primary [&_blockquote]:pl-3.5 [&_blockquote]:text-muted-foreground [&_h2]:mt-10 [&_h2]:mb-3 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-8 [&_h3]:mb-2 [&_h3]:text-[1.375rem] [&_h3]:font-semibold [&_h4]:mt-6 [&_h4]:mb-2 [&_h4]:text-base [&_h4]:font-semibold [&_ol]:list-decimal [&_ol]:pl-5 [&_table]:w-full [&_table]:border-collapse [&_table]:text-sm [&_td]:border-b [&_td]:border-border [&_td]:px-2.5 [&_td]:py-2 [&_td]:text-left [&_th]:border-b [&_th]:border-border [&_th]:px-2.5 [&_th]:py-2 [&_th]:text-left [&_ul]:list-disc [&_ul]:pl-5">
+            <div className="grid min-w-0 grid-cols-1 gap-4.5 leading-relaxed [&_blockquote]:border-l-3 [&_blockquote]:border-primary [&_blockquote]:pl-3.5 [&_blockquote]:text-muted-foreground [&_h2]:mt-10 [&_h2]:mb-3 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-8 [&_h3]:mb-2 [&_h3]:text-[1.375rem] [&_h3]:font-semibold [&_h4]:mt-6 [&_h4]:mb-2 [&_h4]:text-base [&_h4]:font-semibold [&_ol]:list-decimal [&_ol]:pl-6 [&_table]:w-full [&_table]:border-collapse [&_table]:text-sm [&_td]:border-b [&_td]:border-border [&_td]:px-2.5 [&_td]:py-2 [&_td]:text-left [&_th]:border-b [&_th]:border-border [&_th]:px-2.5 [&_th]:py-2 [&_th]:text-left [&_ul]:list-disc [&_ul]:pl-6">
               {content}
             </div>
             {!hideFooterPagination && (prevPage || nextPage) ? (

package/docs/components/mdx/steps.tsx

@@ -24,7 +24,7 @@ export const Step = ({
   const anchorId = id ?? title.toLowerCase().replaceAll(/\s+/g, "-");
 
   return (
-    <div className="relative pb-8 pl-10 last:pb-0" id={anchorId}>
+    <div className="relative pb-8 pl-8 sm:pl-10 last:pb-0" id={anchorId}>
       <div
         aria-hidden
         className="absolute left-0 flex size-7 items-center justify-center rounded-full border border-border bg-muted font-mono text-xs font-medium"

package/docs/components/ui/copy-button.tsx

@@ -0,0 +1,122 @@
+"use client";
+
+import {
+  Checkmark1Icon as CheckIcon,
+  CopySimpleIcon as CopyIcon,
+} from "blode-icons-react";
+import { cva } from "class-variance-authority";
+import type { VariantProps } from "class-variance-authority";
+import { AnimatePresence, motion } from "motion/react";
+import { useCallback } from "react";
+import type { MouseEvent } from "react";
+
+import { Button as ButtonPrimitive } from "@/components/animate-ui/primitives/buttons/button";
+import type { ButtonProps as ButtonPrimitiveProps } from "@/components/animate-ui/primitives/buttons/button";
+import { useControlledState } from "@/hooks/use-controlled-state";
+import { cn } from "@/lib/utils";
+
+const buttonVariants = cva(
+  "flex shrink-0 items-center justify-center rounded-md outline-none transition-[box-shadow,_color,_background-color,_border-color,_outline-color,_text-decoration-color,_fill,_stroke] focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0",
+  {
+    defaultVariants: {
+      size: "default",
+      variant: "default",
+    },
+    variants: {
+      size: {
+        default: "size-9",
+        lg: "size-10 rounded-md",
+        sm: "size-8 rounded-md",
+        xs: "size-7 rounded-md [&_svg:not([class*='size-'])]:size-3.5",
+      },
+      variant: {
+        accent: "bg-accent text-accent-foreground shadow-xs hover:bg-accent/90",
+        default:
+          "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:bg-destructive/60 dark:focus-visible:ring-destructive/40",
+        ghost:
+          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+        outline:
+          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80",
+      },
+    },
+  }
+);
+
+type CopyButtonProps = Omit<ButtonPrimitiveProps, "children"> &
+  VariantProps<typeof buttonVariants> & {
+    content: string;
+    copied?: boolean;
+    delay?: number;
+    onCopiedChange?: (copied: boolean, content?: string) => void;
+  };
+
+const CopyButton = ({
+  className,
+  content,
+  copied,
+  onCopiedChange,
+  onClick,
+  variant,
+  size,
+  delay = 3000,
+  ...props
+}: CopyButtonProps) => {
+  const [isCopied, setIsCopied] = useControlledState({
+    onChange: onCopiedChange,
+    value: copied,
+  });
+
+  const handleCopy = useCallback(
+    async (e: MouseEvent<HTMLButtonElement>) => {
+      onClick?.(e);
+      if (copied) {
+        return;
+      }
+      if (content) {
+        try {
+          await navigator.clipboard.writeText(content);
+          setIsCopied(true);
+          onCopiedChange?.(true, content);
+          setTimeout(() => {
+            setIsCopied(false);
+            onCopiedChange?.(false);
+          }, delay);
+        } catch (error) {
+          console.error("Error copying command", error);
+        }
+      }
+    },
+    [onClick, copied, content, setIsCopied, onCopiedChange, delay]
+  );
+
+  const Icon = isCopied ? CheckIcon : CopyIcon;
+
+  return (
+    <ButtonPrimitive
+      className={cn(buttonVariants({ className, size, variant }))}
+      data-slot="copy-button"
+      onClick={handleCopy}
+      {...props}
+    >
+      <AnimatePresence mode="popLayout">
+        <motion.span
+          animate={{ filter: "blur(0px)", opacity: 1, scale: 1 }}
+          data-slot="copy-button-icon"
+          exit={{ filter: "blur(4px)", opacity: 0.4, scale: 0 }}
+          initial={false}
+          key={isCopied ? "check" : "copy"}
+          transition={{ duration: 0.25 }}
+        >
+          <Icon />
+        </motion.span>
+      </AnimatePresence>
+    </ButtonPrimitive>
+  );
+};
+
+export { CopyButton };

package/docs/components/ui/site-footer.tsx

@@ -0,0 +1,39 @@
+import Image from "next/image";
+
+import { siteConfig } from "@/lib/config";
+
+export const SiteFooter = () => (
+  <footer className="flex flex-col items-center justify-center gap-2 pt-16 pb-8 text-muted-foreground text-sm">
+    <div className="flex items-center gap-1">
+      Crafted by
+      <a
+        className="flex items-center gap-2 rounded-full py-1.5 pr-2.5 pl-1.5 transition-colors hover:text-foreground"
+        href={siteConfig.links.author}
+        rel="noopener noreferrer"
+        target="_blank"
+      >
+        <Image
+          alt="Avatar of Matthew Blode"
+          className="rounded-full"
+          height={20}
+          src="/matthew-blode-profile.jpg"
+          unoptimized
+          width={20}
+        />
+        Matthew Blode
+      </a>
+    </div>
+    <div className="flex items-center gap-2 text-muted-foreground/30">
+      <span className="text-muted-foreground">v{siteConfig.version}</span>{" "}
+      &bull;
+      <a
+        className="text-muted-foreground transition-colors hover:text-foreground"
+        href={siteConfig.links.github}
+        rel="noopener noreferrer"
+        target="_blank"
+      >
+        GitHub
+      </a>
+    </div>
+  </footer>
+);

package/docs/lib/config.ts

@@ -0,0 +1,7 @@
+export const siteConfig = {
+  links: {
+    author: "https://matthewblode.com",
+    github: "https://github.com/mblode/blodemd",
+  },
+  version: "0.0.9",
+};

package/docs/lib/tenancy.ts

@@ -15,22 +15,47 @@ const DEFAULT_RESERVED_PATHS = [
   "/_internal",
   "/_next",
   "/.well-known",
+  "/api",
   "/docs.json",
   "/favicon.ico",
   "/llms.txt",
+  "/logos",
   "/oauth",
   "/robots.txt",
   "/sitemap.xml",
-  "/logos",
-  "/file-text.svg",
-  "/globe.svg",
-  "/next.svg",
-  "/turborepo-dark.svg",
-  "/turborepo-light.svg",
-  "/vercel.svg",
-  "/window.svg",
 ];
 
+const STATIC_ASSET_EXTENSIONS = new Set([
+  ".avif",
+  ".css",
+  ".eot",
+  ".gif",
+  ".ico",
+  ".jpeg",
+  ".jpg",
+  ".js",
+  ".json",
+  ".map",
+  ".png",
+  ".svg",
+  ".ttf",
+  ".webp",
+  ".woff",
+  ".woff2",
+]);
+
+const isRootStaticAsset = (pathname: string): boolean => {
+  const segments = pathname.split("/").filter(Boolean);
+  if (segments.length !== 1) {
+    return false;
+  }
+  const lastDot = pathname.lastIndexOf(".");
+  if (lastDot === -1) {
+    return false;
+  }
+  return STATIC_ASSET_EXTENSIONS.has(pathname.slice(lastDot).toLowerCase());
+};
+
 const LOCAL_ROOT_HOSTS = new Set(["localhost", "127.0.0.1"]);
 const TRAILING_SLASHES_REGEX = /\/+$/;
 const LEADING_SLASHES_REGEX = /^\/+/;
@@ -105,6 +130,9 @@ export const isReservedPath = (pathname: string) => {
   if (assetPrefix && pathname.startsWith(assetPrefix)) {
     return true;
   }
+  if (isRootStaticAsset(pathname)) {
+    return true;
+  }
   return DEFAULT_RESERVED_PATHS.some((prefix) => pathname.startsWith(prefix));
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blodemd",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Blode.md CLI",
   "repository": {
     "type": "git",
@@ -40,7 +40,6 @@
     "@base-ui/react": "^1.3.0",
     "@clack/prompts": "^1.0.0",
     "@mdx-js/mdx": "^3.1.1",
-    "@repo/common": "*",
     "@shikijs/rehype": "^4.0.2",
     "@tailwindcss/postcss": "^4.2.2",
     "@types/node": "^22.19.15",
@@ -74,6 +73,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@repo/common": "*",
     "@repo/previewing": "*",
     "@repo/typescript-config": "*",
     "oxfmt": "^0.42.0",

package/packages/@repo/models/dist/docs-config.d.ts

@@ -443,6 +443,7 @@ export declare const DocsConfigSchema: z.ZodObject<{
             all: "all";
         }>>;
     }, z.core.$strict>>;
+    slug: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type DocsConfig = z.infer<typeof DocsConfigSchema>;
 export declare const MintlifyDocsConfigSchema: z.ZodObject<{
@@ -639,6 +640,7 @@ export declare const MintlifyDocsConfigSchema: z.ZodObject<{
             all: "all";
         }>>;
     }, z.core.$strict>>;
+    slug: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type MintlifyDocsConfig = DocsConfig;
 export declare const ContentTypeSchema: z.ZodEnum<{
@@ -1138,6 +1140,7 @@ export declare const SiteConfigSchema: z.ZodObject<{
             all: "all";
         }>>;
     }, z.core.$strict>>;
+    slug: z.ZodOptional<z.ZodString>;
     theme: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type SiteConfig = z.infer<typeof SiteConfigSchema>;

package/packages/@repo/models/dist/docs-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-config.d.ts","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs-config.d.ts","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":"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"}

package/packages/@repo/models/dist/docs-config.js

@@ -1,5 +1,9 @@
 import { z } from "zod";
 const UrlOrPathSchema = z.string().min(1);
+const SlugSchema = z
+    .string()
+    .min(1)
+    .regex(/^[a-z0-9-]+$/);
 export const DocsColorsSchema = z
     .object({
     background: z.string().optional(),
@@ -370,6 +374,7 @@ export const DocsConfigSchema = z
     navigation: MintlifyNavigationSchema,
     search: MintlifySearchSchema.optional(),
     seo: DocsSeoSchema.optional(),
+    slug: SlugSchema.optional(),
 })
     .strict();
 export const MintlifyDocsConfigSchema = DocsConfigSchema;
@@ -518,6 +523,7 @@ export const SiteConfigSchema = z
     openapiProxy: DocsOpenApiProxySchema.optional(),
     scripts: DocsScriptsSchema.optional(),
     seo: DocsSeoSchema.optional(),
+    slug: SlugSchema.optional(),
     theme: z.string().optional(),
 })
     .strict();

package/packages/@repo/models/src/docs-config.ts

@@ -1,6 +1,10 @@
 import { z } from "zod";
 
 const UrlOrPathSchema = z.string().min(1);
+const SlugSchema = z
+  .string()
+  .min(1)
+  .regex(/^[a-z0-9-]+$/);
 
 export const DocsColorsSchema = z
   .object({
@@ -432,6 +436,7 @@ export const DocsConfigSchema = z
     navigation: MintlifyNavigationSchema,
     search: MintlifySearchSchema.optional(),
     seo: DocsSeoSchema.optional(),
+    slug: SlugSchema.optional(),
   })
   .strict();
 
@@ -610,6 +615,7 @@ export const SiteConfigSchema = z
     openapiProxy: DocsOpenApiProxySchema.optional(),
     scripts: DocsScriptsSchema.optional(),
     seo: DocsSeoSchema.optional(),
+    slug: SlugSchema.optional(),
     theme: z.string().optional(),
   })
   .strict();

package/packages/@repo/previewing/dist/index.d.ts

@@ -13,6 +13,7 @@ export declare const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export declare const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export declare const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
 export declare const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export declare const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 export type SiteConfigResult = {
     ok: true;
     config: SiteConfig;

package/packages/@repo/previewing/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/packages/@repo/previewing/dist/index.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import { ensureArray, normalizePath, slugify } from "@repo/common";
 import { PageModeSchema } from "@repo/models";
 import { extractOpenApiOperations, openApiIdentifier, openApiSlug, parseOpenApiSpec, } from "@repo/prebuild";
-import { validateDocsConfig, validateFrontmatter } from "@repo/validation";
+import { validateDocsConfig, validateFrontmatter, validateSiteConfig, } from "@repo/validation";
 import YAML from "yaml";
 export { BlobContentSource, createBlobSource } from "./blob-source.js";
 export { createFsSource, FsContentSource } from "./fs-source.js";
@@ -15,6 +15,7 @@ export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
 export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 const validModes = new Set(PageModeSchema.options);
 export const buildPageMetadataMap = (index) => {
     const map = new Map();
@@ -203,8 +204,10 @@ const mapDocsConfig = (docs) => {
                 Boolean(docs.api?.openapi || docs.api?.asyncapi),
         },
         seo: docs.seo,
+        slug: docs.slug,
     };
 };
+const getProjectWarnings = (config) => config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
 const readJsonConfig = async (source, relativePath) => JSON.parse(await source.readFile(relativePath));
 const normalizeRefPath = (baseDirectory, reference) => {
     if (reference.startsWith("/") ||
@@ -271,15 +274,25 @@ const loadDocsConfig = async (source) => {
     }
     try {
         const parsed = await readResolvedJsonConfig(source, DOCS_CONFIG_FILE);
-        const result = validateDocsConfig(parsed);
-        if (!result.success) {
-            return { errors: result.errors, ok: false };
+        // Try SiteConfig format first (has collections, theme, colors, etc.)
+        const siteResult = validateSiteConfig(parsed);
+        if (siteResult.success) {
+            return {
+                config: siteResult.data,
+                ok: true,
+                warnings: getProjectWarnings(siteResult.data),
+            };
         }
-        return {
-            config: mapDocsConfig(result.data),
-            ok: true,
-            warnings: [],
-        };
+        // Fall back to DocsConfig format (Mintlify-compatible) and map to SiteConfig
+        const docsResult = validateDocsConfig(parsed);
+        if (docsResult.success) {
+            return {
+                config: mapDocsConfig(docsResult.data),
+                ok: true,
+                warnings: getProjectWarnings(docsResult.data),
+            };
+        }
+        return { errors: docsResult.errors, ok: false };
     }
     catch (error) {
         return {

package/packages/@repo/previewing/src/index.ts

@@ -18,7 +18,11 @@ import {
   parseOpenApiSpec,
 } from "@repo/prebuild";
 import type { OpenApiOperation, OpenApiSpec } from "@repo/prebuild";
-import { validateDocsConfig, validateFrontmatter } from "@repo/validation";
+import {
+  validateDocsConfig,
+  validateFrontmatter,
+  validateSiteConfig,
+} from "@repo/validation";
 import YAML from "yaml";
 
 import type { ContentSource } from "./content-source.js";
@@ -36,6 +40,8 @@ export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
 export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export const LEGACY_PROJECT_NAME_FALLBACK_WARNING =
+  "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 
 export type SiteConfigResult =
   | { ok: true; config: SiteConfig; warnings: string[] }
@@ -330,9 +336,13 @@ const mapDocsConfig = (docs: DocsConfig): SiteConfig => {
         Boolean(docs.api?.openapi || docs.api?.asyncapi),
     },
     seo: docs.seo,
+    slug: docs.slug,
   };
 };
 
+const getProjectWarnings = (config: { slug?: string }): string[] =>
+  config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
+
 const readJsonConfig = async (source: ContentSource, relativePath: string) =>
   JSON.parse(await source.readFile(relativePath)) as unknown;
 
@@ -452,15 +462,28 @@ const loadDocsConfig = async (
 
   try {
     const parsed = await readResolvedJsonConfig(source, DOCS_CONFIG_FILE);
-    const result = validateDocsConfig(parsed);
-    if (!result.success) {
-      return { errors: result.errors, ok: false };
+
+    // Try SiteConfig format first (has collections, theme, colors, etc.)
+    const siteResult = validateSiteConfig(parsed);
+    if (siteResult.success) {
+      return {
+        config: siteResult.data,
+        ok: true,
+        warnings: getProjectWarnings(siteResult.data),
+      };
     }
-    return {
-      config: mapDocsConfig(result.data),
-      ok: true,
-      warnings: [],
-    };
+
+    // Fall back to DocsConfig format (Mintlify-compatible) and map to SiteConfig
+    const docsResult = validateDocsConfig(parsed);
+    if (docsResult.success) {
+      return {
+        config: mapDocsConfig(docsResult.data),
+        ok: true,
+        warnings: getProjectWarnings(docsResult.data),
+      };
+    }
+
+    return { errors: docsResult.errors, ok: false };
   } catch (error) {
     return {
       errors: [

package/packages/@repo/validation/src/blodemd-docs-schema.json

@@ -3233,7 +3233,7 @@
     "name": {
       "type": "string",
       "minLength": 1,
-      "description": "The name of the project, organization, or product"
+      "description": "Display name for your site, project, or organization."
     },
     "description": {
       "type": "string",
@@ -3561,6 +3561,12 @@
       },
       "additionalProperties": false,
       "description": "Metadata configuration for documentation pages"
+    },
+    "slug": {
+      "description": "URL-safe project slug used for deployments and the default `{slug}.blode.md` hostname.",
+      "minLength": 1,
+      "pattern": "^[a-z0-9-]+$",
+      "type": "string"
     }
   },
   "required": ["name", "navigation"],