@knowcode/doc-builder 1.8.2 → 1.8.3

package/CHANGELOG.md

@@ -5,22 +5,42 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.8.3] - 2025-07-26
+
+### Changed
+- Complete overhaul of authentication system to use domain-based access instead of site IDs
+- **BREAKING**: Removed site ID system entirely - authentication now uses `window.location.host`
+- Simplified database schema to single `docbuilder_access` table with (user_id, domain) primary key
+- No more site registration required - just grant users access to domains
+
+### Updated
+- All documentation updated to reflect domain-based authentication
+- CLI commands simplified - no more site ID parameters needed
+- User management tools now work with domains directly
+
+### Developer Experience
+- Much simpler setup - no site registration step
+- Automatic domain detection from browser location
+- Easier multi-site management - just use different domains
+
 ## [1.8.2] - 2025-07-26
 
 ### Added
 - **Automatic Supabase Credentials**: No more placeholder errors! Credentials are now built into the package
-- **Auto-generated Site IDs**: Each site gets a unique ID automatically when authentication is enabled
+- **Domain-based Authentication**: No more site IDs! Authentication now uses the current domain automatically
 - Shared authentication database across all doc-builder sites for easier management
 
 ### Changed
 - Supabase URL and anonymous key are now provided by default via `shared-auth-config.js`
-- Site IDs are auto-generated using site name, timestamp, and random string
+- **BREAKING**: Removed site ID system in favor of domain-based authentication
+- Authentication now uses `window.location.host` for access control
+- Simplified database schema to single `docbuilder_access` table
 - Updated documentation to reflect zero-configuration authentication
 
 ### Developer Experience
 - No need to configure Supabase credentials manually anymore
 - Just create a `private` directory and authentication works immediately
-- Site administrators only need to add the auto-generated site ID to the database
+- Site administrators only need to grant users access to domains, no site registration needed
 
 ## [1.8.1] - 2025-07-26
 

package/README.md

@@ -218,11 +218,11 @@ module.exports = {
     attachments: true           // Copy PDFs, Excel files, etc. (default: true)
   },
   
-  // Supabase Authentication
+  // Supabase Authentication (v1.8.2+ has built-in defaults)
   auth: {
-    supabaseUrl: process.env.SUPABASE_URL,
-    supabaseAnonKey: process.env.SUPABASE_ANON_KEY,
-    siteId: process.env.DOC_SITE_ID
+    supabaseUrl: process.env.SUPABASE_URL,       // Optional
+    supabaseAnonKey: process.env.SUPABASE_ANON_KEY  // Optional
+    // Domain-based auth - no siteId needed!
   }
 };
 ```

package/cli.js

@@ -1506,7 +1506,6 @@ program
         console.log(chalk.yellow('\n🔐 Supabase Authentication:'));
         console.log(`  • Supabase URL: ${config.auth?.supabaseUrl ? chalk.green('Configured') : chalk.red('Missing')}`);
         console.log(`  • Anonymous Key: ${config.auth?.supabaseAnonKey ? chalk.green('Configured') : chalk.red('Missing')}`);
-        console.log(`  • Site ID: ${config.auth?.siteId ? chalk.green('Configured') : chalk.red('Missing')}`);
       }
       
       if (config.seo?.enabled) {
@@ -1568,8 +1567,7 @@ program
   
   auth: {
     supabaseUrl: '${answers.supabaseUrl}',
-    supabaseAnonKey: '${answers.supabaseAnonKey}',
-    siteId: ''  // Will be set after creating site in database
+    supabaseAnonKey: '${answers.supabaseAnonKey}'
   }
 };`;
 
@@ -1577,51 +1575,22 @@ program
       console.log(chalk.green(`✓ Configuration saved to ${configPath}`));
       
       console.log(chalk.yellow('\n📋 Next steps:'));
-      console.log('1. Create the database tables in your Supabase project (see documentation)');
-      console.log('2. Add your site to the database using: doc-builder auth:add-site');
-      console.log('3. Update the siteId in your config file');
+      console.log('1. Create the database tables in your Supabase project (see setup-database-v2.sql)');
+      console.log('2. Grant users access by adding their domain to docbuilder_access table');
       
     } catch (error) {
       console.error(chalk.red('Error initializing auth:'), error.message);
     }
   });
 
