@knowcode/doc-builder 1.5.4 → 1.5.6

package/CHANGELOG.md

@@ -5,6 +5,45 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.6] - 2025-07-22
+
+### Fixed
+- Fixed missing gray-matter import in cli.js causing seo-check command to fail
+- Resolved "path argument must be string" error when running seo-check
+
+## [1.5.5] - 2025-07-22
+
+### Added
+- **Front Matter Support**: Parse YAML front matter for page-specific SEO customization
+- **SEO Check Command**: New `seo-check` command to analyze and report SEO issues
+- **Smart Description Extraction**: Intelligent extraction of intro paragraphs for better descriptions
+- **Enhanced Title Generation**: SEO-optimized titles with customizable templates
+- **Page-specific Keywords**: Support for front matter keywords plus auto-extraction
+- **Comprehensive SEO Guide**: Detailed documentation for SEO optimization
+
+### Changed
+- Improved `generateDescription` with smart mode for better meta descriptions
+- Title generation now respects 50-60 character limit with smart truncation
+- Keywords can be defined per-page via front matter
+- SEO configuration expanded with new options
+
+### Features
+- **Front Matter SEO**: Add custom title, description, and keywords per page
+- **Title Templates**: Configure title format with `{pageTitle} | {siteName}` patterns
+- **Auto Keywords**: Automatically extract relevant keywords from content
+- **SEO Analysis**: Run `doc-builder seo-check` to find and fix SEO issues
+- **Smart Defaults**: Intelligent fallbacks for missing SEO data
+
+### Configuration
+```javascript
+seo: {
+  titleTemplate: '{pageTitle} | {siteName}',
+  autoKeywords: true,
+  keywordLimit: 7,
+  descriptionFallback: 'smart'
+}
+```
+
 ## [1.5.4] - 2025-07-22
 
 ### Added

package/CLAUDE.md

