@knowcode/doc-builder 1.5.12 → 1.5.14

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:08:52.136Z",
+  "dateModified": "2025-07-22T11:08:52.136Z",
   "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.13">Last updated: Jul 22, 2025, 11:08 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
@@ -163,6 +164,7 @@
         <a href="/guides/claude-workflow-guide.html" class="nav-item" data-tooltip="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it..."><i class="fas fa-file-alt"></i> Claude Workflow Guide</a>
         <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/phosphor-icons-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder automatically converts Unicode emojis in your markdown files to beautiful Phosphor icons in the generated HTML."><i class="fas fa-file-alt"></i> Phosphor Icons 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="@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>
@@ -174,7 +176,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 +310,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 +340,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 +390,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 +415,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 +480,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:08:52.140Z",
+  "dateModified": "2025-07-22T11:08:52.140Z",
   "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.13">Last updated: Jul 22, 2025, 11:08 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
@@ -163,6 +164,7 @@
         <a href="/guides/claude-workflow-guide.html" class="nav-item" data-tooltip="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it..."><i class="fas fa-file-alt"></i> Claude Workflow Guide</a>
         <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/phosphor-icons-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder automatically converts Unicode emojis in your markdown files to beautiful Phosphor icons in the generated HTML."><i class="fas fa-file-alt"></i> Phosphor Icons 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="@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>
@@ -174,7 +176,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 +184,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 +251,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 +287,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 +305,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 +334,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 +484,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 +502,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>

package/html/index.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.098Z",
-  "dateModified": "2025-07-22T08:32:13.098Z",
+  "datePublished": "2025-07-22T11:08:51.999Z",
+  "dateModified": "2025-07-22T11:08:51.999Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -95,7 +96,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.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
                 </div>
                 
                 
@@ -146,8 +147,8 @@
         <div class="nav-content" >
         <a href="/README.html" class="nav-item active" 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
@@ -157,6 +158,7 @@
         <a href="/guides/claude-workflow-guide.html" class="nav-item" data-tooltip="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it..."><i class="fas fa-file-alt"></i> Claude Workflow Guide</a>
         <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/phosphor-icons-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder automatically converts Unicode emojis in your markdown files to beautiful Phosphor icons in the generated HTML."><i class="fas fa-file-alt"></i> Phosphor Icons 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="@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>
@@ -172,7 +174,7 @@
 <p>Transform your markdown documentation into beautiful, searchable websites with Notion-inspired styling</p>
 </blockquote>
 <p><a href="https://www.npmjs.com/package/@knowcode/doc-builder"><img src="https://img.shields.io/npm/v/@knowcode/doc-builder" alt="npm version"></a><br><a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a></p>
-<h2>🚀 Quick Start</h2>
+<h2><i class="ph ph-rocket-launch" aria-label="launch"></i> Quick Start</h2>
 <p>Create stunning documentation sites in minutes:</p>
 <pre><code class="language-bash"># Install globally
 npm install -g @knowcode/doc-builder
@@ -180,45 +182,45 @@ npm install -g @knowcode/doc-builder
 # Or use with npx
 npx @knowcode/doc-builder@latest deploy
 </code></pre>
-<h2>✨ Features</h2>
-<h3>🎨 Beautiful Design</h3>
+<h2><i class="ph ph-sparkle" aria-label="special"></i> Features</h2>
+<h3><i class="ph ph-palette" aria-label="design"></i> Beautiful Design</h3>
 <ul>
 <li><strong>Notion-inspired UI</strong> - Clean, modern interface that users love</li>
 <li><strong>Dark mode support</strong> - Automatic theme switching</li>
 <li><strong>Responsive layout</strong> - Perfect on desktop and mobile</li>
 <li><strong>Syntax highlighting</strong> - Beautiful code blocks with language support</li>
 </ul>
-<h3>🔍 Powerful Search &amp; Navigation</h3>
+<h3><i class="ph ph-magnifying-glass" aria-label="search"></i> Powerful Search &amp; Navigation</h3>
 <ul>
 <li><strong>Full-text search</strong> - Find anything instantly</li>
 <li><strong>Smart navigation</strong> - Hierarchical folder structure</li>
 <li><strong>Breadcrumbs</strong> - Always know where you are</li>
 <li><strong>Keyboard shortcuts</strong> - Navigate like a pro</li>
 </ul>
-<h3>📊 Rich Content Support</h3>
+<h3><i class="ph ph-chart-bar" aria-label="chart"></i> Rich Content Support</h3>
 <ul>
 <li><strong>Mermaid diagrams</strong> - Flowcharts, sequence diagrams, and more</li>
 <li><strong>GitHub-flavored markdown</strong> - Tables, task lists, and strikethrough</li>
 <li><strong>Interactive tooltips</strong> - Document summaries on hover</li>
 <li><strong>Version tracking</strong> - Know which version built your docs</li>
 </ul>
