@knowcode/doc-builder 1.6.1 → 1.6.3

package/html/README.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.406Z",
-  "dateModified": "2025-07-23T06:51:04.406Z",
+  "datePublished": "2025-07-23T09:24:11.374Z",
+  "dateModified": "2025-07-23T09:24:11.374Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 
@@ -401,7 +401,7 @@ docBuilder.build({
 <p><strong>Connect with us:</strong></p>
 <ul>
 <li><i class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
-<li>🐙 <a href="https://github.com/wapdat/doc-builder">GitHub Repo</a></li>
+<li><i class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/wapdat/doc-builder">GitHub Repo</a></li>
 <li><i class="ph ph-globe" aria-label="global"></i> <a href="https://knowcode.com">Website</a></li>
 <li><i class="ph ph-chat-circle" aria-label="chat"></i> <a href="https://github.com/wapdat/doc-builder/discussions">Discussions</a></li>
 </ul>

package/html/documentation-index.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.420Z",
-  "dateModified": "2025-07-23T06:51:04.420Z",
+  "datePublished": "2025-07-23T09:24:11.384Z",
+  "dateModified": "2025-07-23T09:24:11.384Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/guides/authentication-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.424Z",
-  "dateModified": "2025-07-23T06:51:04.424Z",
+  "datePublished": "2025-07-23T09:24:11.387Z",
+  "dateModified": "2025-07-23T09:24:11.387Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

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

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.431Z",
-  "dateModified": "2025-07-23T06:51:04.431Z",
+  "datePublished": "2025-07-23T09:24:11.391Z",
+  "dateModified": "2025-07-23T09:24:11.391Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 
@@ -462,12 +462,81 @@ function handleError(error) {
 <li><a href="/CONTRIBUTING.md">Contributing Guide</a></li>
 </ul>
 <pre><code>
-### 1.2 Global CLAUDE.md Best Practices
+### 1.2 Setting Up Admin/Background/Environment Facts
 
-Your global `~/.claude/CLAUDE.md` should include universal standards that apply to all projects. Here&#39;s an expanded example:
+For Claude to generate accurate and consistent content, include key organizational and environmental facts in your CLAUDE.md. This ensures all generated documentation uses correct information:
 
 ```markdown
-# Global CLAUDE.md Instructions
+## Organization &amp; Environment Facts
+
+### Company Information
+- **Organization Name**: Knowcode Ltd
+- **Website**: https://knowcode.tech
+- **Contact Email**: support@knowcode.tech
+- **GitHub Organization**: https://github.com/knowcode
+- **NPM Organization**: @knowcode
+
+### Author Information
+- **Primary Author**: Lindsay Smith
+- **Author Email**: lindsay@knowcode.tech
+- **Author Title**: Lead Developer
+- **GitHub Handle**: @lindsaysmith
+- **Twitter/X Handle**: @planbbackups
+
+### Project Environment
+- **Production URL**: https://doc-builder-delta.vercel.app
+- **Staging URL**: https://doc-builder-staging.vercel.app
+- **Documentation URL**: https://docs.knowcode.tech
+- **API Base URL**: https://api.knowcode.tech
+- **CDN URL**: https://cdn.knowcode.tech
+
+### Default Settings
+- **Default Language**: en-US
+- **Timezone**: UTC
+- **Date Format**: YYYY-MM-DD
+- **Copyright Year**: 2025
+- **License**: MIT
+- **Version**: 1.6.2
+
+### SEO Defaults
+- **Default Author**: Lindsay Smith
+- **Organization Type**: Software Company
+- **Twitter Handle**: @planbbackups
+- **LinkedIn**: https://linkedin.com/company/knowcode
+- **Facebook Page**: https://facebook.com/knowcode
+
+### Technical Stack
+- **Primary Language**: JavaScript/TypeScript
+- **Node Version**: 20.x LTS
+- **Package Manager**: npm (not yarn or pnpm)
+- **Cloud Provider**: AWS (primary), Vercel (hosting)
+- **Region**: eu-west-1
+- **Container Registry**: Docker Hub
+
+### Communication Standards
+- **Support Response Time**: 24-48 hours
+- **Documentation Language**: US English
+- **Tone**: Professional but friendly
+- **Technical Level**: Intermediate developers
+
+### Branding Guidelines
+- **Company Tagline**: &quot;Beautiful documentation with the least effort possible&quot;
+- **Primary Color**: #0070f3 (Vercel blue)
+- **Logo**: <i class="ph ph-sparkle" aria-label="special"></i> (sparkle emoji)
+- **Font Family**: Inter, system-ui
+</code></pre>
+<p>When these facts are included in your CLAUDE.md, Claude will:</p>
+<ul>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Use correct contact information in examples</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Reference the right URLs in documentation</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Apply consistent author attribution</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Generate accurate meta tags for SEO</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Use proper organizational context</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Follow established technical standards</li>
+</ul>
+<h3>1.3 Global CLAUDE.md Best Practices</h3>
+<p>Your global <code>~/.claude/CLAUDE.md</code> should include universal standards that apply to all projects. Here&#39;s an expanded example:</p>
+<pre><code class="language-markdown"># Global CLAUDE.md Instructions
 
 ## Universal Documentation Standards
 
@@ -548,6 +617,49 @@ Your global `~/.claude/CLAUDE.md` should include universal standards that apply
     F --> F2[Build Optimization]
     F --> F3[Caching Strategies]</div>
     </div>
+<h3>1.4 Benefits of Environment Facts in Documentation</h3>
+<p>Including these environmental facts in your CLAUDE.md provides several key benefits:</p>
+<div class="mermaid-wrapper">
+      <div class="mermaid">graph TD
+    A[Environment Facts in CLAUDE.md] --> B[Accurate Content]
+    A --> C[Consistent Branding]
+    A --> D[Proper Attribution]
+    A --> E[SEO Optimization]
+    
+    B --> B1[Correct URLs in examples]
+    B --> B2[Valid email addresses]
+    B --> B3[Accurate version numbers]
+    
+    C --> C1[Company name consistency]
+    C --> C2[Tagline usage]
+    C --> C3[Brand colors]
+    
+    D --> D1[Author metadata]
+    D --> D2[Copyright notices]
+    D --> D3[License references]
+    
+    E --> E1[Meta tag generation]
+    E --> E2[Social media tags]
+    E --> E3[Structured data]
+    
+    style A fill:#e3f2fd
+    style B fill:#c8e6c9
+    style C fill:#fff9c4
+    style D fill:#ffccbc
+    style E fill:#d1c4e9</div>
+    </div>
+<h4>Example: Without Environment Facts</h4>
+<pre><code class="language-javascript">// Claude might generate:
+const API_URL = &#39;https://api.example.com&#39;;  // <i class="ph ph-question" aria-label="question"></i> Generic placeholder
+const author = &#39;Your Name&#39;;                 // <i class="ph ph-question" aria-label="question"></i> Placeholder
+const email = &#39;email@example.com&#39;;          // <i class="ph ph-question" aria-label="question"></i> Generic example
+</code></pre>
+<h4>Example: With Environment Facts</h4>
+<pre><code class="language-javascript">// Claude will generate:
+const API_URL = &#39;https://api.knowcode.tech&#39;;      // <i class="ph ph-check-circle" aria-label="checked"></i> Actual API URL
+const author = &#39;Lindsay Smith&#39;;                    // <i class="ph ph-check-circle" aria-label="checked"></i> Correct author
+const email = &#39;support@knowcode.tech&#39;;             // <i class="ph ph-check-circle" aria-label="checked"></i> Real contact email
+</code></pre>
 <h2>Step 2: Initialize doc-builder</h2>
 <pre><code class="language-bash"># Install doc-builder
 npm install -D @knowcode/doc-builder
@@ -861,6 +973,7 @@ The key to success is iterative refinement of your CLAUDE.md file to capture you
 | Date | Author | Changes |
 |------|--------|---------|
 | 2025-07-21 | Claude | Initial creation |
+| 2025-07-23 | Lindsay Smith | Added section on environment facts for accurate content generation |
 </code></pre>
 
             </div>

package/html/guides/documentation-standards.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.440Z",
-  "dateModified": "2025-07-23T06:51:04.440Z",
+  "datePublished": "2025-07-23T09:24:11.394Z",
+  "dateModified": "2025-07-23T09:24:11.394Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/guides/phosphor-icons-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.446Z",
-  "dateModified": "2025-07-23T06:51:04.446Z",
+  "datePublished": "2025-07-23T09:24:11.397Z",
+  "dateModified": "2025-07-23T09:24:11.397Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/guides/search-engine-verification-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.457Z",
-  "dateModified": "2025-07-23T06:51:04.457Z",
+  "datePublished": "2025-07-23T09:24:11.403Z",
+  "dateModified": "2025-07-23T09:24:11.403Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/search-engine-verification-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/guides/seo-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.462Z",
-  "dateModified": "2025-07-23T06:51:04.462Z",
+  "datePublished": "2025-07-23T09:24:11.407Z",
+  "dateModified": "2025-07-23T09:24:11.407Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

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

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.471Z",
-  "dateModified": "2025-07-23T06:51:04.471Z",
+  "datePublished": "2025-07-23T09:24:11.413Z",
+  "dateModified": "2025-07-23T09:24:11.413Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/guides/troubleshooting-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.475Z",
-  "dateModified": "2025-07-23T06:51:04.475Z",
+  "datePublished": "2025-07-23T09:24:11.416Z",
+  "dateModified": "2025-07-23T09:24:11.416Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/guides/windows-setup-guide.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel. Based on real...">
-    <title>Windows Setup Guide for Claude Code &amp; @knowcode/do...</title>
+    <title>Windows Setup Guide for Claude Code &amp; @knowcode...</title>
     
     <meta name="author" content="Lindsay Smith">
     <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, claude, code">
@@ -14,7 +14,7 @@
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html">
-    <meta property="og:title" content="Windows Setup Guide for Claude Code &amp; @knowcode/do...">
+    <meta property="og:title" content="Windows Setup Guide for Claude Code &amp; @knowcode...">
     <meta property="og:description" content="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel. Based on real...">
     <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     <meta property="og:site_name" content="@knowcode/doc-builder">
@@ -24,7 +24,7 @@
     <meta name="twitter:card" content="summary_large_image">
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
-    <meta name="twitter:title" content="Windows Setup Guide for Claude Code &amp; @knowcode/do...">
+    <meta name="twitter:title" content="Windows Setup Guide for Claude Code &amp; @knowcode...">
     <meta name="twitter:description" content="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel. Based on real...">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.491Z",
-  "dateModified": "2025-07-23T06:51:04.491Z",
+  "datePublished": "2025-07-23T09:24:11.421Z",
+  "dateModified": "2025-07-23T09:24:11.421Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/index.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.406Z",
-  "dateModified": "2025-07-23T06:51:04.406Z",
+  "datePublished": "2025-07-23T09:24:11.374Z",
+  "dateModified": "2025-07-23T09:24:11.374Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 
@@ -401,7 +401,7 @@ docBuilder.build({
 <p><strong>Connect with us:</strong></p>
 <ul>
 <li><i class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
-<li>🐙 <a href="https://github.com/wapdat/doc-builder">GitHub Repo</a></li>
+<li><i class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/wapdat/doc-builder">GitHub Repo</a></li>
 <li><i class="ph ph-globe" aria-label="global"></i> <a href="https://knowcode.com">Website</a></li>
 <li><i class="ph ph-chat-circle" aria-label="chat"></i> <a href="https://github.com/wapdat/doc-builder/discussions">Discussions</a></li>
 </ul>

package/html/launch/README.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.498Z",
-  "dateModified": "2025-07-23T06:51:04.498Z",
+  "datePublished": "2025-07-23T09:24:11.423Z",
+  "dateModified": "2025-07-23T09:24:11.423Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/launch/README.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/launch/bubble-plugin-specification.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.507Z",
-  "dateModified": "2025-07-23T06:51:04.507Z",
+  "datePublished": "2025-07-23T09:24:11.427Z",
+  "dateModified": "2025-07-23T09:24:11.427Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/launch/go-to-market-strategy.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.515Z",
-  "dateModified": "2025-07-23T06:51:04.515Z",
+  "datePublished": "2025-07-23T09:24:11.431Z",
+  "dateModified": "2025-07-23T09:24:11.431Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/launch/go-to-market-strategy.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/launch/launch-announcements.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.528Z",
-  "dateModified": "2025-07-23T06:51:04.528Z",
+  "datePublished": "2025-07-23T09:24:11.435Z",
+  "dateModified": "2025-07-23T09:24:11.435Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/launch/launch-announcements.html"
@@ -103,7 +103,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 
@@ -416,7 +416,7 @@ npx @knowcode/doc-builder@latest deploy
 <ul>
 <li><i class="ph ph-rocket-launch" aria-label="launch"></i> <a href="https://doc-builder-delta.vercel.app">Live Demo</a></li>
 <li><i class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
-<li>🐙 <a href="https://github.com/knowcode/doc-builder">GitHub Repo</a> (coming soon)</li>
+<li><i class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/knowcode/doc-builder">GitHub Repo</a> (coming soon)</li>
 </ul>
 <p>What&#39;s your biggest documentation pain point? Let me know in the comments!</p>
 <h2>Reddit Posts</h2>

package/html/sitemap.xml

@@ -2,127 +2,127 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://doc-builder-delta.vercel.app/404.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/search-engine-verification-guide.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/README.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/go-to-market-strategy.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/launch-announcements.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
-    <lastmod>2025-07-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</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-23T06:51:04.575Z</lastmod>
+    <lastmod>2025-07-23T09:24:11.449Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

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

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.532Z",
-  "dateModified": "2025-07-23T06:51:04.532Z",
+  "datePublished": "2025-07-23T09:24:11.437Z",
+  "dateModified": "2025-07-23T09:24:11.437Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/html/vercel-first-time-setup-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T06:51:04.537Z",
-  "dateModified": "2025-07-23T06:51:04.537Z",
+  "datePublished": "2025-07-23T09:24:11.440Z",
+  "dateModified": "2025-07-23T09:24:11.440Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.0">Last updated: Jul 23, 2025, 06:51 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.2">Last updated: Jul 23, 2025, 09:24 AM UTC</span>
                 </div>
                 
                 

package/lib/config.js

@@ -27,7 +27,8 @@ const defaultConfig = {
     darkMode: true,
     phosphorIcons: true,
     phosphorWeight: 'regular', // Options: thin, light, regular, bold, fill, duotone
-    phosphorSize: '1.2em'      // Relative to text size
+    phosphorSize: '1.2em',     // Relative to text size
+    normalizeTitle: true       // Auto-normalize all-caps titles to title case
   },
   
   // Authentication (if enabled)

package/lib/core-builder.js

@@ -23,6 +23,34 @@ marked.setOptions({
   gfm: true
 });
 
+// Helper function to normalize titles
+function normalizeTitle(title) {
+  if (!title) return title;
+  
+  // Check if title is all caps (more than 50% uppercase letters)
+  const upperCount = (title.match(/[A-Z]/g) || []).length;
+  const letterCount = (title.match(/[a-zA-Z]/g) || []).length;
+  const isAllCaps = letterCount > 0 && (upperCount / letterCount) > 0.5;
+  
+  if (isAllCaps) {
+    // Convert to title case
+    return title.toLowerCase()
+      .split(' ')
+      .map(word => {
+        // Keep small words lowercase unless they're first
+        const smallWords = ['a', 'an', 'and', 'as', 'at', 'but', 'by', 'for', 'from', 
+                          'in', 'into', 'of', 'on', 'or', 'the', 'to', 'with'];
+        if (smallWords.includes(word.toLowerCase()) && word !== title.split(' ')[0]) {
+          return word.toLowerCase();
+        }
+        return word.charAt(0).toUpperCase() + word.slice(1);
+      })
+      .join(' ');
+  }
+  
+  return title;
+}
+
 // Helper function to escape HTML
 function escapeHtml(text) {
   const map = {
@@ -245,10 +273,22 @@ function generateHTML(title, content, navigation, currentPath = '', config = {},
       .replace('{pageTitle}', title)
       .replace('{siteName}', siteName);
     
-    // Ensure title is within 50-60 characters
-    finalSeoTitle = seoTitle.length > 60 ? 
-      title.length > 50 ? title.substring(0, 50) + '...' : title 
-      : seoTitle;
+    // Ensure title is within optimal SEO length (50-60 characters)
+    if (seoTitle.length > 60) {
+      // Try different approaches to fit within limits
+      if (title.length <= 50) {
+        // If page title fits, just use that
+        finalSeoTitle = title;
+      } else if (title.length > 50) {
+        // Truncate page title but keep meaningful part
+        const truncatedTitle = title.substring(0, 47) + '...';
+        finalSeoTitle = truncatedTitle;
+      } else {
+        finalSeoTitle = seoTitle.substring(0, 57) + '...';
+      }
+    } else {
+      finalSeoTitle = seoTitle;
+    }
     
     // Generate meta tags
     seoTags = generateMetaTags({
@@ -622,7 +662,10 @@ async function processMarkdownFile(filePath, outputPath, allFiles, config) {
   // Extract title - priority: front matter > H1 > filename
   const h1Match = content.match(/^#\s+(.+)$/m);
   const h1Title = h1Match ? h1Match[1] : null;
-  const title = frontMatter.title || h1Title || fileName;
+  
+  // Normalize title if needed (e.g., convert all-caps to title case)
+  const rawTitle = frontMatter.title || h1Title || fileName;
+  const title = config.features?.normalizeTitle !== false ? normalizeTitle(rawTitle) : rawTitle;
   
   // Extract summary for tooltip - priority: front matter > auto-extract
   const summary = frontMatter.description || extractSummary(content);

package/lib/emoji-mapper.js

@@ -34,6 +34,7 @@ const emojiToPhosphor = {
   '🐛': '<i class="ph ph-bug" aria-label="bug"></i>',
   '🐞': '<i class="ph ph-bug-beetle" aria-label="bug"></i>',
   '🤖': '<i class="ph ph-robot" aria-label="automation"></i>',
+  '🐙': '<i class="ph ph-github-logo" aria-label="github"></i>',
   
   // Documents & Files
   '📝': '<i class="ph ph-note-pencil" aria-label="edit"></i>',

package/package.json

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