@knowcode/doc-builder 1.5.8 → 1.5.10

package/.claude/settings.local.json

@@ -25,7 +25,8 @@
       "Bash(vercel alias:*)",
       "Bash(find:*)",
       "Bash(diff:*)",
-      "Bash(git log:*)"
+      "Bash(git log:*)",
+      "Bash(mkdir:*)"
     ],
     "deny": []
   }

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.10] - 2025-07-22
+
+### Fixed
+- Automatically create missing docs directory when running build, dev, or deploy commands
+- No longer fails with "ENOENT: no such file or directory" when docs folder is missing
+- Creates placeholder README.md in newly created docs directory
+- Removed duplicate warning messages about missing docs directory
+
+### Improved
+- Better handling of empty projects - just run `doc-builder build` and it creates everything needed
+- Cleaner console output without redundant warnings
+- Ensures output directory exists before building
+
+## [1.5.9] - 2025-07-22
+
+### Added
+- Comprehensive SEO Optimization Guide with extensive external resources
+- Detailed explanations of all SEO features and how they work
+- References to 20+ external SEO tools and learning resources
+- Keyword research tools and performance testing recommendations
+- SEO monitoring strategies and success metrics
+- Actionable SEO checklist for documentation projects
+
+### Documentation
+- Created detailed guide explaining automatic meta tag generation
+- Added sections on Open Graph Protocol and Twitter Cards
+- Included structured data (JSON-LD) explanations
+- Referenced Google's official SEO guidelines and best practices
+- Added links to free SEO tools and validators
+
 ## [1.5.8] - 2025-07-22
 
 ### Changed

package/cli.js

