@knowcode/doc-builder 1.5.11 → 1.5.13

package/html/guides/documentation-standards.html

@@ -36,6 +36,7 @@
     
     <!-- Icons -->
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
     
     <!-- Mermaid -->
     <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -61,8 +62,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:32:13.118Z",
-  "dateModified": "2025-07-22T08:32:13.118Z",
+  "datePublished": "2025-07-22T11:03:54.332Z",
+  "dateModified": "2025-07-22T11:03:54.332Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -101,7 +102,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.12">Last updated: Jul 22, 2025, 11:03 AM UTC</span>
                 </div>
                 
                 
@@ -152,8 +153,8 @@
         <div class="nav-content" >
         <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
         <a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
-        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing and configuring the Vercel CLI across different operating systems and environments."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
-        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide provides a detailed explanation of every prompt you&#039;ll encounter during the first-time Vercel setup process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
+        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
+        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the streamlined Vercel deployment process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
       <div class="nav-section" data-level="1">
         <a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
@@ -174,7 +175,7 @@
         <main class="content">
             <div class="content-inner">
                 <h1>Document Standards for @knowcode/doc-builder</h1>
-<p><strong>Generated</strong>: 2025-07-21 18:00 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: ✅</p>
+<p><strong>Generated</strong>: 2025-07-21 18:00 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: <i class="ph ph-check-circle" aria-label="checked"></i></p>
 <h2>Overview</h2>
 <p>This document defines the documentation standards and conventions for the @knowcode/doc-builder project. All documentation created for or by this project should follow these guidelines to ensure consistency, clarity, and maintainability.</p>
 <h2>Document Structure Standards</h2>
@@ -184,7 +185,7 @@
 
 **Generated**: YYYY-MM-DD HH:MM UTC
 **Status**: Draft/In Progress/Complete  
-**Verified**: ✅ (for verified information) / ❓ (for speculated information)
+**Verified**: <i class="ph ph-check-circle" aria-label="checked"></i> (for verified information) / <i class="ph ph-question" aria-label="question"></i> (for speculated information)
 
 ## Overview
 
@@ -243,16 +244,16 @@ Brief description of the document&#39;s contents and purpose.
 <h3>2. Information Verification</h3>
 <p>Mark all information with verification status:</p>
 <ul>
-<li>✅ <strong>Verified</strong>: Information confirmed through testing or official sources</li>
-<li>❓ <strong>Speculated</strong>: Assumptions or unconfirmed information</li>
-<li>⚠️ <strong>Warning</strong>: Important caveats or potential issues</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Verified</strong>: Information confirmed through testing or official sources</li>
+<li><i class="ph ph-question" aria-label="question"></i> <strong>Speculated</strong>: Assumptions or unconfirmed information</li>
+<li><i class="ph ph-warning-circle" aria-label="warning"></i> <strong>Warning</strong>: Important caveats or potential issues</li>
 <li>🚧 <strong>In Progress</strong>: Features or documentation under development</li>
 </ul>
 <p>Example:</p>
 <pre><code class="language-markdown">### Feature Status
-- ✅ **Markdown parsing**: Fully implemented and tested
-- ❓ **Performance impact**: Estimated 100ms for 50 files
-- ⚠️ **Large files**: May timeout on files &gt; 10MB
+- <i class="ph ph-check-circle" aria-label="checked"></i> **Markdown parsing**: Fully implemented and tested
+- <i class="ph ph-question" aria-label="question"></i> **Performance impact**: Estimated 100ms for 50 files
+- <i class="ph ph-warning-circle" aria-label="warning"></i> **Large files**: May timeout on files &gt; 10MB
 - 🚧 **Search feature**: Currently in development
 </code></pre>
 <h3>3. Code Examples</h3>