-program
-  .command('auth:add-site')
-  .description('Add a documentation site to Supabase database')
-  .requiredOption('--domain <domain>', 'site domain (e.g., docs.example.com)')
-  .requiredOption('--name <name>', 'site display name')
-  .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n🌐 Add Documentation Site\n'));
-    
-    try {
-      const config = await loadConfig(options.config || 'doc-builder.config.js', {});
-      
-      if (config.features?.authentication !== 'supabase') {
-        console.error(chalk.red('Error: Supabase authentication is not configured. Run "doc-builder auth:init" first.'));
-        return;
-      }
-
-      // This would connect to Supabase and create the site record
-      console.log(chalk.yellow('🚧 This command requires Supabase admin integration.'));
-      console.log('For now, manually add to your Supabase database:');
-      console.log('');
-      console.log(chalk.gray('INSERT INTO docbuilder_sites (domain, name)'));
-      console.log(chalk.gray(`VALUES ('${options.domain}', '${options.name}');`));
-      console.log('');
-      console.log('Then update your config file with the returned site ID.');
-      
-    } catch (error) {
-      console.error(chalk.red('Error adding site:'), error.message);
-    }
-  });
+// Note: auth:add-site command is no longer needed with domain-based authentication
+// Sites don't need to be registered - just grant users access to domains directly
 
 program
   .command('auth:grant')
   .description('Grant user access to documentation site')
   .requiredOption('--email <email>', 'user email address')
-  .requiredOption('--site-id <id>', 'site ID from database')
+  .requiredOption('--domain <domain>', 'site domain (e.g., docs.example.com)')
   .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
   .action(async (options) => {
     console.log(chalk.cyan('\n👥 Grant User Access\n'));
@@ -1637,9 +1606,9 @@ program
       console.log(chalk.yellow('🚧 This command requires Supabase admin integration.'));
       console.log('For now, manually add to your Supabase database:');
       console.log('');
-      console.log(chalk.gray('-- First, get the user ID from auth.users where email = \'user@example.com\''));
-      console.log(chalk.gray('INSERT INTO docbuilder_access (user_id, site_id)'));
-      console.log(chalk.gray(`VALUES ('user-uuid-here', '${options.siteId}');`));
+      console.log(chalk.gray(`-- First, get the user ID from auth.users where email = '${options.email}'`));
+      console.log(chalk.gray('INSERT INTO docbuilder_access (user_id, domain)'));
+      console.log(chalk.gray(`VALUES ('user-uuid-here', '${options.domain}');`));
       
     } catch (error) {
       console.error(chalk.red('Error granting access:'), error.message);

package/html/README.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.951Z",
-  "dateModified": "2025-07-26T10:38:41.951Z",
+  "datePublished": "2025-07-26T11:11:45.854Z",
+  "dateModified": "2025-07-26T11:11:45.854Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -132,7 +132,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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

package/html/auth.js

@@ -51,7 +51,7 @@
                 .from('docbuilder_access')
                 .select('*')
                 .eq('user_id', user.id)
-                .eq('site_id', '-knowcode-doc-builder-1753526321904-eivutk')
+                .eq('site_id', '-knowcode-doc-builder-1753528305501-qlqnmw')
                 .single();
             
             if (accessError || !access) {

package/html/documentation-index.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.963Z",
-  "dateModified": "2025-07-26T10:38:41.963Z",
+  "datePublished": "2025-07-26T11:11:45.864Z",
+  "dateModified": "2025-07-26T11:11:45.864Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -132,7 +132,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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

package/html/guides/authentication-default-change.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.967Z",
-  "dateModified": "2025-07-26T10:38:41.967Z",
+  "datePublished": "2025-07-26T11:11:45.867Z",
+  "dateModified": "2025-07-26T11:11:45.867Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-default-change.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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

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:11:45.870Z",
+  "dateModified": "2025-07-26T11:11:45.870Z",
   "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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -261,8 +261,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 +273,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 +360,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:11:45.874Z",
+  "dateModified": "2025-07-26T11:11:45.874Z",
   "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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

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:11:45.878Z",
+  "dateModified": "2025-07-26T11:11:45.878Z",
   "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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

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:11:45.880Z",
+  "dateModified": "2025-07-26T11:11:45.880Z",
   "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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

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:11:45.883Z",
+  "dateModified": "2025-07-26T11:11:45.883Z",
   "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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -308,34 +308,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:11:45.884Z",
+  "dateModified": "2025-07-26T11:11:45.884Z",
   "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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 
@@ -270,9 +270,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 +338,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>

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

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.985Z",
-  "dateModified": "2025-07-26T10:38:41.985Z",
+  "datePublished": "2025-07-26T11:11:45.886Z",
+  "dateModified": "2025-07-26T11:11:45.886Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/search-engine-verification-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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

package/html/guides/seo-guide.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.988Z",
-  "dateModified": "2025-07-26T10:38:41.988Z",
+  "datePublished": "2025-07-26T11:11:45.889Z",
+  "dateModified": "2025-07-26T11:11:45.889Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>
                 
                 

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

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:38:41.995Z",
-  "dateModified": "2025-07-26T10:38:41.995Z",
+  "datePublished": "2025-07-26T11:11:45.895Z",
+  "dateModified": "2025-07-26T11:11:45.895Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-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.2">Last updated: Jul 26, 2025, 11:11 AM UTC</span>
                 </div>