@@ -83,7 +83,7 @@ ${chalk.yellow('Examples:')}
     const spinner = ora('Building documentation...').start();
     
     try {
-      const config = await loadConfig(options.config || 'doc-builder.config.js', options);
+      const config = await loadConfig(options.config || 'doc-builder.config.js', { ...options, command: 'build' });
       await build(config);
       spinner.succeed('Documentation built successfully!');
     } catch (error) {
@@ -112,7 +112,7 @@ ${chalk.yellow('Examples:')}
 `)
   .action(async (options) => {
     try {
-      const config = await loadConfig(options.config, options);
+      const config = await loadConfig(options.config, { ...options, command: 'dev' });
       await startDevServer(config, options.port);
     } catch (error) {
       console.error(chalk.red(error.message));
@@ -645,7 +645,7 @@ ${chalk.yellow('Troubleshooting:')}
     const spinner = ora('Deploying to Vercel...').start();
     
     try {
-      const config = await loadConfig(options.config || 'doc-builder.config.js', options);
+      const config = await loadConfig(options.config || 'doc-builder.config.js', { ...options, command: 'deploy' });
       
       // First check if Vercel CLI is installed
       try {

package/html/README.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.857Z",
-  "dateModified": "2025-07-22T08:09:57.857Z",
+  "datePublished": "2025-07-22T08:32:13.098Z",
+  "dateModified": "2025-07-22T08:32:13.098Z",
   "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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.871Z",
-  "dateModified": "2025-07-22T08:09:57.871Z",
+  "datePublished": "2025-07-22T08:32:13.109Z",
+  "dateModified": "2025-07-22T08:32:13.109Z",
   "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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.875Z",
-  "dateModified": "2025-07-22T08:09:57.875Z",
+  "datePublished": "2025-07-22T08:32:13.111Z",
+  "dateModified": "2025-07-22T08:32:13.111Z",
   "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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.879Z",
-  "dateModified": "2025-07-22T08:09:57.879Z",
+  "datePublished": "2025-07-22T08:32:13.114Z",
+  "dateModified": "2025-07-22T08:32:13.114Z",
   "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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/documentation-standards.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.884Z",
-  "dateModified": "2025-07-22T08:09:57.884Z",
+  "datePublished": "2025-07-22T08:32:13.118Z",
+  "dateModified": "2025-07-22T08:32:13.118Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item active" 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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/google-site-verification-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.893Z",
-  "dateModified": "2025-07-22T08:09:57.893Z",
+  "datePublished": "2025-07-22T08:32:13.126Z",
+  "dateModified": "2025-07-22T08:32:13.126Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/google-site-verification-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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +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 active" 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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/seo-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.898Z",
-  "dateModified": "2025-07-22T08:09:57.898Z",
+  "datePublished": "2025-07-22T08:32:13.130Z",
+  "dateModified": "2025-07-22T08:32:13.130Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +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 active" 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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/seo-optimization-guide.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="Learn how to optimize your documentation for search engines with front matter, smart titles, and keyword strategies for better rankings.">
+    <meta name="description" content="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings.">
     <title>SEO Optimization Guide for @knowcode/doc-builder</title>
     
     <meta name="author" content="Lindsay Smith">
@@ -15,7 +15,7 @@
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html">
     <meta property="og:title" content="SEO Optimization Guide for @knowcode/doc-builder">
-    <meta property="og:description" content="Learn how to optimize your documentation for search engines with front matter, smart titles, and keyword strategies for better rankings.">
+    <meta property="og:description" content="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings.">
     <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">
@@ -25,7 +25,7 @@
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
     <meta name="twitter:title" content="SEO Optimization Guide for @knowcode/doc-builder">
-    <meta name="twitter:description" content="Learn how to optimize your documentation for search engines with front matter, smart titles, and keyword strategies for better rankings.">
+    <meta name="twitter:description" content="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings.">
     <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": "SEO Optimization Guide for @knowcode/doc-builder",
-  "description": "Learn how to optimize your documentation for search engines with front matter, smart titles, and keyword strategies for better rankings.",
+  "description": "Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings.",
   "author": {
     "@type": "Person",
     "name": "Lindsay Smith"
@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.904Z",
-  "dateModified": "2025-07-22T08:09:57.904Z",
+  "datePublished": "2025-07-22T08:32:13.137Z",
+  "dateModified": "2025-07-22T08:32:13.137Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +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 active" 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/seo-optimization-guide.html" class="nav-item active" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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>
@@ -174,16 +174,104 @@
         <main class="content">
             <div class="content-inner">
                 <h1>SEO Optimization Guide</h1>
-<p>This guide explains how to optimize your documentation for search engines using @knowcode/doc-builder&#39;s advanced SEO features.</p>
+<p><strong>Generated</strong>: 2025-07-22 09:00 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: ✅</p>
 <h2>Overview</h2>
+<p>@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search engines. This guide explains what these features do, how to use them effectively, and provides references to authoritative SEO resources.</p>
+<h2>Why SEO Matters for Documentation</h2>
 <p>Good SEO helps your documentation:</p>
 <ul>
-<li>Rank higher in search results</li>
-<li>Get more organic traffic</li>
-<li>Improve click-through rates</li>
-<li>Reach the right audience</li>
-<li>Build domain authority</li>
+<li><strong>Rank higher</strong> in search results (Google, Bing, DuckDuckGo)</li>
+<li><strong>Get more organic traffic</strong> from developers searching for solutions</li>
+<li><strong>Improve click-through rates</strong> with compelling titles and descriptions</li>
+<li><strong>Reach the right audience</strong> with targeted keywords</li>
+<li><strong>Build domain authority</strong> and credibility</li>
 </ul>
+<p>According to <a href="https://developers.google.com/search/docs/fundamentals/creating-helpful-content">Google&#39;s Search Quality Guidelines</a>, high-quality technical documentation that helps users is prioritized in search results.</p>
+<h2>What Our SEO Features Do</h2>
+<h3>1. Automatic Meta Tag Generation</h3>
+<p>Doc-builder automatically generates essential HTML meta tags for every page:</p>
+<pre><code class="language-html">&lt;!-- Page Title - Shows in browser tabs and search results --&gt;
+&lt;title&gt;Your Page Title | Site Name&lt;/title&gt;
+
+&lt;!-- Meta Description - The snippet shown in search results --&gt;
+&lt;meta name=&quot;description&quot; content=&quot;Your page description here&quot;&gt;
+
+&lt;!-- Keywords - Helps search engines understand topic relevance --&gt;
+&lt;meta name=&quot;keywords&quot; content=&quot;keyword1, keyword2, keyword3&quot;&gt;
+
+&lt;!-- Author Information --&gt;
+&lt;meta name=&quot;author&quot; content=&quot;Your Name&quot;&gt;
+
+&lt;!-- Canonical URL - Prevents duplicate content issues --&gt;
+&lt;link rel=&quot;canonical&quot; href=&quot;https://yoursite.com/page.html&quot;&gt;
+
+&lt;!-- Language and Region --&gt;
+&lt;meta property=&quot;og:locale&quot; content=&quot;en_US&quot;&gt;
+</code></pre>
+<h3>2. Open Graph Protocol (Facebook, LinkedIn, Slack)</h3>
+<p>Ensures your documentation looks professional when shared on social media:</p>
+<pre><code class="language-html">&lt;meta property=&quot;og:type&quot; content=&quot;article&quot;&gt;
+&lt;meta property=&quot;og:title&quot; content=&quot;Page Title&quot;&gt;
+&lt;meta property=&quot;og:description&quot; content=&quot;Page description&quot;&gt;
+&lt;meta property=&quot;og:url&quot; content=&quot;https://yoursite.com/page.html&quot;&gt;
+&lt;meta property=&quot;og:image&quot; content=&quot;https://yoursite.com/og-image.png&quot;&gt;
+&lt;meta property=&quot;og:site_name&quot; content=&quot;Your Site Name&quot;&gt;
+</code></pre>
+<p>Learn more: <a href="https://ogp.me/">Open Graph Protocol Official Documentation</a></p>
+<h3>3. Twitter Card Tags</h3>
+<p>Optimizes how your documentation appears on Twitter/X:</p>
+<pre><code class="language-html">&lt;meta name=&quot;twitter:card&quot; content=&quot;summary_large_image&quot;&gt;
+&lt;meta name=&quot;twitter:site&quot; content=&quot;@yourhandle&quot;&gt;
+&lt;meta name=&quot;twitter:title&quot; content=&quot;Page Title&quot;&gt;
+&lt;meta name=&quot;twitter:description&quot; content=&quot;Page description&quot;&gt;
+&lt;meta name=&quot;twitter:image&quot; content=&quot;https://yoursite.com/twitter-image.png&quot;&gt;
+</code></pre>
+<p>Test your cards: <a href="https://cards-dev.twitter.com/validator">Twitter Card Validator</a></p>
+<h3>4. Structured Data (JSON-LD)</h3>
+<p>Helps search engines understand your content structure and display rich snippets:</p>
+<pre><code class="language-json">{
+  &quot;@context&quot;: &quot;https://schema.org&quot;,
+  &quot;@type&quot;: &quot;TechArticle&quot;,
+  &quot;headline&quot;: &quot;Your Page Title&quot;,
+  &quot;description&quot;: &quot;Your page description&quot;,
+  &quot;author&quot;: {
+    &quot;@type&quot;: &quot;Person&quot;,
+    &quot;name&quot;: &quot;Author Name&quot;
+  },
+  &quot;publisher&quot;: {
+    &quot;@type&quot;: &quot;Organization&quot;,
+    &quot;name&quot;: &quot;Your Organization&quot;,
+    &quot;url&quot;: &quot;https://yoursite.com&quot;
+  },
+  &quot;datePublished&quot;: &quot;2025-01-22&quot;,
+  &quot;dateModified&quot;: &quot;2025-01-22&quot;,
+  &quot;breadcrumb&quot;: {
+    &quot;@type&quot;: &quot;BreadcrumbList&quot;,
+    &quot;itemListElement&quot;: [...]
+  }
+}
+</code></pre>
+<p>Validate your structured data: <a href="https://search.google.com/test/rich-results">Google&#39;s Rich Results Test</a></p>
+<h3>5. Automatic Sitemap Generation</h3>
+<p>Creates a <code>sitemap.xml</code> file that helps search engines discover all your pages:</p>
+<pre><code class="language-xml">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
+&lt;urlset xmlns=&quot;http://www.sitemaps.org/schemas/sitemap/0.9&quot;&gt;
+  &lt;url&gt;
+    &lt;loc&gt;https://yoursite.com/index.html&lt;/loc&gt;
+    &lt;lastmod&gt;2025-01-22&lt;/lastmod&gt;
+    &lt;changefreq&gt;weekly&lt;/changefreq&gt;
+    &lt;priority&gt;1.0&lt;/priority&gt;
+  &lt;/url&gt;
+  &lt;!-- More URLs --&gt;
+&lt;/urlset&gt;
+</code></pre>
+<p>Submit your sitemap: <a href="https://search.google.com/search-console">Google Search Console</a></p>
+<h3>6. Robots.txt Generation</h3>
+<p>Controls how search engines crawl your site:</p>
+<pre><code>User-agent: *
+Allow: /
+Sitemap: https://yoursite.com/sitemap.xml
+</code></pre>
 <h2>Front Matter Support (v1.5.5+)</h2>
 <p>@knowcode/doc-builder now supports YAML front matter for page-specific SEO customization:</p>
 <pre><code class="language-yaml">---
@@ -286,43 +374,52 @@ keywords:
   - &quot;doc-builder security&quot;
 ---
 </code></pre>
-<h2>Using the SEO Check Command</h2>
-<p>Analyze your documentation&#39;s SEO:</p>
-<pre><code class="language-bash"># Check all pages
-doc-builder seo-check
+<h2>Using the SEO Check Command (v1.5.8+)</h2>
+<p>The <code>seo-check</code> command analyzes your <strong>generated HTML files</strong> to ensure they&#39;re properly optimized:</p>
+<pre><code class="language-bash"># First, build your documentation
+doc-builder build
 
-# Check specific page
-doc-builder seo-check docs/guide.md
+# Then analyze the generated HTML
+doc-builder seo-check
 
-# Auto-fix issues (coming soon)
-doc-builder seo-check --fix
+# Check specific HTML file
+doc-builder seo-check html/guide.html
 </code></pre>
-<h3>What It Checks</h3>
+<h3>What It Analyzes in HTML</h3>
+<p>The command inspects the actual HTML output that search engines see:</p>
 <ul>
-<li>✓ Title length and optimization</li>
-<li>✓ Description length and quality</li>
-<li>✓ Keywords presence</li>
-<li>✓ Front matter usage</li>
-<li>✓ Duplicate content</li>
+<li>✅ <strong>Title tags</strong> - Presence and optimal length (50-60 chars)</li>
+<li>✅ <strong>Meta descriptions</strong> - Quality and character count (140-160)</li>
+<li>✅ <strong>Keywords meta tag</strong> - Presence of relevant keywords</li>
+<li>✅ <strong>Canonical URLs</strong> - Prevents duplicate content penalties</li>
+<li>✅ <strong>H1 tags</strong> - Ensures proper heading structure</li>
+<li>✅ <strong>Open Graph tags</strong> - Social media optimization</li>
+<li>✅ <strong>Twitter Card tags</strong> - Twitter/X optimization</li>
+<li>✅ <strong>Structured data</strong> - JSON-LD implementation</li>
 </ul>
 <h3>Example Output</h3>
-<pre><code>🔍 Analyzing SEO...
+<pre><code>🔍 Analyzing SEO in generated HTML files...
 
 📊 SEO Analysis Complete
 
-Analyzed 10 files
+Analyzed 14 files
 
 ❌ Found 2 issues:
 
-  guides/api.md:
+  guides/api.html:
     Title too long (75 chars, max 60)
     Suggestion: API Reference Documentation for Doc Build...
 
-💡 5 suggestions:
+  setup.html:
+    Missing meta description
+    
+💡 8 suggestions:
 
-  README.md: No keywords defined in front matter
-  guides/setup.md: Description might be too short (95 chars, ideal 140-160)
-  guides/deploy.md: No SEO front matter found
+  index.html: Description too short (95 chars, ideal 140-160)
+  guides/auth.html: No keywords meta tag found
+  api/endpoints.html: Missing canonical URL
+  tutorials/intro.html: H1 differs from page title
+  guides/deploy.html: Missing Open Graph tags
 </code></pre>
 <h2>Advanced Configuration</h2>
 <h3>Per-Page Customization</h3>
@@ -453,34 +550,232 @@ Your content here...
 <li>Expand content for high-value pages</li>
 <li>Build internal links between related docs</li>
 </ol>
+<h2>External SEO Tools and Resources</h2>
+<h3>Essential SEO Tools</h3>
+<h4>1. <strong>Google Search Console</strong> - <a href="https://search.google.com/search-console">search.google.com/search-console</a></h4>
+<ul>
+<li>Monitor your documentation&#39;s search performance</li>
+<li>Submit sitemaps for faster indexing</li>
+<li>Find crawl errors and indexing issues</li>
+<li>See which queries bring users to your docs</li>
+<li><strong>Free tool from Google</strong></li>
+</ul>
+<h4>2. <strong>Google PageSpeed Insights</strong> - <a href="https://pagespeed.web.dev">pagespeed.web.dev</a></h4>
+<ul>
+<li>Test page load performance</li>
+<li>Get specific optimization suggestions</li>
+<li>Check Core Web Vitals scores</li>
+<li>Mobile and desktop analysis</li>
+<li><strong>Free tool</strong></li>
+</ul>
+<h4>3. <strong>Ahrefs Webmaster Tools</strong> - <a href="https://ahrefs.com/webmaster-tools">ahrefs.com/webmaster-tools</a></h4>
+<ul>
+<li>Free SEO health monitoring</li>
+<li>Backlink analysis</li>
+<li>Keyword rankings</li>
+<li>Site audit features</li>
+<li><strong>Free version available</strong></li>
+</ul>
+<h4>4. <strong>Schema Markup Validator</strong> - <a href="https://validator.schema.org">validator.schema.org</a></h4>
+<ul>
+<li>Validate your structured data</li>
+<li>Test JSON-LD implementation</li>
+<li>Find schema errors</li>
+<li><strong>Free tool</strong></li>
+</ul>
+<h4>5. <strong>Open Graph Debugger</strong> - <a href="https://www.opengraph.xyz">opengraph.xyz</a></h4>
+<ul>
+<li>Preview how your docs appear on social media</li>
+<li>Debug Open Graph tags</li>
+<li>Test different URLs</li>
+<li><strong>Free tool</strong></li>
+</ul>
+<h3>SEO Learning Resources</h3>
+<h4>Beginner Resources</h4>
+<ol>
+<li><p><strong>Google SEO Starter Guide</strong> - <a href="https://developers.google.com/search/docs/fundamentals/seo-starter-guide">developers.google.com/search/docs/fundamentals/seo-starter-guide</a></p>
+<ul>
+<li>Official guide from Google</li>
+<li>Covers all SEO basics</li>
+<li>Best practices straight from the source</li>
+</ul>
+</li>
+<li><p><strong>Moz Beginner&#39;s Guide to SEO</strong> - <a href="https://moz.com/beginners-guide-to-seo">moz.com/beginners-guide-to-seo</a></p>
+<ul>
+<li>Comprehensive 7-chapter guide</li>
+<li>Visual explanations</li>
+<li>Industry-standard resource</li>
+</ul>
+</li>
+</ol>
+<h4>Advanced Resources</h4>
+<ol start="3">
+<li><p><strong>Ahrefs SEO Guide</strong> - <a href="https://ahrefs.com/seo">ahrefs.com/seo</a></p>
+<ul>
+<li>Data-driven strategies</li>
+<li>Advanced techniques</li>
+<li>Case studies and examples</li>
+</ul>
+</li>
+<li><p><strong>Search Engine Journal</strong> - <a href="https://searchenginejournal.com">searchenginejournal.com</a></p>
+<ul>
+<li>Latest SEO news and updates</li>
+<li>Algorithm change analysis</li>
+<li>Expert insights</li>
+</ul>
+</li>
+<li><p><strong>Technical SEO Guide</strong> - <a href="https://developers.google.com/search/docs/advanced/guidelines">developers.google.com/search/docs/advanced/guidelines</a></p>
+<ul>
+<li>Google&#39;s technical requirements</li>
+<li>Crawling and indexing details</li>
+<li>Advanced implementation</li>
+</ul>
+</li>
+</ol>
+<h3>Keyword Research Tools</h3>
+<ol>
+<li><p><strong>Google Keyword Planner</strong> - <a href="https://ads.google.com/keywordplanner">ads.google.com/keywordplanner</a></p>
+<ul>
+<li>Free with Google Ads account</li>
+<li>Search volume data</li>
+<li>Keyword suggestions</li>
+</ul>
+</li>
+<li><p><strong>Ubersuggest</strong> - <a href="https://neilpatel.com/ubersuggest">neilpatel.com/ubersuggest</a></p>
+<ul>
+<li>Free keyword research</li>
+<li>Content ideas</li>
+<li>Competitor analysis</li>
+</ul>
+</li>
+<li><p><strong>Answer The Public</strong> - <a href="https://answerthepublic.com">answerthepublic.com</a></p>
+<ul>
+<li>Find questions people ask</li>
+<li>Visual keyword research</li>
+<li>Great for documentation topics</li>
+</ul>
+</li>
+<li><p><strong>Google Trends</strong> - <a href="https://trends.google.com">trends.google.com</a></p>
+<ul>
+<li>Track keyword popularity over time</li>
+<li>Compare search terms</li>
+<li>Find rising topics</li>
+</ul>
+</li>
+</ol>
+<h3>Performance Testing</h3>
+<ol>
+<li><p><strong>GTmetrix</strong> - <a href="https://gtmetrix.com">gtmetrix.com</a></p>
+<ul>
+<li>Detailed performance reports</li>
+<li>Waterfall charts</li>
+<li>Historical tracking</li>
+</ul>
+</li>
+<li><p><strong>WebPageTest</strong> - <a href="https://webpagetest.org">webpagetest.org</a></p>
+<ul>
+<li>Advanced performance testing</li>
+<li>Multiple location testing</li>
+<li>Video capture of page load</li>
+</ul>
+</li>
+<li><p><strong>Lighthouse</strong> (Built into Chrome DevTools)</p>
+<ul>
+<li>Performance, SEO, and accessibility audits</li>
+<li>Actionable recommendations</li>
+<li>CLI version available</li>
+</ul>
+</li>
+</ol>
+<h3>Documentation-Specific SEO Tips</h3>
+<p>According to <a href="https://developers.google.com/style/seo">Google&#39;s Documentation Best Practices</a>:</p>
+<ol>
+<li><strong>Use descriptive URLs</strong> - <code>/guides/authentication</code> not <code>/page1</code></li>
+<li><strong>Create comprehensive content</strong> - Answer the full question</li>
+<li><strong>Use code examples</strong> - Show, don&#39;t just tell</li>
+<li><strong>Keep content fresh</strong> - Update regularly</li>
+<li><strong>Internal linking</strong> - Connect related topics</li>
+</ol>
 <h2>Quick Reference</h2>
 <h3>Front Matter Template</h3>
 <pre><code class="language-yaml">---
 title: &quot;Your SEO Optimized Title Here | Brand&quot;
 description: &quot;A compelling 140-160 character description that includes keywords and encourages clicks from search results.&quot;
 keywords: [&quot;primary keyword&quot;, &quot;secondary keyword&quot;, &quot;long-tail phrase&quot;]
+author: &quot;Your Name&quot;
+date: &quot;2025-01-22&quot;
 ---
 </code></pre>
 <h3>CLI Commands</h3>
-<pre><code class="language-bash"># Check SEO
+<pre><code class="language-bash"># Build your documentation
+doc-builder build
+
+# Check SEO of generated HTML
 doc-builder seo-check
 
 # Add Google verification
 doc-builder google-verify YOUR_CODE
 
-# Build with SEO
-doc-builder build
+# Deploy with SEO optimization
+doc-builder deploy
 </code></pre>
+<h3>SEO Checklist</h3>
+<p>Before publishing:</p>
+<ul>
+<li><input disabled="" type="checkbox"> Run <code>doc-builder build</code> to generate HTML</li>
+<li><input disabled="" type="checkbox"> Run <code>doc-builder seo-check</code> to find issues</li>
+<li><input disabled="" type="checkbox"> Fix any critical SEO problems</li>
+<li><input disabled="" type="checkbox"> Add front matter to important pages</li>
+<li><input disabled="" type="checkbox"> Set production URL in config</li>
+<li><input disabled="" type="checkbox"> Generate and submit sitemap</li>
+<li><input disabled="" type="checkbox"> Set up Google Search Console</li>
+<li><input disabled="" type="checkbox"> Add Google Analytics (optional)</li>
+<li><input disabled="" type="checkbox"> Test social media previews</li>
+<li><input disabled="" type="checkbox"> Check page load speed</li>
+</ul>
+<h2>Monitoring Success</h2>
+<h3>Key Metrics to Track</h3>
+<ol>
+<li><strong>Organic Traffic</strong> - Visitors from search engines</li>
+<li><strong>Search Impressions</strong> - How often you appear in results</li>
+<li><strong>Click-Through Rate (CTR)</strong> - Percentage who click</li>
+<li><strong>Average Position</strong> - Where you rank for keywords</li>
+<li><strong>Page Load Time</strong> - Speed affects rankings</li>
+</ol>
+<h3>Tools for Monitoring</h3>
+<ul>
+<li><strong>Google Analytics 4</strong> - <a href="https://analytics.google.com">analytics.google.com</a></li>
+<li><strong>Google Search Console</strong> - Track search performance</li>
+<li><strong>Ahrefs/SEMrush</strong> - Competitive analysis</li>
+<li><strong>Custom dashboards</strong> - Combine multiple data sources</li>
+</ul>
 <h2>Next Steps</h2>
 <ol>
-<li>Add front matter to your important pages</li>
-<li>Run <code>seo-check</code> to identify issues</li>
-<li>Configure global SEO settings</li>
+<li><p><strong>Immediate Actions</strong>:</p>
+<ul>
+<li>Add front matter to your top 10 pages</li>
+<li>Run <code>seo-check</code> and fix critical issues</li>
 <li>Set up Google Search Console</li>
-<li>Monitor and optimize based on data</li>
+</ul>
+</li>
+<li><p><strong>This Week</strong>:</p>
+<ul>
+<li>Optimize all page titles and descriptions</li>
+<li>Submit sitemap to search engines</li>
+<li>Test and fix page load speed</li>
+</ul>
+</li>
+<li><p><strong>Ongoing</strong>:</p>
+<ul>
+<li>Monitor search performance weekly</li>
+<li>Update content based on user queries</li>
+<li>Build internal links between related docs</li>
+<li>Keep content fresh and accurate</li>
+</ul>
+</li>
 </ol>
 <hr>
-<p>For more help, see the <a href="./google-site-verification-guide.md">Google Site Verification Guide</a> or run <code>doc-builder --help</code>.</p>
+<p>For more help, see the <a href="./google-site-verification-guide.md">Google Site Verification Guide</a> or join the <a href="https://github.com/knowcode/doc-builder/discussions">doc-builder community</a>.</p>
 
             </div>
         </main>

package/html/guides/troubleshooting-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.907Z",
-  "dateModified": "2025-07-22T08:09:57.907Z",
+  "datePublished": "2025-07-22T08:32:13.141Z",
+  "dateModified": "2025-07-22T08:32:13.141Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item active" 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/index.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.857Z",
-  "dateModified": "2025-07-22T08:09:57.857Z",
+  "datePublished": "2025-07-22T08:32:13.098Z",
+  "dateModified": "2025-07-22T08:32:13.098Z",
   "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.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/sitemap.xml

@@ -2,91 +2,91 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://doc-builder-delta.vercel.app/404.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
-    <lastmod>2025-07-22T08:09:57.928Z</lastmod>
+    <lastmod>2025-07-22T08:32:13.156Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

package/html/vercel-cli-setup-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.912Z",
-  "dateModified": "2025-07-22T08:09:57.912Z",
+  "datePublished": "2025-07-22T08:32:13.144Z",
+  "dateModified": "2025-07-22T08:32:13.144Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -95,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/vercel-first-time-setup-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.916Z",
-  "dateModified": "2025-07-22T08:09:57.916Z",
+  "datePublished": "2025-07-22T08:32:13.147Z",
+  "dateModified": "2025-07-22T08:32:13.147Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -95,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +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/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><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/lib/config.js

@@ -251,11 +251,15 @@ async function loadConfig(configPath, options = {}) {
     }
   }
   
-  // Validate paths - but be lenient for deploy command
+  // Validate paths - but be lenient for commands that will create directories
   const docsPath = path.join(process.cwd(), config.docsDir);
   if (!fs.existsSync(docsPath)) {
-    console.warn(chalk.yellow(`Warning: Documentation directory not found: ${config.docsDir}`));
-    console.log(chalk.gray(`Create it with: mkdir ${config.docsDir} && echo "# Documentation" > ${config.docsDir}/README.md`));
+    // Only show warning for commands that don't auto-create the directory
+    // The build command will create it automatically
+    if (!options || !['build', 'dev', 'deploy'].includes(options.command)) {
+      console.warn(chalk.yellow(`Warning: Documentation directory not found: ${config.docsDir}`));
+      console.log(chalk.gray(`Create it with: mkdir ${config.docsDir} && echo "# Documentation" > ${config.docsDir}/README.md`));
+    }
     // Don't throw error - let commands handle missing directories appropriately
   }
   

package/lib/core-builder.js

@@ -672,6 +672,9 @@ async function buildDocumentation(config) {
   const packageJson = require('../package.json');
   console.log(chalk.blue(`📦 Using @knowcode/doc-builder v${packageJson.version}`));
   
+  // Ensure output directory exists
+  await fs.ensureDir(outputDir);
+  
   // Check and create placeholder README.md if missing
   console.log(chalk.blue('📋 Checking documentation structure...'));
   const readmeGenerated = await createPlaceholderReadme(docsDir, config);
@@ -867,6 +870,17 @@ async function buildDocumentation(config) {
 
 // Create placeholder README.md if missing
 async function createPlaceholderReadme(docsDir, config) {
+  // Create docs directory if it doesn't exist
+  if (!fs.existsSync(docsDir)) {
+    try {
+      await fs.ensureDir(docsDir);
+      console.log(chalk.yellow(`📁 Created missing docs directory: ${docsDir}`));
+    } catch (error) {
+      console.error(chalk.red(`Error creating docs directory: ${error.message}`));
+      throw error;
+    }
+  }
+  
   const readmePath = path.join(docsDir, 'README.md');
   const indexPath = path.join(docsDir, 'index.md');
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.5.8",
+  "version": "1.5.10",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {