@clidey/dory 0.27.0 → 0.29.0

package/dist/index.html

@@ -7,14 +7,14 @@
     <meta name="theme-color" content="#000000" />
     
     <!-- Primary Meta Tags -->
-    <meta name="description" content="Docucod generates and maintains up-to-date documentation from your codebase so your team can move fast, onboard quickly, and stay focused on building." />
+    <meta name="description" content="Docucod - Technical Documentation" />
     <meta name="keywords" content="documentation, code documentation, auto documentation, developer tools, technical documentation, codebase documentation, llm, ai, anthropic, openai, chatgpt, claude, clidey" />
     <meta name="author" content="Clidey" />
     <meta name="language" content="English" />
     
     <!-- Open Graph / Facebook -->
-    <meta property="og:title" content="Docucod: Generate and Maintain Documentation With No Work" />
-    <meta property="og:description" content="Docucod auto-generates and maintains up-to-date documentation from your codebase so your team can move fast, onboard quickly, and stay focused on building." />
+    <meta property="og:title" content="Docucod" />
+    <meta property="og:description" content="Docucod - Technical Documentation" />
     <meta property="og:image" content="/assets/favicon-nLquwUQp.svg" />
     <meta property="og:url" content="https://docucod.com/" />
     <meta property="og:type" content="website" />
@@ -23,8 +23,8 @@
     
     <!-- Twitter -->
     <meta name="twitter:card" content="summary_large_image" />
-    <meta name="twitter:title" content="Docucod: Generate and Maintain Documentation With No Work" />
-    <meta name="twitter:description" content="Docucod auto-generates and maintains up-to-date documentation from your codebase so your team can move fast, onboard quickly, and stay focused on building." />
+    <meta name="twitter:title" content="Docucod" />
+    <meta name="twitter:description" content="Docucod - Technical Documentation" />
     <meta name="twitter:image" content="/assets/favicon-nLquwUQp.svg" />
     <meta name="twitter:site" content="@ClideyOfficial" />
     <meta name="twitter:creator" content="@ClideyOfficial" />
@@ -32,7 +32,7 @@
     <link rel="apple-touch-icon" href="/assets/favicon-nLquwUQp.svg" />
     <link rel="manifest" href="/manifest.json" />
     
-    <title>Docucod - Instantly Generate and Maintain Your Documentation</title>
+    <title>Docucod</title>
 
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
@@ -45,7 +45,7 @@
             person_profiles: 'identified_only', // or 'always' to create profiles for anonymous users as well
         })
     </script>
-    <script type="module" crossorigin src="/assets/index-CPVd_vt1.js"></script>
+    <script type="module" crossorigin src="/assets/index-B2MKmN57.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-Btb13Da-.css">
   </head>
   <body>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@clidey/dory",
   "private": false,
-  "version": "0.27.0",
+  "version": "0.29.0",
   "type": "module",
   "description": "A CLI tool for building and previewing documentation sites",
   "keywords": [

package/src/plugins/html-metadata-injector.ts

@@ -0,0 +1,76 @@
+import type { Plugin } from 'vite';
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * Vite plugin that injects site metadata from dory.json into index.html
+ * This provides proper defaults before JavaScript hydrates the page
+ */
+export function htmlMetadataInjector(): Plugin {
+  return {
+    name: 'html-metadata-injector',
+    transformIndexHtml(html) {
+      // Read dory.json configuration
+      const doryJsonPath = resolve(process.cwd(), 'docs', 'dory.json');
+
+      if (!existsSync(doryJsonPath)) {
+        console.warn('⚠️  dory.json not found, using default metadata');
+        return html;
+      }
+
+      try {
+        const config = JSON.parse(readFileSync(doryJsonPath, 'utf-8'));
+        const siteName = config.name || 'Documentation';
+        const defaultTitle = config.title || siteName;
+        const defaultDescription = config.description || `${siteName} - Technical Documentation`;
+
+        // Replace title
+        html = html.replace(
+          /<title>.*?<\/title>/,
+          `<title>${defaultTitle}</title>`
+        );
+
+        // Replace meta description
+        html = html.replace(
+          /<meta name="description" content=".*?" \/>/,
+          `<meta name="description" content="${defaultDescription}" />`
+        );
+
+        // Replace Open Graph title
+        html = html.replace(
+          /<meta property="og:title" content=".*?" \/>/,
+          `<meta property="og:title" content="${defaultTitle}" />`
+        );
+
+        // Replace Open Graph description
+        html = html.replace(
+          /<meta property="og:description" content=".*?" \/>/,
+          `<meta property="og:description" content="${defaultDescription}" />`
+        );
+
+        // Replace Open Graph site name
+        html = html.replace(
+          /<meta property="og:site_name" content=".*?" \/>/,
+          `<meta property="og:site_name" content="${siteName}" />`
+        );
+
+        // Replace Twitter title
+        html = html.replace(
+          /<meta name="twitter:title" content=".*?" \/>/,
+          `<meta name="twitter:title" content="${defaultTitle}" />`
+        );
+
+        // Replace Twitter description
+        html = html.replace(
+          /<meta name="twitter:description" content=".*?" \/>/,
+          `<meta name="twitter:description" content="${defaultDescription}" />`
+        );
+
+        return html;
+      } catch (error) {
+        console.error('❌ Failed to parse dory.json for metadata injection:', error);
+        return html;
+      }
+    },
+  };
+}

package/src/ui/layout.tsx

@@ -83,28 +83,61 @@ export default function Layout({ children }: LayoutProps) {
     });
   }, [pathname]);
 
