@knowcode/doc-builder 1.8.2 → 1.8.4

package/html/guides/authentication-guide.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.969Z",
-  "dateModified": "2025-07-26T10:38:41.969Z",
+  "datePublished": "2025-07-26T11:44:31.480Z",
+  "dateModified": "2025-07-26T11:44:31.480Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.3">Last updated: Jul 26, 2025, 11:44 AM UTC</span>
                 </div>
                 
                 
@@ -212,6 +212,30 @@
         <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>
         <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="fas fa-file-alt"></i> Windows Setup Guide</a></div></div>
+      <div class="nav-section private-nav" data-level="1">
+        <a class="nav-title collapsible" href="#" data-target="nav-private-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
+        </a>
+        <div class="nav-content collapsed" id="nav-private-1">
+        <a href="/private/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
+        <a href="/private/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
+        <a href="/private/supabase-auth-implementation-completed.html" class="nav-item" data-tooltip="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Completed</a>
+        <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
+        <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
+        <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
+      <div class="nav-section private-nav" data-level="2">
+        <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
+        </a>
+        <div class="nav-content collapsed" id="nav-private-launch-2">
+        <a href="/private/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
+        <a href="/private/launch/auth-cleanup-summary.html" class="nav-item" data-tooltip="All references to the old client-side authentication system have been removed from @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Auth Cleanup Summary</a>
+        <a href="/private/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
+        <a href="/private/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
+        <a href="/private/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a>
+        <a href="/private/launch/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>
@@ -261,8 +285,10 @@
 <li>Create a new project</li>
 <li>Note your project URL and anon key</li>
 </ol>
-<h3>Step 2: Configure doc-builder</h3>
-<p>Create or update <code>doc-builder.config.js</code>:</p>
+<h3>Step 2: Configure doc-builder (Mostly Automatic!)</h3>
+<p>As of v1.8.2, Supabase credentials are automatically configured. You have two options:</p>
+<p><strong>Option 1: Automatic (Recommended)</strong><br>Just create a <code>docs/private/</code> directory and authentication is automatically enabled with built-in credentials.</p>
+<p><strong>Option 2: Custom Configuration</strong><br>Create or update <code>doc-builder.config.js</code> (only if using your own Supabase project):</p>
 <pre><code class="language-javascript">module.exports = {
   siteName: &#39;My Documentation&#39;,
   
@@ -271,64 +297,52 @@
   },
   
   auth: {
-    supabaseUrl: &#39;https://your-project.supabase.co&#39;,
-    supabaseAnonKey: &#39;your-anon-key&#39;,
-    siteId: &#39;your-site-id&#39;  // From database after setup
+    supabaseUrl: &#39;https://your-project.supabase.co&#39;,  // Optional - has defaults
+    supabaseAnonKey: &#39;your-anon-key&#39;                  // Optional - has defaults
   }
 };
 </code></pre>
+<p>Note: No more <code>siteId</code> needed! The system uses domains automatically.</p>
 <h3>Step 3: Set Up Database</h3>
-<p>Run these SQL commands in your Supabase SQL editor:</p>
-<pre><code class="language-sql">-- Create sites table
-CREATE TABLE docbuilder_sites (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    domain TEXT UNIQUE NOT NULL,
-    name TEXT NOT NULL,
-    created_at TIMESTAMPTZ DEFAULT NOW()
-);
-
--- Create access table
+<p>Run this SQL command in your Supabase SQL editor (or use setup-database-v2.sql):</p>
+<pre><code class="language-sql">-- Single table for user access control
 CREATE TABLE docbuilder_access (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    user_id UUID NOT NULL REFERENCES auth.users(id),
-    site_id UUID NOT NULL REFERENCES docbuilder_sites(id),
+    user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
+    domain TEXT NOT NULL,
     created_at TIMESTAMPTZ DEFAULT NOW(),
-    UNIQUE(user_id, site_id)
+    PRIMARY KEY (user_id, domain)
 );
 
+-- Create index for faster lookups
+CREATE INDEX idx_docbuilder_access_domain ON docbuilder_access(domain);
+
 -- Enable Row Level Security
-ALTER TABLE docbuilder_sites ENABLE ROW LEVEL SECURITY;
 ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
 
--- Create policies
-CREATE POLICY &quot;Sites visible to users with access&quot; ON docbuilder_sites
-    FOR SELECT USING (
-        id IN (
-            SELECT site_id FROM docbuilder_access 
-            WHERE user_id = auth.uid()
-        )
-    );
-
-CREATE POLICY &quot;Access visible to own user&quot; ON docbuilder_access
+-- RLS Policy: Users can only see their own access
+CREATE POLICY &quot;Users see own access&quot; ON docbuilder_access
     FOR SELECT USING (user_id = auth.uid());
 </code></pre>