-<h3>🚀 Easy Deployment</h3>
+<h3><i class="ph ph-rocket-launch" aria-label="launch"></i> Easy Deployment</h3>
 <ul>
 <li><strong>One-command deploy</strong> - Push to Vercel instantly</li>
 <li><strong>Static site generation</strong> - Fast, secure, and scalable</li>
 <li><strong>Custom domains</strong> - Your docs, your brand</li>
 <li><strong>Preview deployments</strong> - Test before going live</li>
 </ul>
-<h2>📖 Documentation</h2>
+<h2><i class="ph ph-book-open" aria-label="reading"></i> Documentation</h2>
 <p>Visit our <a href="https://www.npmjs.com/package/@knowcode/doc-builder">official documentation</a> for detailed guides and API reference.</p>
-<h2>🎯 Perfect For</h2>
+<h2><i class="ph ph-target" aria-label="goal"></i> Perfect For</h2>
 <ul>
 <li><strong>Open source projects</strong> - Beautiful docs for your community</li>
 <li><strong>Technical teams</strong> - Internal documentation that developers actually use</li>
 <li><strong>API documentation</strong> - Clear, searchable API references</li>
 <li><strong>Knowledge bases</strong> - Organize and share team knowledge</li>
 </ul>
-<h2>🛠️ Simple Workflow</h2>
+<h2><i class="ph ph-gear-six" aria-label="tools"></i> Simple Workflow</h2>
 <h3>1. Initialize Your Project</h3>
 <pre><code class="language-bash">npx @knowcode/doc-builder init
 </code></pre>
@@ -236,9 +238,9 @@ npm install amazing-package
 
 ## Features
 
-- ✅ Feature one
-- ✅ Feature two
-- ✅ Feature three
+- <i class="ph ph-check-circle" aria-label="checked"></i> Feature one
+- <i class="ph ph-check-circle" aria-label="checked"></i> Feature two
+- <i class="ph ph-check-circle" aria-label="checked"></i> Feature three
 </code></pre>
 <h3>3. Build &amp; Preview</h3>
 <pre><code class="language-bash"># Build your site
@@ -250,7 +252,7 @@ npx doc-builder serve
 <h3>4. Deploy to Vercel</h3>
 <pre><code class="language-bash">npx doc-builder deploy
 </code></pre>
-<h2>🎨 Customization</h2>
+<h2><i class="ph ph-palette" aria-label="design"></i> Customization</h2>
 <p>Configure your site with <code>doc-builder.config.js</code>:</p>
 <pre><code class="language-javascript">module.exports = {
   siteName: &#39;Your Amazing Docs&#39;,
@@ -262,7 +264,7 @@ npx doc-builder serve
   }
 };
 </code></pre>
-<h2>📊 Mermaid Diagram Support</h2>
+<h2><i class="ph ph-chart-bar" aria-label="chart"></i> Mermaid Diagram Support</h2>
 <p>Create beautiful diagrams in your markdown:</p>
 <div class="mermaid-wrapper">
       <div class="mermaid-title">Diagram</div>
@@ -274,13 +276,13 @@ npx doc-builder serve
     style A fill:#e1f5fe
     style D fill:#c8e6c9</div>
     </div>
-<h2>🔒 Optional Authentication</h2>
+<h2><i class="ph ph-lock" aria-label="locked"></i> Optional Authentication</h2>
 <p>Protect sensitive documentation with built-in authentication:</p>
 <pre><code class="language-javascript">features: {
   authentication: true
 }
 </code></pre>
-<h2>🌟 Why doc-builder?</h2>
+<h2><i class="ph ph-star-four" aria-label="sparkle"></i> Why doc-builder?</h2>
 <ul>
 <li><strong>Zero configuration</strong> - Works out of the box</li>
 <li><strong>Lightning fast</strong> - Static site generation for instant loading</li>
@@ -289,13 +291,13 @@ npx doc-builder serve
 <li><strong>Version control</strong> - Track changes with Git</li>
 <li><strong>Open source</strong> - MIT licensed</li>
 </ul>
-<h2>🤝 Contributing</h2>
+<h2><i class="ph ph-handshake" aria-label="partnership"></i> Contributing</h2>
 <p>We welcome contributions! Check out our <a href="https://github.com/knowcode/doc-builder">contribution guide</a> to get started.</p>
-<h2>📝 License</h2>
+<h2><i class="ph ph-note-pencil" aria-label="edit"></i> License</h2>
 <p>MIT © KnowCode</p>
 <hr>
 <div align="center">
-  <p>Built with ❤️ by developers, for developers</p>
+  <p>Built with <i class="ph ph-heart" aria-label="love"></i> by developers, for developers</p>
   <p>
     <a href="https://www.npmjs.com/package/@knowcode/doc-builder">npm</a> •
     <a href="https://github.com/knowcode/doc-builder">GitHub</a> •