@knowcode/doc-builder 1.9.10 → 1.9.12

package/html/guides/authentication-guide.html

@@ -6,6 +6,7 @@
     <meta name="description" content="&gt; 🎉 Update v1.8.2: Supabase credentials are now automatically configured! No manual setup needed - just enable authentication and add users to the database.">
     <title>Authentication Guide for @knowcode/doc-builder</title>
     
+    <meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
     <meta name="author" content="Lindsay Smith">
     <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, supabase, authentication">
     <meta name="robots" content="index, follow">
@@ -98,8 +99,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-29T09:30:31.317Z",
-  "dateModified": "2025-07-29T09:30:31.317Z",
+  "datePublished": "2025-07-31T07:08:27.344Z",
+  "dateModified": "2025-07-31T07:08:27.344Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -138,7 +139,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.5">Last updated: Jul 29, 2025, 09:30 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
                 </div>
                 
                 
@@ -204,6 +205,7 @@
         <a href="/guides/authentication-default-change.html" class="nav-item" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="ph ph-file-text"></i> Authentication Default Change</a>
         <a href="/guides/authentication-guide.html" class="nav-item active" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform."><i class="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
         <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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
+        <a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration 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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
         <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
         <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
@@ -214,6 +216,7 @@
         <a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
         <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
+        <a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete 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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
         <a href="/guides/windows-setup-guide.html" class="nav-item" data-tooltip="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel."><i class="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
       <div class="nav-section private-nav" data-level="1">
@@ -245,6 +248,7 @@
           <i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
         </a>
         <div class="nav-content collapsed" id="nav-prompts-1">
+        <a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
         <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
             </nav>
             <div class="resize-handle"></div>
@@ -255,17 +259,20 @@
             <div class="content-inner">
                 <h1>Authentication Guide for @knowcode/doc-builder</h1>
 <blockquote>
-<p><strong><i class="ph ph-confetti" aria-label="party"></i> Update v1.8.2</strong>: Supabase credentials are now automatically configured! No manual setup needed - just enable authentication and add users to the database.</p>
+<p><strong><i style="font-size: 1.2em" class="ph ph-confetti" aria-label="party"></i> Update v1.8.2</strong>: Supabase credentials are now automatically configured! No manual setup needed - just enable authentication and add users to the database.</p>
+</blockquote>
+<blockquote>
+<p><strong><i style="font-size: 1.2em" class="ph ph-books" aria-label="documentation"></i> Looking for complete documentation?</strong> See the <a href="supabase-authentication-complete-guide.md">Complete Supabase Authentication Guide</a> for detailed setup, troubleshooting, and advanced features.</p>
 </blockquote>
 <h2>Overview</h2>
 <p>@knowcode/doc-builder supports enterprise-grade authentication through <strong>Supabase</strong> - a secure, scalable authentication platform. This guide explains how to protect your documentation with proper user authentication and access control.</p>
 <h2>Why Supabase?</h2>
 <ul>
-<li><i class="ph ph-lock-key" aria-label="secure"></i> <strong>Enterprise Security</strong>: JWT tokens, bcrypt password hashing, Row Level Security</li>
-<li><i class="ph ph-users" aria-label="team"></i> <strong>Multi-User Support</strong>: Unlimited users with fine-grained access control</li>
-<li>🌍 <strong>Scalable</strong>: Built on PostgreSQL, handles millions of users</li>
-<li><i class="ph ph-arrows-clockwise" aria-label="refresh"></i> <strong>Real-time</strong>: Live updates when permissions change</li>
-<li><i class="ph ph-money" aria-label="money"></i> <strong>Generous Free Tier</strong>: 50,000 monthly active users free</li>
+<li><i style="font-size: 1.2em" class="ph ph-lock-key" aria-label="secure"></i> <strong>Enterprise Security</strong>: JWT tokens, bcrypt password hashing, Row Level Security</li>
+<li><i style="font-size: 1.2em" class="ph ph-users" aria-label="team"></i> <strong>Multi-User Support</strong>: Unlimited users with fine-grained access control</li>
+<li><i style="font-size: 1.2em" class="ph ph-globe-hemisphere-west" aria-label="world"></i> <strong>Scalable</strong>: Built on PostgreSQL, handles millions of users</li>
+<li><i style="font-size: 1.2em" class="ph ph-arrows-clockwise" aria-label="refresh"></i> <strong>Real-time</strong>: Live updates when permissions change</li>
+<li><i style="font-size: 1.2em" class="ph ph-money" aria-label="money"></i> <strong>Generous Free Tier</strong>: 50,000 monthly active users free</li>
 </ul>
 <h2>How It Works</h2>
 <div class="mermaid-wrapper">
@@ -385,12 +392,12 @@ npx @knowcode/doc-builder auth:list-users --site-id xxx
 <h2>Security Features</h2>
 <h3>What Supabase Provides</h3>
 <ul>