@@ -268,9 +269,9 @@ const config = {
 
 try {
   await build(config);
-  console.log(&#39;✅ Build successful&#39;);
+  console.log(&#39;<i class="ph ph-check-circle" aria-label="checked"></i> Build successful&#39;);
 } catch (error) {
-  console.error(&#39;❌ Build failed:&#39;, error.message);
+  console.error(&#39;<i class="ph ph-x-circle" aria-label="error"></i> Build failed:&#39;, error.message);
 }
 </code></pre>
 <p>Guidelines:</p>
@@ -360,9 +361,9 @@ npx doc-builder deploy --prod
 <p>Keep tables readable and well-formatted:</p>
 <pre><code class="language-markdown">| Feature | Status | Version | Notes |
 |---------|--------|---------|-------|
-| Mermaid | ✅ Ready | 1.0.0 | Full support |
+| Mermaid | <i class="ph ph-check-circle" aria-label="checked"></i> Ready | 1.0.0 | Full support |
 | Search | 🚧 WIP | 1.5.0 | In development |
-| Auth | ✅ Ready | 1.3.0 | Optional feature |
+| Auth | <i class="ph ph-check-circle" aria-label="checked"></i> Ready | 1.3.0 | Optional feature |
 </code></pre>
 <h3>Links</h3>
 <ul>
@@ -407,7 +408,7 @@ npx doc-builder deploy --prod
 
 **Generated**: [date]
 **Status**: Complete
-**Verified**: ✅
+**Verified**: <i class="ph ph-check-circle" aria-label="checked"></i>
 
 ## Overview
 What the feature does and why it exists
@@ -430,7 +431,7 @@ Common issues and solutions
 
 **Generated**: [date]
 **Status**: Complete
-**Verified**: ✅
+**Verified**: <i class="ph ph-check-circle" aria-label="checked"></i>
 
 ## Overview
 Technical context and goals
@@ -453,7 +454,7 @@ Benchmarks and optimization
 
 **Generated**: [date]
 **Status**: Complete
-**Verified**: ✅
+**Verified**: <i class="ph ph-check-circle" aria-label="checked"></i>
 
 ## Overview
 What the API does

package/html/guides/google-site-verification-guide.html

@@ -36,6 +36,7 @@
     
     <!-- Icons -->
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
     
     <!-- Mermaid -->
     <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -61,8 +62,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:32:13.126Z",
-  "dateModified": "2025-07-22T08:32:13.126Z",
+  "datePublished": "2025-07-22T11:03:54.338Z",
+  "dateModified": "2025-07-22T11:03:54.338Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html"
@@ -101,7 +102,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.12">Last updated: Jul 22, 2025, 11:03 AM UTC</span>
                 </div>
                 
                 
@@ -152,8 +153,8 @@
         <div class="nav-content" >
         <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
         <a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
-        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing and configuring the Vercel CLI across different operating systems and environments."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
-        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide provides a detailed explanation of every prompt you&#039;ll encounter during the first-time Vercel setup process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
+        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
+        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the streamlined Vercel deployment process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
       <div class="nav-section" data-level="1">
         <a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides

package/html/guides/seo-guide.html

@@ -36,6 +36,7 @@
     
     <!-- Icons -->
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
     
     <!-- Mermaid -->
     <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -61,8 +62,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:32:13.130Z",
-  "dateModified": "2025-07-22T08:32:13.130Z",
+  "datePublished": "2025-07-22T11:03:54.341Z",
+  "dateModified": "2025-07-22T11:03:54.341Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
@@ -101,7 +102,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.12">Last updated: Jul 22, 2025, 11:03 AM UTC</span>
                 </div>
                 
                 
@@ -152,8 +153,8 @@
         <div class="nav-content" >
         <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
         <a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
-        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing and configuring the Vercel CLI across different operating systems and environments."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
-        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide provides a detailed explanation of every prompt you&#039;ll encounter during the first-time Vercel setup process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
+        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
+        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the streamlined Vercel deployment process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
       <div class="nav-section" data-level="1">
         <a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
@@ -412,10 +413,10 @@ author: Different Author
 <pre><code class="language-bash">npx @knowcode/doc-builder build
 </code></pre>
 <p>You&#39;ll see SEO generation in the output:</p>
-<pre><code>🗺️  Generating sitemap.xml...
-✅ Generated sitemap.xml with 23 URLs
-🤖 Generating robots.txt...
-✅ Generated robots.txt
+<pre><code><i class="ph ph-map-trifold" aria-label="map"></i>  Generating sitemap.xml...
+<i class="ph ph-check-circle" aria-label="checked"></i> Generated sitemap.xml with 23 URLs
+<i class="ph ph-robot" aria-label="automation"></i> Generating robots.txt...
+<i class="ph ph-check-circle" aria-label="checked"></i> Generated robots.txt
 </code></pre>
 <h3>2. Check Generated Files</h3>
 <ul>

package/html/guides/seo-optimization-guide.html

@@ -36,6 +36,7 @@
     
     <!-- Icons -->
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
     
     <!-- Mermaid -->
     <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -61,8 +62,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:32:13.137Z",
-  "dateModified": "2025-07-22T08:32:13.137Z",
+  "datePublished": "2025-07-22T11:03:54.346Z",
+  "dateModified": "2025-07-22T11:03:54.346Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html"
@@ -101,7 +102,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.12">Last updated: Jul 22, 2025, 11:03 AM UTC</span>
                 </div>
                 
                 
@@ -152,8 +153,8 @@
         <div class="nav-content" >
         <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
         <a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
-        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing and configuring the Vercel CLI across different operating systems and environments."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
-        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide provides a detailed explanation of every prompt you&#039;ll encounter during the first-time Vercel setup process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
+        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
+        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the streamlined Vercel deployment process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
       <div class="nav-section" data-level="1">
         <a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
@@ -174,7 +175,7 @@
         <main class="content">
             <div class="content-inner">
                 <h1>SEO Optimization Guide</h1>
-<p><strong>Generated</strong>: 2025-07-22 09:00 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: ✅</p>
+<p><strong>Generated</strong>: 2025-07-22 09:00 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: <i class="ph ph-check-circle" aria-label="checked"></i></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>
@@ -308,15 +309,15 @@ keywords: [&quot;authentication&quot;, &quot;security&quot;, &quot;password prot
 <h3>Examples</h3>
 <p>Good titles:</p>
 <ul>
-<li>✅ &quot;Authentication Guide | Doc Builder&quot; (38 chars)</li>
-<li>✅ &quot;SEO Best Practices for Documentation | MyDocs&quot; (45 chars)</li>
-<li>✅ &quot;Quick Start: Deploy to Vercel | Doc Builder&quot; (43 chars)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> &quot;Authentication Guide | Doc Builder&quot; (38 chars)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> &quot;SEO Best Practices for Documentation | MyDocs&quot; (45 chars)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> &quot;Quick Start: Deploy to Vercel | Doc Builder&quot; (43 chars)</li>
 </ul>
 <p>Bad titles:</p>
 <ul>
-<li>❌ &quot;Guide&quot; (5 chars - too short)</li>
-<li>❌ &quot;The Complete Comprehensive Guide to Setting Up Authentication and Security for Your Documentation Website | Doc Builder&quot; (118 chars - too long)</li>
-<li>❌ &quot;Page Title | Site Name | Category | Subcategory&quot; (keyword stuffing)</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;Guide&quot; (5 chars - too short)</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;The Complete Comprehensive Guide to Setting Up Authentication and Security for Your Documentation Website | Doc Builder&quot; (118 chars - too long)</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;Page Title | Site Name | Category | Subcategory&quot; (keyword stuffing)</li>
 </ul>
 <h2>Meta Descriptions</h2>
 <h3>Best Practices</h3>
@@ -338,13 +339,13 @@ keywords: [&quot;authentication&quot;, &quot;security&quot;, &quot;password prot
 <h3>Examples</h3>
 <p>Good descriptions:</p>
 <ul>
-<li>✅ &quot;Learn how to implement authentication in your documentation site. Step-by-step guide with code examples and security best practices.&quot; (139 chars)</li>
-<li>✅ &quot;Optimize your documentation for search engines with our comprehensive SEO guide. Covers titles, descriptions, and keyword strategies.&quot; (143 chars)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> &quot;Learn how to implement authentication in your documentation site. Step-by-step guide with code examples and security best practices.&quot; (139 chars)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> &quot;Optimize your documentation for search engines with our comprehensive SEO guide. Covers titles, descriptions, and keyword strategies.&quot; (143 chars)</li>
 </ul>
 <p>Bad descriptions:</p>
 <ul>
-<li>❌ &quot;This page is about authentication.&quot; (35 chars - too short)</li>
-<li>❌ &quot;Authentication authentication authentication...&quot; (keyword stuffing)</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;This page is about authentication.&quot; (35 chars - too short)</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;Authentication authentication authentication...&quot; (keyword stuffing)</li>
 </ul>
 <h2>Keywords Strategy</h2>
 <h3>Modern Keyword Approach (2025)</h3>
@@ -388,23 +389,23 @@ doc-builder seo-check html/guide.html
 <h3>What It Analyzes in HTML</h3>
 <p>The command inspects the actual HTML output that search engines see:</p>
 <ul>
-<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>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Title tags</strong> - Presence and optimal length (50-60 chars)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Meta descriptions</strong> - Quality and character count (140-160)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Keywords meta tag</strong> - Presence of relevant keywords</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Canonical URLs</strong> - Prevents duplicate content penalties</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>H1 tags</strong> - Ensures proper heading structure</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Open Graph tags</strong> - Social media optimization</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Twitter Card tags</strong> - Twitter/X optimization</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Structured data</strong> - JSON-LD implementation</li>
 </ul>
 <h3>Example Output</h3>
-<pre><code>🔍 Analyzing SEO in generated HTML files...
+<pre><code><i class="ph ph-magnifying-glass" aria-label="search"></i> Analyzing SEO in generated HTML files...
 
-📊 SEO Analysis Complete
+<i class="ph ph-chart-bar" aria-label="chart"></i> SEO Analysis Complete
 
 Analyzed 14 files
 
-❌ Found 2 issues:
+<i class="ph ph-x-circle" aria-label="error"></i> Found 2 issues:
 
   guides/api.html:
     Title too long (75 chars, max 60)
@@ -413,7 +414,7 @@ Analyzed 14 files
   setup.html:
     Missing meta description
     
-💡 8 suggestions:
+<i class="ph ph-lightbulb" aria-label="idea"></i> 8 suggestions:
 
   index.html: Description too short (95 chars, ideal 140-160)
   guides/auth.html: No keywords meta tag found
@@ -478,28 +479,28 @@ Your content here...
 <h2>Common SEO Mistakes to Avoid</h2>
 <h3>1. Duplicate Content</h3>
 <ul>
-<li>❌ Same description on multiple pages</li>
-<li>✅ Unique descriptions for each page</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> Same description on multiple pages</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Unique descriptions for each page</li>
 </ul>
 <h3>2. Keyword Stuffing</h3>
 <ul>
-<li>❌ &quot;Guide guide documentation guide tutorial guide&quot;</li>
-<li>✅ Natural keyword usage in context</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;Guide guide documentation guide tutorial guide&quot;</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Natural keyword usage in context</li>
 </ul>
 <h3>3. Ignoring Mobile</h3>
 <ul>
-<li>❌ Long titles that get cut off on mobile</li>
-<li>✅ Test how titles appear on different devices</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> Long titles that get cut off on mobile</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Test how titles appear on different devices</li>
 </ul>
 <h3>4. Missing Descriptions</h3>
 <ul>
-<li>❌ Leaving description blank</li>
-<li>✅ Always provide meaningful descriptions</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> Leaving description blank</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Always provide meaningful descriptions</li>
 </ul>
 <h3>5. Generic Titles</h3>
 <ul>
-<li>❌ &quot;Documentation&quot;, &quot;Guide&quot;, &quot;Page 1&quot;</li>
-<li>✅ Specific, descriptive titles</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> &quot;Documentation&quot;, &quot;Guide&quot;, &quot;Page 1&quot;</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Specific, descriptive titles</li>
 </ul>
 <h2>SEO Checklist</h2>
 <p>Before publishing, ensure:</p>

package/html/guides/troubleshooting-guide.html

@@ -36,6 +36,7 @@
     
     <!-- Icons -->
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
     
     <!-- Mermaid -->
     <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -61,8 +62,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:32:13.141Z",
-  "dateModified": "2025-07-22T08:32:13.141Z",
+  "datePublished": "2025-07-22T11:03:54.350Z",
+  "dateModified": "2025-07-22T11:03:54.350Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html"
@@ -101,7 +102,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.12">Last updated: Jul 22, 2025, 11:03 AM UTC</span>
                 </div>
                 
                 
@@ -152,8 +153,8 @@
         <div class="nav-content" >
         <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
         <a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
-        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing and configuring the Vercel CLI across different operating systems and environments."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
-        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide provides a detailed explanation of every prompt you&#039;ll encounter during the first-time Vercel setup process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
+        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
+        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the streamlined Vercel deployment process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
       <div class="nav-section" data-level="1">
         <a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
@@ -174,7 +175,7 @@
         <main class="content">
             <div class="content-inner">
                 <h1>Troubleshooting Guide for @knowcode/doc-builder</h1>
-<p><strong>Generated</strong>: 2025-07-21 19:15 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: ✅</p>
+<p><strong>Generated</strong>: 2025-07-21 19:15 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: <i class="ph ph-check-circle" aria-label="checked"></i></p>
 <h2>Overview</h2>
 <p>This guide helps you resolve common issues when using @knowcode/doc-builder. Most problems have simple solutions, and this guide covers the most frequent ones.</p>
 <h2>NPX Cache Issues</h2>
@@ -182,10 +183,10 @@
 <p>The most common issue users face is npx caching an older version of doc-builder.</p>
 <p><strong>Symptoms:</strong></p>
 <ul>
-<li>❌ Running <code>npx @knowcode/doc-builder</code> shows an old version number</li>
-<li>❌ New features aren&#39;t available despite updating</li>
-<li>❌ Bug fixes don&#39;t appear to be working</li>
-<li>❌ Version shown doesn&#39;t match npm registry</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> Running <code>npx @knowcode/doc-builder</code> shows an old version number</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> New features aren&#39;t available despite updating</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> Bug fixes don&#39;t appear to be working</li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> Version shown doesn&#39;t match npm registry</li>
 </ul>
 <p><strong>Example:</strong></p>
 <pre><code class="language-bash">$ npx @knowcode/doc-builder --version
@@ -249,10 +250,10 @@ npx doc-builder deploy  # Uses local version
 </li>
 <li><p><strong>Ensure correct file extensions:</strong></p>
 <ul>
-<li>✅ <code>README.md</code></li>
-<li>✅ <code>guide.md</code></li>
-<li>❌ <code>README.txt</code></li>
-<li>❌ <code>guide.markdown</code></li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <code>README.md</code></li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <code>guide.md</code></li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> <code>README.txt</code></li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> <code>guide.markdown</code></li>
 </ul>
 </li>
 <li><p><strong>Use custom input directory:</strong></p>
@@ -285,13 +286,16 @@ npm install -g vercel
 
 # Verify installation
 vercel --version
+
+# Then retry deployment
+npx @knowcode/doc-builder deploy
 </code></pre>
 <h3>Deployment Fails</h3>
 <p><strong>Common causes:</strong></p>
 <ol>
-<li><p><strong>Root Directory Issue</strong></p>
-<pre><code class="language-bash"># Reset Vercel configuration
-npx @knowcode/doc-builder reset-vercel
+<li><p><strong>Not Logged Into Vercel</strong></p>
+<pre><code class="language-bash"># Login to Vercel first
+vercel login
 </code></pre>
 </li>
 <li><p><strong>Build Not Complete</strong></p>
@@ -300,21 +304,24 @@ npx @knowcode/doc-builder build
 npx @knowcode/doc-builder deploy
 </code></pre>
 </li>
-<li><p><strong>Wrong Directory</strong></p>
+<li><p><strong>Project Name Already Taken</strong></p>
 <ul>
-<li>Ensure you&#39;re in project root</li>
-<li>Check that <code>html/</code> directory exists</li>
+<li>Choose a different project name</li>
+<li>Or delete the existing project in Vercel dashboard</li>
 </ul>
 </li>
 </ol>
 <h3>Wrong Production URL Displayed</h3>
-<p><strong>Problem:</strong> Deployment shows incorrect URL (e.g., <code>doc.vercel.app</code> instead of <code>doc-builder-delta.vercel.app</code>)</p>
-<p><strong>Fixed in:</strong> v1.4.22+</p>
-<p><strong>Solution:</strong></p>
-<pre><code class="language-bash"># Update to latest version
+<p><strong>Problem:</strong> Deployment shows incorrect URL</p>
+<p><strong>Solution 1:</strong> Update to latest version</p>
+<pre><code class="language-bash"># Clear cache and update
 npx clear-npx-cache
 npx @knowcode/doc-builder@latest deploy
 </code></pre>
+<p><strong>Solution 2:</strong> Set custom URL</p>
+<pre><code class="language-bash"># Set your actual production URL
+npx @knowcode/doc-builder set-production-url https://my-docs.vercel.app
+</code></pre>
 <h2>Configuration Issues</h2>
 <h3>Config File Not Loading</h3>
 <p><strong>Symptoms:</strong></p>
@@ -326,9 +333,9 @@ npx @knowcode/doc-builder@latest deploy
 <ol>
 <li><p><strong>Check file name:</strong></p>
 <ul>
-<li>✅ <code>doc-builder.config.js</code></li>
-<li>❌ <code>docbuilder.config.js</code></li>
-<li>❌ <code>doc-builder-config.js</code></li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <code>doc-builder.config.js</code></li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> <code>docbuilder.config.js</code></li>
+<li><i class="ph ph-x-circle" aria-label="error"></i> <code>doc-builder-config.js</code></li>
 </ul>
 </li>
 <li><p><strong>Verify export format:</strong></p>
@@ -476,7 +483,7 @@ npm --version
 </tr>
 <tr>
 <td>Vercel deploy fails</td>
-<td><code>npx @knowcode/doc-builder reset-vercel</code></td>
+<td><code>vercel login</code> then retry</td>
 </tr>
 <tr>
 <td>No markdown found</td>
@@ -494,6 +501,10 @@ npm --version
 <td>Config not loading</td>
 <td>Check filename and format</td>
 </tr>
+<tr>
+<td>404 after deploy</td>
+<td>Check Deployment Protection settings</td>
+</tr>
 </tbody></table>
 <hr>
 <h2>Document History</h2>