@knowcode/doc-builder 1.8.1 → 1.8.3

package/CHANGELOG.md

@@ -5,6 +5,43 @@ 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
+- **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`
+- **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 grant users access to domains, no site registration needed
+
 ## [1.8.1] - 2025-07-26
 
 ### Fixed

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:20:52.365Z",
-  "dateModified": "2025-07-26T10:20:52.365Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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

@@ -16,7 +16,7 @@
     
     // Initialize Supabase client
     const { createClient } = supabase;
-    const supabaseClient = createClient('https://placeholder.supabase.co', 'placeholder-key', {
+    const supabaseClient = createClient('https://xcihhnfcitjrwbynxmka.supabase.co', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY', {
         auth: {
             persistSession: true,
             autoRefreshToken: true,
@@ -51,7 +51,7 @@
                 .from('docbuilder_access')
                 .select('*')
                 .eq('user_id', user.id)
-                .eq('site_id', 'placeholder-site-id')
+                .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:20:52.374Z",
-  "dateModified": "2025-07-26T10:20:52.374Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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:20:52.377Z",
-  "dateModified": "2025-07-26T10:20:52.377Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform. This guide explains how to...">
+    <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="author" content="Lindsay Smith">
@@ -15,7 +15,7 @@
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/authentication-guide.html">
     <meta property="og:title" content="Authentication Guide for @knowcode/doc-builder">
-    <meta property="og:description" content="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform. This guide explains how to...">
+    <meta property="og: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.">
     <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     <meta property="og:site_name" content="@knowcode/doc-builder">
     <meta property="og:locale" content="en_US">
@@ -25,7 +25,7 @@
     <meta name="twitter:site" content="@planbbackups">
     <meta name="twitter:creator" content="@planbbackups">
     <meta name="twitter:title" content="Authentication Guide for @knowcode/doc-builder">
-    <meta name="twitter:description" content="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform. This guide explains how to...">
+    <meta name="twitter: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.">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
     <!-- Custom Meta Tags -->
@@ -88,7 +88,7 @@
   "@context": "https://schema.org",
   "@type": "TechArticle",
   "headline": "Authentication Guide for @knowcode/doc-builder",
-  "description": "@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform. This guide explains how to...",
+  "description": "> 🎉 Update v1.8.2: Supabase credentials are now automatically configured! No manual setup needed - just enable authentication and add users to the database.",
   "author": {
     "@type": "Person",
     "name": "Lindsay Smith"
@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.380Z",
-  "dateModified": "2025-07-26T10:20:52.380Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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>
                 
                 
@@ -220,6 +220,9 @@
         <main class="content">
             <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>
+</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>
@@ -258,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;,
   
@@ -268,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>
@@ -367,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:20:52.384Z",
-  "dateModified": "2025-07-26T10:20:52.384Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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:20:52.388Z",
-  "dateModified": "2025-07-26T10:20:52.388Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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:20:52.390Z",
-  "dateModified": "2025-07-26T10:20:52.390Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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:20:52.393Z",
-  "dateModified": "2025-07-26T10:20:52.393Z",
+  "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.0">Last updated: Jul 26, 2025, 10:20 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>
                 
                 
@@ -264,11 +264,12 @@ module.exports = {
 };
 </code></pre>
 <h2>How They Work Together</h2>
-<p>If you have <strong>both</strong> a private directory AND set <code>authentication: &#39;supabase&#39;</code> in your config:</p>
+<p>If you have <strong>both</strong> a private directory AND set authentication in your config:</p>
 <ul>
-<li>The config setting takes precedence</li>
-<li>The entire site becomes private (full authentication mode)</li>
-<li>The private directory distinction becomes irrelevant since everything requires login</li>
+<li>The private directory <strong>always</strong> triggers authentication (for security)</li>
+<li>Setting <code>authentication: &#39;supabase&#39;</code> makes the entire site private</li>
+<li>Setting <code>authentication: false</code> is overridden by private directory presence</li>
+<li>This ensures private content is never accidentally exposed</li>
 </ul>
 <h2>User Experience</h2>
 <h3>Private Directory Mode</h3>
@@ -295,41 +296,65 @@ module.exports = {
 </ul>
 <h2>Setting Up Supabase Authentication</h2>
 <p>Both authentication modes use Supabase for secure user management. Here&#39;s how to configure it:</p>
-<h3>1. Configure Credentials</h3>
-<p>Add your Supabase credentials to <code>doc-builder.config.js</code>:</p>
+<h3>1. Credentials Are Automatic! (v1.8.2+)</h3>
+<p>No need to configure credentials anymore! The shared Supabase database is automatically configured. Each site gets a unique auto-generated site ID during build.</p>
+<p>To override with custom credentials (optional):</p>
 <pre><code class="language-javascript">module.exports = {
   auth: {
-    supabaseUrl: &#39;https://your-project.supabase.co&#39;,
-    supabaseAnonKey: &#39;your-anon-key&#39;,
-    siteId: &#39;your-site-id&#39;  // Unique identifier for this doc site
+    supabaseUrl: &#39;https://your-project.supabase.co&#39;,  // Optional override
+    supabaseAnonKey: &#39;your-anon-key&#39;,                 // Optional override
+    siteId: &#39;your-site-id&#39;                            // Optional custom ID
   }
 };
 </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>What Happens Without Credentials?</h3>
-<p>If you enable authentication (via private directory or config) without configuring Supabase:</p>
+<h3>Automatic Credential Configuration</h3>
+<p>Starting from version 1.8.2, authentication is truly zero-configuration:</p>
 <ul>
-<li>The login button still appears</li>
-<li>Login page shows Supabase connection error</li>
-<li>This reminds you to complete the configuration</li>
-<li>Your documentation structure is ready, just needs credentials</li>
+<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>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>: When you build with a private directory:</p>
+<pre><code>🔐 Found private directory - automatically enabling Supabase authentication
+   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>
 <p><strong>Use Private Directory Mode when:</strong></p>