-<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>JWT Authentication</strong>: Industry-standard secure tokens</li>
-<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Password Hashing</strong>: bcrypt with salt</li>
-<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Row Level Security</strong>: Database-level access control</li>
-<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Session Management</strong>: Automatic token refresh</li>
-<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Multi-Factor Auth</strong>: Optional 2FA support</li>
-<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>OAuth Providers</strong>: Google, GitHub, etc. (optional)</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> <strong>JWT Authentication</strong>: Industry-standard secure tokens</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> <strong>Password Hashing</strong>: bcrypt with salt</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> <strong>Row Level Security</strong>: Database-level access control</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> <strong>Session Management</strong>: Automatic token refresh</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> <strong>Multi-Factor Auth</strong>: Optional 2FA support</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> <strong>OAuth Providers</strong>: Google, GitHub, etc. (optional)</li>
 </ul>
 <h3>Security Best Practices</h3>
 <ol>
@@ -461,6 +468,19 @@ auth: {
 <h2>Conclusion</h2>
 <p>Supabase authentication provides enterprise-grade security for your documentation while maintaining ease of use. With proper setup, you get secure, scalable authentication that grows with your needs.</p>
 <p>For public documentation that doesn&#39;t need authentication, simply set <code>authentication: false</code> or use the <code>--no-auth</code> flag during build/deploy.</p>
+<h2><i style="font-size: 1.2em" class="ph ph-books" aria-label="documentation"></i> Next Steps</h2>
+<p>For comprehensive documentation including advanced features, troubleshooting, and detailed setup instructions, see:</p>
+<p><strong><a href="supabase-authentication-complete-guide.md">Complete Supabase Authentication Guide</a></strong></p>
+<p>This detailed guide covers:</p>
+<ul>
+<li><i style="font-size: 1.2em" class="ph ph-crane" aria-label="construction"></i> All authentication modes (Global, Private Directory, Hybrid)</li>
+<li><i style="font-size: 1.2em" class="ph ph-wrench" aria-label="settings"></i> Advanced configuration options</li>
+<li><i style="font-size: 1.2em" class="ph ph-users" aria-label="team"></i> Bulk user management workflows</li>
+<li><i style="font-size: 1.2em" class="ph ph-shield" aria-label="security"></i> Security best practices and hardening</li>
+<li><i style="font-size: 1.2em" class="ph ph-bug" aria-label="bug"></i> Comprehensive troubleshooting guide</li>
+<li><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> Performance optimization and monitoring</li>
+<li><i style="font-size: 1.2em" class="ph ph-link" aria-label="link"></i> Multi-domain and role-based access control</li>
+</ul>
 
             </div>
         </main>

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

@@ -6,6 +6,7 @@
     <meta name="description" content="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it to...">
     <title>Claude + CLAUDE.md Documentation Workflow Guide</title>
     
+    <meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
     <meta name="author" content="Lindsay Smith">
     <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, claude, error">
     <meta name="robots" content="index, follow">
@@ -98,8 +99,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-29T09:30:31.321Z",
-  "dateModified": "2025-07-29T09:30:31.321Z",
+  "datePublished": "2025-07-31T07:08:27.348Z",
+  "dateModified": "2025-07-31T07:08:27.348Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -138,7 +139,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.5">Last updated: Jul 29, 2025, 09:30 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
                 </div>
                 
                 
@@ -204,6 +205,7 @@
         <a href="/guides/authentication-default-change.html" class="nav-item" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="ph ph-file-text"></i> Authentication Default Change</a>
         <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform."><i class="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
         <a href="/guides/claude-workflow-guide.html" class="nav-item active" 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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
+        <a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration 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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
         <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
         <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
@@ -214,6 +216,7 @@
         <a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
         <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
+        <a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete 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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
         <a href="/guides/windows-setup-guide.html" class="nav-item" data-tooltip="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel."><i class="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
       <div class="nav-section private-nav" data-level="1">
@@ -245,6 +248,7 @@
           <i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
         </a>
         <div class="nav-content collapsed" id="nav-prompts-1">
+        <a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
         <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
             </nav>
             <div class="resize-handle"></div>
@@ -495,7 +499,7 @@ const response = await api.getData({ userId: 123 });
 <li><strong>Create working examples</strong> that can be copy-pasted</li>
 <li><strong>Add troubleshooting sections</strong> for common problems</li>
 <li><strong>Include mermaid diagrams</strong> for workflows and architectures</li>
-<li><strong>Mark speculated information</strong> clearly with <i class="ph ph-question" aria-label="question"></i></li>
+<li><strong>Mark speculated information</strong> clearly with <i style="font-size: 1.2em" class="ph ph-question" aria-label="question"></i></li>
 <li><strong>Follow the naming conventions</strong> exactly</li>
 <li><strong>Create comprehensive content</strong> - aim for completeness over brevity</li>
 <li><strong>Add cross-references</strong> to related documentation</li>
@@ -594,12 +598,12 @@ For Claude to generate accurate and consistent content, include key organization
 </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>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Use correct contact information in examples</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Reference the right URLs in documentation</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Apply consistent author attribution</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Generate accurate meta tags for SEO</li>
+<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Use proper organizational context</li>
+<li><i style="font-size: 1.2em" 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>