-  const { title: group, group: title } = useMemo(() => {
-    const group = ALL_NAVIGATION.flatMap((tab) => 
-      tab.groups.find((group) => 
+  const { title: group, group: title, page } = useMemo(() => {
+    const group = ALL_NAVIGATION.flatMap((tab) =>
+      tab.groups.find((group) =>
         group.pages.some((page) => page.href === pathname)
       )
     );
     const page = completeFrontMatter.find((page) => page.path === pathname);
 
-    useEffect(() => {
-      if (page?.title) {
-        document.title = page.title;
+    return { group: group[0]?.title, title: page?.title, page };
+  }, [pathname, loading]);
+
+  // Update document title and meta tags when page changes
+  useEffect(() => {
+    if (page?.title) {
+      document.title = page.title;
+
+      // Update Open Graph title
+      const ogTitle = document.querySelector('meta[property="og:title"]');
+      if (ogTitle) {
+        ogTitle.setAttribute('content', page.title);
       }
-      if (page?.description) {
-        const metaDescription = document.querySelector('meta[name="description"]');
-        if (metaDescription) {
-          metaDescription.setAttribute('content', page.description);
-        }
+
+      // Update Twitter title
+      const twitterTitle = document.querySelector('meta[name="twitter:title"]');
+      if (twitterTitle) {
+        twitterTitle.setAttribute('content', page.title);
       }
-    }, [page]);
+    }
 
-    return { group: group[0]?.title, title: page?.title,  };
-  }, [pathname, loading]);
+    if (page?.description) {
+      // Update standard meta description
+      const metaDescription = document.querySelector('meta[name="description"]');
+      if (metaDescription) {
+        metaDescription.setAttribute('content', page.description);
+      }
+
+      // Update Open Graph description
+      const ogDescription = document.querySelector('meta[property="og:description"]');
+      if (ogDescription) {
+        ogDescription.setAttribute('content', page.description);
+      }
+
+      // Update Twitter description
+      const twitterDescription = document.querySelector('meta[name="twitter:description"]');
+      if (twitterDescription) {
+        twitterDescription.setAttribute('content', page.description);
+      }
+    }
+
+    // Update canonical URL
+    const ogUrl = document.querySelector('meta[property="og:url"]');
+    if (ogUrl) {
+      ogUrl.setAttribute('content', window.location.href);
+    }
+  }, [page]);
 
   const tab = useMemo(() => {
     return completeFrontMatter.find((page) => page.path === pathname);

package/vite.config.ts

@@ -8,6 +8,7 @@ import { llmTxtDevServer } from './src/plugins/llm-txt-dev-server';
 import { frontmatterGenerator } from './src/plugins/frontmatter-generator';
 import { frontmatterDevServer } from './src/plugins/frontmatter-dev-server';
 import { docsAssetsPlugin } from './src/plugins/docs-assets';
+import { htmlMetadataInjector } from './src/plugins/html-metadata-injector';
 import { getMdxConfig } from './src/config/mdx';
 
 export default defineConfig(({ command }) => ({
@@ -22,6 +23,7 @@ export default defineConfig(({ command }) => ({
     frontmatterGenerator(),
     frontmatterDevServer(),
     docsAssetsPlugin(),
+    htmlMetadataInjector(),
   ],
   resolve: {
     alias: {