-<h3>Step 4: Add Your Site</h3>
-<pre><code class="language-sql">INSERT INTO docbuilder_sites (domain, name)
-VALUES (&#39;your-domain.com&#39;, &#39;Your Documentation Name&#39;);
-</code></pre>
-<p>Note the returned ID - this is your <code>siteId</code> for the config.</p>
+<h3>Step 4: No Site Registration Needed!</h3>
+<p>With the new domain-based system, you don&#39;t need to register sites. The system automatically uses the current domain (e.g., docs.example.com) as the access key.</p>
 <h3>Step 5: Create Users</h3>
 <p>Users can sign up through Supabase Auth, or you can create them:</p>
 <pre><code class="language-sql">-- In Supabase dashboard, go to Authentication &gt; Users
 -- Click &quot;Invite user&quot; and enter their email
 </code></pre>
 <h3>Step 6: Grant Access</h3>
-<pre><code class="language-sql">-- Grant user access to your site
-INSERT INTO docbuilder_access (user_id, site_id)
+<pre><code class="language-sql">-- Grant user access to your documentation domain
+INSERT INTO docbuilder_access (user_id, domain)
 VALUES (
     (SELECT id FROM auth.users WHERE email = &#39;user@example.com&#39;),
-    &#39;your-site-id&#39;
+    &#39;docs.example.com&#39;
 );
+
+-- Grant multiple users access
+INSERT INTO docbuilder_access (user_id, domain)
+SELECT id, &#39;docs.example.com&#39; 
+FROM auth.users 
+WHERE email IN (&#39;user1@example.com&#39;, &#39;user2@example.com&#39;, &#39;user3@example.com&#39;);
 </code></pre>
 <h2>Deployment</h2>
 <h3>Build with Authentication</h3>
@@ -370,11 +384,10 @@ npx @knowcode/doc-builder auth:list-users --site-id xxx
 </ul>
 <h3>Security Best Practices</h3>
 <ol>
-<li><p><strong>Use environment variables</strong> for sensitive config:</p>
+<li><p><strong>Use environment variables</strong> for custom config (optional):</p>
 <pre><code class="language-javascript">auth: {
-  supabaseUrl: process.env.SUPABASE_URL,
-  supabaseAnonKey: process.env.SUPABASE_ANON_KEY,
-  siteId: process.env.DOC_SITE_ID
+  supabaseUrl: process.env.SUPABASE_URL || defaultUrl,
+  supabaseAnonKey: process.env.SUPABASE_ANON_KEY || defaultKey
 }
 </code></pre>
 </li>

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

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.973Z",
-  "dateModified": "2025-07-26T10:38:41.973Z",
+  "datePublished": "2025-07-26T11:44:31.484Z",
+  "dateModified": "2025-07-26T11:44:31.484Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.3">Last updated: Jul 26, 2025, 11:44 AM UTC</span>
                 </div>
                 
                 
@@ -212,6 +212,30 @@
         <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>
         <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="fas fa-file-alt"></i> Windows Setup Guide</a></div></div>
+      <div class="nav-section private-nav" data-level="1">
+        <a class="nav-title collapsible" href="#" data-target="nav-private-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
+        </a>
+        <div class="nav-content collapsed" id="nav-private-1">
+        <a href="/private/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
+        <a href="/private/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
+        <a href="/private/supabase-auth-implementation-completed.html" class="nav-item" data-tooltip="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Completed</a>
+        <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
+        <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
+        <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
+      <div class="nav-section private-nav" data-level="2">
+        <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
+        </a>
+        <div class="nav-content collapsed" id="nav-private-launch-2">
+        <a href="/private/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
+        <a href="/private/launch/auth-cleanup-summary.html" class="nav-item" data-tooltip="All references to the old client-side authentication system have been removed from @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Auth Cleanup Summary</a>
+        <a href="/private/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
+        <a href="/private/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
+        <a href="/private/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a>
+        <a href="/private/launch/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>

package/html/guides/documentation-standards.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.977Z",
-  "dateModified": "2025-07-26T10:38:41.977Z",
+  "datePublished": "2025-07-26T11:44:31.488Z",
+  "dateModified": "2025-07-26T11:44:31.488Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.3">Last updated: Jul 26, 2025, 11:44 AM UTC</span>
                 </div>
                 
                 
@@ -212,6 +212,30 @@
         <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>
         <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="fas fa-file-alt"></i> Windows Setup Guide</a></div></div>
+      <div class="nav-section private-nav" data-level="1">
+        <a class="nav-title collapsible" href="#" data-target="nav-private-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
+        </a>
+        <div class="nav-content collapsed" id="nav-private-1">
+        <a href="/private/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
+        <a href="/private/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
+        <a href="/private/supabase-auth-implementation-completed.html" class="nav-item" data-tooltip="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Completed</a>
+        <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
+        <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
+        <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
+      <div class="nav-section private-nav" data-level="2">
+        <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
+        </a>
+        <div class="nav-content collapsed" id="nav-private-launch-2">
+        <a href="/private/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
+        <a href="/private/launch/auth-cleanup-summary.html" class="nav-item" data-tooltip="All references to the old client-side authentication system have been removed from @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Auth Cleanup Summary</a>
+        <a href="/private/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
+        <a href="/private/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
+        <a href="/private/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a>
+        <a href="/private/launch/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>

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

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.979Z",
-  "dateModified": "2025-07-26T10:38:41.979Z",
+  "datePublished": "2025-07-26T11:44:31.490Z",
+  "dateModified": "2025-07-26T11:44:31.490Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.3">Last updated: Jul 26, 2025, 11:44 AM UTC</span>
                 </div>
                 
                 
@@ -212,6 +212,30 @@
         <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>
         <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="fas fa-file-alt"></i> Windows Setup Guide</a></div></div>
+      <div class="nav-section private-nav" data-level="1">
+        <a class="nav-title collapsible" href="#" data-target="nav-private-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
+        </a>
+        <div class="nav-content collapsed" id="nav-private-1">
+        <a href="/private/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
+        <a href="/private/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
+        <a href="/private/supabase-auth-implementation-completed.html" class="nav-item" data-tooltip="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Completed</a>
+        <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
+        <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
+        <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
+      <div class="nav-section private-nav" data-level="2">
+        <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
+        </a>
+        <div class="nav-content collapsed" id="nav-private-launch-2">
+        <a href="/private/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
+        <a href="/private/launch/auth-cleanup-summary.html" class="nav-item" data-tooltip="All references to the old client-side authentication system have been removed from @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Auth Cleanup Summary</a>
+        <a href="/private/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
+        <a href="/private/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
+        <a href="/private/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a>
+        <a href="/private/launch/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>

package/html/guides/private-directory-authentication.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.982Z",
-  "dateModified": "2025-07-26T10:38:41.982Z",
+  "datePublished": "2025-07-26T11:44:31.493Z",
+  "dateModified": "2025-07-26T11:44:31.493Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/private-directory-authentication.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.3">Last updated: Jul 26, 2025, 11:44 AM UTC</span>
                 </div>
                 
                 
@@ -212,6 +212,30 @@
         <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>
         <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="fas fa-file-alt"></i> Windows Setup Guide</a></div></div>
+      <div class="nav-section private-nav" data-level="1">
+        <a class="nav-title collapsible" href="#" data-target="nav-private-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
+        </a>
+        <div class="nav-content collapsed" id="nav-private-1">
+        <a href="/private/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
+        <a href="/private/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
+        <a href="/private/supabase-auth-implementation-completed.html" class="nav-item" data-tooltip="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Completed</a>
+        <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
+        <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
+        <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
+      <div class="nav-section private-nav" data-level="2">
+        <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
+        </a>
+        <div class="nav-content collapsed" id="nav-private-launch-2">
+        <a href="/private/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
+        <a href="/private/launch/auth-cleanup-summary.html" class="nav-item" data-tooltip="All references to the old client-side authentication system have been removed from @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Auth Cleanup Summary</a>
+        <a href="/private/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
+        <a href="/private/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
+        <a href="/private/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a>
+        <a href="/private/launch/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>
@@ -308,34 +332,52 @@ module.exports = {
 };
 </code></pre>
 <h3>2. Create Access Control Table</h3>
-<p>In your Supabase dashboard, run this SQL to create the access control table:</p>
+<p>In your Supabase dashboard, run this SQL (or use setup-database-v2.sql):</p>
 <pre><code class="language-sql">CREATE TABLE docbuilder_access (
-  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
   user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
-  site_id TEXT NOT NULL,
+  domain TEXT NOT NULL,
   created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
-  UNIQUE(user_id, site_id)
+  PRIMARY KEY (user_id, domain)
 );
+
+-- Create index for performance
+CREATE INDEX idx_docbuilder_access_domain ON docbuilder_access(domain);
+
+-- Enable Row Level Security
+ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
+
+-- RLS Policy
+CREATE POLICY &quot;Users see own access&quot; ON docbuilder_access
+    FOR SELECT USING (user_id = auth.uid());
 </code></pre>
 <h3>3. Grant User Access</h3>
-<p>Add authorized users by inserting records:</p>
+<p>Add authorized users by domain:</p>
 <pre><code class="language-sql">-- First, create a user in Supabase Auth
--- Then grant them access to your documentation
-INSERT INTO docbuilder_access (user_id, site_id)
-VALUES (&#39;user-uuid-from-auth-users&#39;, &#39;your-site-id&#39;);
+-- Then grant them access to your documentation domain
+INSERT INTO docbuilder_access (user_id, domain)
+VALUES (&#39;user-uuid-from-auth-users&#39;, &#39;docs.example.com&#39;);
+
+-- Or grant access to multiple domains
+INSERT INTO docbuilder_access (user_id, domain) VALUES 
+  (&#39;user-uuid&#39;, &#39;docs.example.com&#39;),
+  (&#39;user-uuid&#39;, &#39;staging-docs.example.com&#39;),
+  (&#39;user-uuid&#39;, &#39;localhost:3000&#39;);
 </code></pre>
 <h3>Automatic Credential Configuration</h3>
-<p>Starting from version 1.8.2, Supabase credentials are automatically configured:</p>
+<p>Starting from version 1.8.2, authentication is truly zero-configuration:</p>
 <ul>
 <li>All doc-builder sites share the same Supabase authentication database</li>
 <li>Credentials are built into the package - no manual configuration needed</li>
-<li>Each site gets a unique auto-generated site ID</li>
-<li>You just need to add the site ID to the database to grant user access</li>
+<li>No site IDs needed - the system uses your domain automatically</li>
+<li>Just grant users access to your domain in the database</li>
 </ul>
-<p><strong>Note</strong>: The auto-generated site ID is displayed during build:</p>
+<p><strong>Note</strong>: When you build with a private directory:</p>
 <pre><code>🔐 Found private directory - automatically enabling Supabase authentication
-📋 Generated site ID: documentation-1753525200000-abc123
-   Note: Add this site ID to your Supabase database to enable user access
+   Note: Grant users access by adding domain to the docbuilder_access table
+</code></pre>
+<p><strong>Example</strong>: For a site at <code>docs.example.com</code>, grant access with:</p>
+<pre><code class="language-sql">INSERT INTO docbuilder_access (user_id, domain) 
+VALUES (&#39;user-uuid&#39;, &#39;docs.example.com&#39;);
 </code></pre>
 <h2>Best Practices</h2>
 <h3>Choosing the Right Mode</h3>

package/html/guides/public-site-deployment.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.983Z",
-  "dateModified": "2025-07-26T10:38:41.983Z",
+  "datePublished": "2025-07-26T11:44:31.494Z",
+  "dateModified": "2025-07-26T11:44:31.494Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/public-site-deployment.html"
@@ -138,7 +138,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.3">Last updated: Jul 26, 2025, 11:44 AM UTC</span>
                 </div>
                 
                 
@@ -212,6 +212,30 @@
         <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>
         <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="fas fa-file-alt"></i> Windows Setup Guide</a></div></div>
+      <div class="nav-section private-nav" data-level="1">
+        <a class="nav-title collapsible" href="#" data-target="nav-private-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
+        </a>
+        <div class="nav-content collapsed" id="nav-private-1">
+        <a href="/private/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
+        <a href="/private/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
+        <a href="/private/supabase-auth-implementation-completed.html" class="nav-item" data-tooltip="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Completed</a>
+        <a href="/private/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
+        <a href="/private/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
+        <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
+        <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
+        <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
+      <div class="nav-section private-nav" data-level="2">
+        <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
+        </a>
+        <div class="nav-content collapsed" id="nav-private-launch-2">
+        <a href="/private/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
+        <a href="/private/launch/auth-cleanup-summary.html" class="nav-item" data-tooltip="All references to the old client-side authentication system have been removed from @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Auth Cleanup Summary</a>
+        <a href="/private/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
+        <a href="/private/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
+        <a href="/private/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a>
+        <a href="/private/launch/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>
@@ -270,9 +294,9 @@ npx @knowcode/doc-builder deploy -c public-doc-builder.config.js
   authentication: &#39;supabase&#39;
 },
 auth: {
-  supabaseUrl: &#39;https://xxx.supabase.co&#39;,
-  supabaseAnonKey: &#39;your-anon-key&#39;,
-  siteId: &#39;your-site-id&#39;
+  supabaseUrl: &#39;https://xxx.supabase.co&#39;,  // Optional - has defaults
+  supabaseAnonKey: &#39;your-anon-key&#39;         // Optional - has defaults
+  // Domain-based auth - no siteId needed!
 }
 </code></pre>
 <ul>
@@ -338,11 +362,10 @@ npx @knowcode/doc-builder deploy -c public-config.js
 <p>If you were using Supabase authentication and want to make your site public:</p>
 <ol>
 <li><p><strong>Remove auth config</strong>:</p>
-<pre><code class="language-javascript">// Remove this:
+<pre><code class="language-javascript">// Remove this (or keep for custom Supabase):
 auth: {
   supabaseUrl: &#39;https://xxx.supabase.co&#39;,
-  supabaseAnonKey: &#39;xxx&#39;,
-  siteId: &#39;xxx&#39;
+  supabaseAnonKey: &#39;xxx&#39;
 }
 </code></pre>
 </li>