@@ -312,6 +312,9 @@ build(config).then(() => {
 
 MIT License - See LICENSE file for details
 
+### NPM Features Documentation
+- When we add new features - add it to the NPM documented bullet point features - if its a big feature give it a section
+
 ---
 
 **Note**: This project was extracted from the cybersolstice monorepo on 2025-07-21 with full git history preservation.

package/README.md

@@ -49,6 +49,9 @@ This aligns perfectly with our mission: beautiful documentation should be access
 - 🔄 **Live Reload** - Development server with hot reloading
 - ☁️ **Vercel Integration** - One-command deployment to Vercel
 - 🔍 **SEO Optimized** - Meta tags, Open Graph, Twitter Cards, and structured data
+- ✅ **Google Site Verification** - Easy Google Search Console verification with CLI command
+- 📝 **Front Matter SEO** - Per-page titles, descriptions, and keywords with YAML front matter
+- 🎯 **SEO Analysis** - Built-in `seo-check` command to optimize your content
 - 📦 **Self-Contained** - No configuration or setup required
 - 🤖 **Claude Code Ready** - Optimized for AI-generated documentation workflows
 
@@ -147,6 +150,44 @@ npx @knowcode/doc-builder set-production-url https://my-custom-domain.com
 
 This is useful when you have a custom domain or Vercel alias that differs from the auto-detected URL.
 
+### google-verify
+
+Add Google site verification meta tag for Google Search Console:
+
+```bash
+# Add your verification code
+npx @knowcode/doc-builder google-verify YOUR_VERIFICATION_CODE
+
+# Example
+npx @knowcode/doc-builder google-verify FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ
+```
+
+This adds the verification meta tag to all generated HTML pages, allowing you to verify ownership in Google Search Console. See the [Google Site Verification Guide](docs/guides/google-site-verification-guide.md) for complete details.
+
+### seo-check
+
+Analyze and optimize your documentation's SEO:
+
+```bash
+# Check all pages for SEO issues
+npx @knowcode/doc-builder seo-check
+
+# Check a specific page
+npx @knowcode/doc-builder seo-check docs/guide.md
+
+# Future: Auto-fix common issues
+npx @knowcode/doc-builder seo-check --fix
+```
+
+This command analyzes:
+- Title length and optimization (50-60 characters)
+- Meta descriptions (140-160 characters)
+- Keywords usage and relevance
+- Front matter SEO fields
+- Content quality signals
+
+See the [SEO Optimization Guide](docs/guides/seo-optimization-guide.md) for best practices.
+
 ### setup-seo
 Interactive SEO configuration wizard:
 ```bash

package/cli.js

@@ -10,7 +10,9 @@ const { build } = require('./lib/builder');
 const { startDevServer } = require('./lib/dev-server');
 const { deployToVercel, setupVercelProject, prepareDeployment } = require('./lib/deploy');
 const { loadConfig, createDefaultConfig } = require('./lib/config');
+const { generateDescription } = require('./lib/seo');
 const { execSync } = require('child_process');
+const matter = require('gray-matter');
 
 // Package info
 const packageJson = require('./package.json');
@@ -191,6 +193,177 @@ ${chalk.yellow('Get your verification code from Google Search Console.')}
     }
   });
 
+// SEO Check command
+program
+  .command('seo-check [path]')
+  .description('Analyze SEO for your documentation pages')
+  .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
+  .option('--fix', 'auto-fix common SEO issues')
+  .addHelpText('after', `
+${chalk.yellow('Examples:')}
+  ${chalk.gray('$')} doc-builder seo-check                    ${chalk.gray('# Check all pages')}
+  ${chalk.gray('$')} doc-builder seo-check docs/guide.md      ${chalk.gray('# Check specific page')}
+  ${chalk.gray('$')} doc-builder seo-check --fix              ${chalk.gray('# Auto-fix issues')}
+
+${chalk.yellow('This command analyzes:')}
+  • Title length and optimization (50-60 characters)
+  • Meta descriptions (140-160 characters)
+  • Keywords usage and relevance
+  • Front matter SEO fields
+  • Duplicate content issues
+`)
+  .action(async (filePath, options) => {
+    try {
+      const config = await loadConfig(options.config);
+      const docsDir = path.resolve(config.docsDir || 'docs');
+      
+      console.log(chalk.cyan('🔍 Analyzing SEO...'));
+      
+      // Get files to check
+      let files = [];
+      if (filePath) {
+        const fullPath = path.resolve(filePath);
+        if (await fs.pathExists(fullPath)) {
+          files = [fullPath];
+        } else {
+          console.error(chalk.red(`File not found: ${filePath}`));
+          process.exit(1);
+        }
+      } else {
+        // Get all markdown files
+        const getAllFiles = async (dir) => {
+          const results = [];
+          const items = await fs.readdir(dir);
+          for (const item of items) {
+            const fullPath = path.join(dir, item);
+            const stat = await fs.stat(fullPath);
+            if (stat.isDirectory() && !item.startsWith('.')) {
+              results.push(...await getAllFiles(fullPath));
+            } else if (item.endsWith('.md')) {
+              results.push(fullPath);
+            }
+          }
+          return results;
+        };
+        files = await getAllFiles(docsDir);
+      }
+      
+      // Analyze each file
+      const issues = [];
+      const suggestions = [];
+      
+      for (const file of files) {
+        const content = await fs.readFile(file, 'utf-8');
+        const { data: frontMatter, content: mainContent } = matter(content);
+        const relativePath = path.relative(docsDir, file);
+        
+        // Extract current metadata
+        const h1Match = mainContent.match(/^#\s+(.+)$/m);
+        const h1Title = h1Match ? h1Match[1] : null;
+        const title = frontMatter.title || h1Title || path.basename(file, '.md');
+        const description = frontMatter.description || generateDescription(mainContent, 'smart');
+        const keywords = frontMatter.keywords || [];
+        
+        // Check title
+        const titleLength = title.length;
+        if (titleLength > 60) {
+          issues.push({
+            file: relativePath,
+            type: 'title',
+            message: `Title too long (${titleLength} chars, max 60)`,
+            current: title,
+            suggestion: title.substring(0, 57) + '...'
+          });
+        } else if (titleLength < 30) {
+          suggestions.push({
+            file: relativePath,
+            type: 'title',
+            message: `Title might be too short (${titleLength} chars, ideal 50-60)`
+          });
+        }
+        
+        // Check description
+        const descLength = description.length;
+        if (descLength > 160) {
+          issues.push({
+            file: relativePath,
+            type: 'description',
+            message: `Description too long (${descLength} chars, max 160)`,
+            current: description,
+            suggestion: description.substring(0, 157) + '...'
+          });
+        } else if (descLength < 120) {
+          suggestions.push({
+            file: relativePath,
+            type: 'description',
+            message: `Description might be too short (${descLength} chars, ideal 140-160)`
+          });
+        }
+        
+        // Check keywords
+        if (keywords.length === 0 && !frontMatter.description) {
+          suggestions.push({
+            file: relativePath,
+            type: 'keywords',
+            message: 'No keywords defined in front matter'
+          });
+        }
+        
+        // Check for front matter
+        if (!frontMatter.title && !frontMatter.description) {
+          suggestions.push({
+            file: relativePath,
+            type: 'frontmatter',
+            message: 'No SEO front matter found'
+          });
+        }
+      }
+      
+      // Display results
+      console.log(`\n${chalk.cyan('📊 SEO Analysis Complete')}\n`);
+      console.log(`Analyzed ${files.length} files\n`);
+      
+      if (issues.length === 0 && suggestions.length === 0) {
+        console.log(chalk.green('✅ No SEO issues found!'));
+      } else {
+        if (issues.length > 0) {
+          console.log(chalk.red(`❌ Found ${issues.length} issues:\n`));
+          issues.forEach(issue => {
+            console.log(chalk.red(`  ${issue.file}:`));
+            console.log(chalk.yellow(`    ${issue.message}`));
+            if (issue.suggestion) {
+              console.log(chalk.gray(`    Suggestion: ${issue.suggestion.substring(0, 50)}...`));
+            }
+            console.log('');
+          });
+        }
+        
+        if (suggestions.length > 0) {
+          console.log(chalk.yellow(`💡 ${suggestions.length} suggestions:\n`));
+          suggestions.forEach(suggestion => {
+            console.log(chalk.yellow(`  ${suggestion.file}: ${suggestion.message}`));
+          });
+        }
+        
+        console.log(`\n${chalk.cyan('💡 Tips:')}`);
+        console.log('  • Add front matter to customize SEO per page');
+        console.log('  • Keep titles between 50-60 characters');
+        console.log('  • Write descriptions between 140-160 characters');
+        console.log('  • Include relevant keywords in front matter');
+        console.log(`\n${chalk.gray('Example front matter:')}`);
+        console.log(chalk.gray('---'));
+        console.log(chalk.gray('title: "Your SEO Optimized Title Here"'));
+        console.log(chalk.gray('description: "A compelling description between 140-160 characters that includes keywords and encourages clicks."'));
+        console.log(chalk.gray('keywords: ["keyword1", "keyword2", "keyword3"]'));
+        console.log(chalk.gray('---'));
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('Failed to analyze SEO:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Set Production URL command
 program
   .command('set-production-url <url>')

package/html/README.html

@@ -3,19 +3,19 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="@knowcode/doc-builder.">
-    <title>@knowcode/doc-builder - Doc Builder</title>
+    <meta name="description" content="&gt; Transform your markdown documentation into beautiful, searchable websites with Notion-inspired styling.">
+    <title>@knowcode/doc-builder | Doc Builder</title>
     
     <meta name="author" content="Lindsay Smith">
-    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, your, knowcode, doc, builder">
+    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, your, knowcode">
     <meta name="robots" content="index, follow">
     <link rel="canonical" href="https://doc-builder-delta.vercel.app/README.html">
     
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/README.html">
-    <meta property="og:title" content="@knowcode/doc-builder - Doc Builder">
-    <meta property="og:description" content="@knowcode/doc-builder.">
+    <meta property="og:title" content="@knowcode/doc-builder | Doc Builder">
+    <meta property="og:description" content="&gt; Transform your markdown documentation into beautiful, searchable websites with Notion-inspired styling.">
     <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     <meta property="og:site_name" content="Doc Builder">
     <meta property="og:locale" content="en_US">
@@ -24,8 +24,8 @@
     <meta name="twitter:card" content="summary_large_image">
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
-    <meta name="twitter:title" content="@knowcode/doc-builder - Doc Builder">
-    <meta name="twitter:description" content="@knowcode/doc-builder.">
+    <meta name="twitter:title" content="@knowcode/doc-builder | Doc Builder">
+    <meta name="twitter:description" content="&gt; Transform your markdown documentation into beautiful, searchable websites with Notion-inspired styling.">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
     <!-- Custom Meta Tags -->
@@ -51,7 +51,7 @@
   "@context": "https://schema.org",
   "@type": "TechArticle",
   "headline": "@knowcode/doc-builder",
-  "description": "@knowcode/doc-builder.",
+  "description": "> Transform your markdown documentation into beautiful, searchable websites with Notion-inspired styling.",
   "author": {
     "@type": "Person",
     "name": "Lindsay Smith"
@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T06:56:56.764Z",
-  "dateModified": "2025-07-22T06:56:56.764Z",
+  "datePublished": "2025-07-22T08:09:57.857Z",
+  "dateModified": "2025-07-22T08:09:57.857Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -95,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.3">Last updated: Jul 22, 2025, 06:56 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
                 </div>
                 
                 
@@ -158,6 +158,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/documentation-index.html

@@ -3,19 +3,19 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="Documentation Index.">
-    <title>Documentation Index - Doc Builder</title>
+    <meta name="description" content="Generated: 2025-07-21 18:00 UTC">
+    <title>Documentation Index | Doc Builder</title>
     
     <meta name="author" content="Lindsay Smith">
-    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, guide, claude, standards, document">
+    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, guide, claude">
     <meta name="robots" content="index, follow">
     <link rel="canonical" href="https://doc-builder-delta.vercel.app/documentation-index.html">
     
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/documentation-index.html">
-    <meta property="og:title" content="Documentation Index - Doc Builder">
-    <meta property="og:description" content="Documentation Index.">
+    <meta property="og:title" content="Documentation Index | Doc Builder">
+    <meta property="og:description" content="Generated: 2025-07-21 18:00 UTC">
     <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     <meta property="og:site_name" content="Doc Builder">
     <meta property="og:locale" content="en_US">
@@ -24,8 +24,8 @@
     <meta name="twitter:card" content="summary_large_image">
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
-    <meta name="twitter:title" content="Documentation Index - Doc Builder">
-    <meta name="twitter:description" content="Documentation Index.">
+    <meta name="twitter:title" content="Documentation Index | Doc Builder">
+    <meta name="twitter:description" content="Generated: 2025-07-21 18:00 UTC">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
     <!-- Custom Meta Tags -->
@@ -51,7 +51,7 @@
   "@context": "https://schema.org",
   "@type": "TechArticle",
   "headline": "Documentation Index",
-  "description": "Documentation Index.",
+  "description": "Generated: 2025-07-21 18:00 UTC",
   "author": {
     "@type": "Person",
     "name": "Lindsay Smith"
@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T06:56:56.775Z",
-  "dateModified": "2025-07-22T06:56:56.775Z",
+  "datePublished": "2025-07-22T08:09:57.871Z",
+  "dateModified": "2025-07-22T08:09:57.871Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -95,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.3">Last updated: Jul 22, 2025, 06:56 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
                 </div>
                 
                 
@@ -158,6 +158,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/authentication-guide.html

@@ -3,19 +3,19 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="Authentication Guide for @knowcode/doc-builder.">
-    <title>Authentication Guide for @knowcode/doc-builder - Doc Builder</title>
+    <meta name="description" content="Generated: 2025-07-21 18:30 UTC">
+    <title>Authentication Guide for @knowcode/doc-builder | Doc Builder</title>
     
     <meta name="author" content="Lindsay Smith">
-    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, authentication, login, access, credentials, page">
+    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, authentication, login">
     <meta name="robots" content="index, follow">
     <link rel="canonical" href="https://doc-builder-delta.vercel.app/guides/authentication-guide.html">
     
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/authentication-guide.html">
-    <meta property="og:title" content="Authentication Guide for @knowcode/doc-builder - Doc Builder">
-    <meta property="og:description" content="Authentication Guide for @knowcode/doc-builder.">
+    <meta property="og:title" content="Authentication Guide for @knowcode/doc-builder | Doc Builder">
+    <meta property="og:description" content="Generated: 2025-07-21 18:30 UTC">
     <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     <meta property="og:site_name" content="Doc Builder">
     <meta property="og:locale" content="en_US">
@@ -24,8 +24,8 @@
     <meta name="twitter:card" content="summary_large_image">
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
-    <meta name="twitter:title" content="Authentication Guide for @knowcode/doc-builder - Doc Builder">
-    <meta name="twitter:description" content="Authentication Guide for @knowcode/doc-builder.">
+    <meta name="twitter:title" content="Authentication Guide for @knowcode/doc-builder | Doc Builder">
+    <meta name="twitter:description" content="Generated: 2025-07-21 18:30 UTC">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
     <!-- Custom Meta Tags -->
@@ -51,7 +51,7 @@
   "@context": "https://schema.org",
   "@type": "TechArticle",
   "headline": "Authentication Guide for @knowcode/doc-builder",
-  "description": "Authentication Guide for @knowcode/doc-builder.",
+  "description": "Generated: 2025-07-21 18:30 UTC",
   "author": {
     "@type": "Person",
     "name": "Lindsay Smith"
@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T06:56:56.778Z",
-  "dateModified": "2025-07-22T06:56:56.778Z",
+  "datePublished": "2025-07-22T08:09:57.875Z",
+  "dateModified": "2025-07-22T08:09:57.875Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.3">Last updated: Jul 22, 2025, 06:56 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
                 </div>
                 
                 
@@ -164,6 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/claude-workflow-guide.html

@@ -3,19 +3,19 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="Claude + CLAUDE.">
-    <title>Claude + CLAUDE.md Documentation Workflow Guide - Doc Builder</title>
+    <meta name="description" content="Generated: 2025-07-21 10:00 UTC">
+    <title>Claude + CLAUDE.md Documentation Workflow Guide</title>
     
     <meta name="author" content="Lindsay Smith">
-    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, claude, workflow, step">
+    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, claude, workflow">
     <meta name="robots" content="index, follow">
     <link rel="canonical" href="https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html">
     
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html">
-    <meta property="og:title" content="Claude + CLAUDE.md Documentation Workflow Guide - Doc Builder">
-    <meta property="og:description" content="Claude + CLAUDE.">
+    <meta property="og:title" content="Claude + CLAUDE.md Documentation Workflow Guide">
+    <meta property="og:description" content="Generated: 2025-07-21 10:00 UTC">
     <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     <meta property="og:site_name" content="Doc Builder">
     <meta property="og:locale" content="en_US">
@@ -24,8 +24,8 @@
     <meta name="twitter:card" content="summary_large_image">
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
-    <meta name="twitter:title" content="Claude + CLAUDE.md Documentation Workflow Guide - Doc Builder">
-    <meta name="twitter:description" content="Claude + CLAUDE.">
+    <meta name="twitter:title" content="Claude + CLAUDE.md Documentation Workflow Guide">
+    <meta name="twitter:description" content="Generated: 2025-07-21 10:00 UTC">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
     <!-- Custom Meta Tags -->
@@ -51,7 +51,7 @@
   "@context": "https://schema.org",
   "@type": "TechArticle",
   "headline": "Claude + CLAUDE.md Documentation Workflow Guide",
-  "description": "Claude + CLAUDE.",
+  "description": "Generated: 2025-07-21 10:00 UTC",
   "author": {
     "@type": "Person",
     "name": "Lindsay Smith"
@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T06:56:56.781Z",
-  "dateModified": "2025-07-22T06:56:56.781Z",
+  "datePublished": "2025-07-22T08:09:57.879Z",
+  "dateModified": "2025-07-22T08:09:57.879Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.3">Last updated: Jul 22, 2025, 06:56 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
                 </div>
                 
                 
@@ -164,6 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>