@knowcode/doc-builder 1.8.1 → 1.8.3

package/html/sitemap.xml

@@ -2,259 +2,265 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://doc-builder-delta.vercel.app/404.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/authentication-default-change.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/cache-control-anti-pattern.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/next-steps-walkthrough.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/private-directory-authentication.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/public-site-deployment.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/search-engine-verification-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/supabase-auth-implementation-plan.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/supabase-auth-integration-plan.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/supabase-auth-setup-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/vercel-deployment-auth-setup.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/README.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/go-to-market-strategy.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/launch-announcements.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/cache-control-anti-pattern.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/launch/README.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/launch/auth-cleanup-summary.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/launch/bubble-plugin-specification.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/launch/go-to-market-strategy.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/launch/launch-announcements.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/launch/vercel-deployment-auth-setup.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-plan.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-integration-plan.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-setup-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/private/test-private-doc.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
+    <changefreq>monthly</changefreq>
+    <priority>0.6</priority>
+  </url>
+  <url>
+    <loc>https://doc-builder-delta.vercel.app/private/user-management-tooling.html</loc>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
-    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
+    <lastmod>2025-07-26T11:11:45.945Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

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

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.444Z",
-  "dateModified": "2025-07-26T10:20:52.444Z",
+  "datePublished": "2025-07-26T11:11:45.933Z",
+  "dateModified": "2025-07-26T11:11:45.933Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.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/vercel-first-time-setup-guide.html

@@ -98,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T10:20:52.446Z",
-  "dateModified": "2025-07-26T10:20:52.446Z",
+  "datePublished": "2025-07-26T11:11:45.935Z",
+  "dateModified": "2025-07-26T11:11:45.935Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.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/lib/config.js

@@ -1,6 +1,7 @@
 const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
+const sharedAuth = require('./shared-auth-config');
 
 /**
  * Default configuration
@@ -36,9 +37,8 @@ const defaultConfig = {
   
   // Authentication - Supabase only (basic auth removed for security)
   auth: {
-    supabaseUrl: '',
-    supabaseAnonKey: '',
-    siteId: ''
+    supabaseUrl: sharedAuth.supabaseUrl,
+    supabaseAnonKey: sharedAuth.supabaseAnonKey
   },
   
   // Changelog settings
@@ -122,9 +122,8 @@ const notionInspiredPreset = {
   },
   
   auth: {
-    supabaseUrl: process.env.SUPABASE_URL || '',
-    supabaseAnonKey: process.env.SUPABASE_ANON_KEY || '',
-    siteId: process.env.DOC_SITE_ID || ''
+    supabaseUrl: process.env.SUPABASE_URL || sharedAuth.supabaseUrl,
+    supabaseAnonKey: process.env.SUPABASE_ANON_KEY || sharedAuth.supabaseAnonKey
   },
   
   changelog: {
@@ -311,15 +310,7 @@ async function loadConfig(configPath, options = {}) {
       console.log(chalk.blue('🔐 Found private directory - automatically enabling Supabase authentication'));
       config.features.authentication = 'supabase';
       config.features.autoAuthEnabled = true; // Track that this was auto-enabled
-      
-      // Check if Supabase credentials are configured
-      if (!config.auth.supabaseUrl || !config.auth.supabaseAnonKey || !config.auth.siteId) {
-        console.warn(chalk.yellow('⚠️  Supabase credentials not configured.'));
-        console.warn(chalk.yellow('   To enable authentication, set the following in your config:'));
-        console.warn(chalk.yellow('   - auth.supabaseUrl'));
-        console.warn(chalk.yellow('   - auth.supabaseAnonKey'));
-        console.warn(chalk.yellow('   - auth.siteId'));
-      }
+      console.log(chalk.yellow('   Note: Grant users access by adding domain to the docbuilder_access table'));
     }
   }
   

package/lib/core-builder.js

@@ -1192,11 +1192,10 @@ async function generateSupabaseAuthFiles(outputDir, config) {
     throw new Error(`Supabase authentication configuration errors:\n${validationErrors.join('\n')}`);
   }
 
-  // If no credentials at all, use placeholder values to generate auth UI
+  // Use configured credentials (now with defaults from shared-auth-config)
   const authConfig = {
-    supabaseUrl: config.auth.supabaseUrl || 'https://placeholder.supabase.co',
-    supabaseAnonKey: config.auth.supabaseAnonKey || 'placeholder-key',
-    siteId: config.auth.siteId || 'placeholder-site-id'
+    supabaseUrl: config.auth.supabaseUrl,
+    supabaseAnonKey: config.auth.supabaseAnonKey
   };
 
   // Create Supabase auth instance

package/lib/shared-auth-config.js

@@ -0,0 +1,13 @@
+/**
+ * Shared Supabase Authentication Configuration
+ * 
+ * These are the default Supabase credentials used by all doc-builder sites.
+ * The same Supabase database is shared across all documentation sites,
+ * with access control managed via the docbuilder_access table using domains as keys.
+ */
+
+module.exports = {
+  // Shared Supabase project credentials
+  supabaseUrl: 'https://xcihhnfcitjrwbynxmka.supabase.co',
+  supabaseAnonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY'
+};

package/lib/supabase-auth.js

@@ -21,8 +21,6 @@ class SupabaseAuth {
         detectSessionInUrl: true
       }
     });
-    
-    this.siteId = config.siteId;
   }
 
   /**
@@ -77,12 +75,12 @@ class SupabaseAuth {
                 return;
             }
             
-            // Check if user has access to this site
+            // Check if user has access to this site (using domain)
             const { data: access, error: accessError } = await supabaseClient
                 .from('docbuilder_access')
                 .select('*')
                 .eq('user_id', user.id)
-                .eq('site_id', '${this.config.siteId}')
+                .eq('domain', window.location.host)
                 .single();
             
             if (accessError || !access) {
@@ -237,12 +235,12 @@ class SupabaseAuth {
                 
                 if (error) throw error;
                 
-                // Check if user has access to this site
+                // Check if user has access to this site (using domain)
                 const { data: access, error: accessError } = await supabaseClient
                     .from('docbuilder_access')
                     .select('*')
                     .eq('user_id', data.user.id)
-                    .eq('site_id', '${this.config.siteId}')
+                    .eq('domain', window.location.host)
                     .single();
                 
                 if (accessError || !access) {
@@ -322,7 +320,7 @@ class SupabaseAuth {
     
     // Only validate if at least one credential is provided
     // This allows the auth UI to show even without full configuration
-    const hasAnyCredential = config.auth.supabaseUrl || config.auth.supabaseAnonKey || config.auth.siteId;
+    const hasAnyCredential = config.auth.supabaseUrl || config.auth.supabaseAnonKey;
     
     if (hasAnyCredential) {
       if (!config.auth.supabaseUrl) {
@@ -333,10 +331,6 @@ class SupabaseAuth {
         errors.push('auth.supabaseAnonKey is required');
       }
       
-      if (!config.auth.siteId) {
-        errors.push('auth.siteId is required');
-      }
-      
       // Validate URL format
       if (config.auth.supabaseUrl && !config.auth.supabaseUrl.match(/^https:\/\/\w+\.supabase\.co$/)) {
         errors.push('auth.supabaseUrl must be a valid Supabase URL (https://xxx.supabase.co)');

package/package.json

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

package/setup-database-v2.sql

@@ -0,0 +1,53 @@
+-- Doc-builder Supabase Database Setup V2
+-- Simplified schema using domains instead of site IDs
+-- Run this in your Supabase SQL Editor
+
+-- Drop old tables if migrating
+-- DROP TABLE IF EXISTS docbuilder_access;
+-- DROP TABLE IF EXISTS docbuilder_sites;
+
+-- Single table for user access control
+CREATE TABLE docbuilder_access (
+    user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
+    domain TEXT NOT NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    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_access ENABLE ROW LEVEL SECURITY;
+
+-- RLS Policy: Users can only see their own access
+CREATE POLICY "Users see own access" ON docbuilder_access
+    FOR SELECT USING (user_id = auth.uid());
+
+-- Example: Grant access to a user for a specific domain
+-- INSERT INTO docbuilder_access (user_id, domain) 
+-- VALUES ('user-uuid-here', 'doc-builder-delta.vercel.app');
+
+-- Example: Grant access to multiple users for a domain
+-- INSERT INTO docbuilder_access (user_id, domain) VALUES 
+--   ('user-1-uuid', 'mydocs.vercel.app'),
+--   ('user-2-uuid', 'mydocs.vercel.app'),
+--   ('user-3-uuid', 'mydocs.vercel.app');
+
+-- Example: Grant a user access to multiple domains
+-- INSERT INTO docbuilder_access (user_id, domain) VALUES 
+--   ('user-uuid', 'docs.example.com'),
+--   ('user-uuid', 'internal-docs.example.com'),
+--   ('user-uuid', 'api-docs.example.com');
+
+-- View all access for a domain (admin use)
+-- SELECT u.email, da.created_at
+-- FROM docbuilder_access da
+-- JOIN auth.users u ON da.user_id = u.id
+-- WHERE da.domain = 'mydocs.vercel.app';
+
+-- Migration from old schema (if needed)
+-- INSERT INTO docbuilder_access (user_id, domain)
+-- SELECT da.user_id, ds.domain
+-- FROM old_docbuilder_access da
+-- JOIN docbuilder_sites ds ON da.site_id = ds.id;

package/user-management/README.md

@@ -175,10 +175,14 @@ Permanently delete a user (removes from ALL sites):
 
 ## ⚠️ Important Limitations
 
-The Supabase CLI doesn't support direct user creation. The script offers two workarounds:
+1. **User Creation**: The Supabase CLI doesn't support direct user creation. The script offers two workarounds:
+   - **Manual Creation** (Recommended): Opens the Supabase dashboard where you can invite users
+   - **Programmatic Creation** (Advanced): If you provide your service_role key, the script can create users using the Admin API
 
-1. **Manual Creation** (Recommended): Opens the Supabase dashboard where you can invite users
-2. **Programmatic Creation** (Advanced): If you provide your service_role key, the script can create users using the Admin API
+2. **SQL Execution**: Older versions of Supabase CLI (< 2.7) don't support `db execute`. The script will:
+   - Try to use `psql` if you have `DATABASE_URL` set
+   - Fall back to showing SQL for manual execution in the dashboard
+   - Consider updating: `npm update -g supabase`
 
 ## 🔐 Security Notes
 
@@ -213,10 +217,7 @@ Run the setup command:
 
 ### "Site not found"
 
-Make sure the site exists in the `docbuilder_sites` table. You can check with:
-```bash
-./add-users.sh sites
-```
+With the new domain-based system, sites no longer need to be registered. Just use the domain directly when granting access.
 
 ### "User already exists"
 
@@ -228,29 +229,23 @@ The user already has access to this site. No action needed.
 
 ## 📊 Database Schema
 
-The system uses two main tables:
-
-### docbuilder_sites
-- `id` (UUID) - Primary key
-- `domain` (TEXT) - Site URL without https://
-- `name` (TEXT) - Display name
-- `created_at` (TIMESTAMP)
+The system uses a single table with domain-based access:
 
 ### docbuilder_access
 - `user_id` (UUID) - References auth.users
-- `site_id` (UUID) - References docbuilder_sites
+- `domain` (TEXT) - Site domain (e.g., docs.example.com)
 - `created_at` (TIMESTAMP)
+- Primary key on (user_id, domain)
 
 ## 🎯 Common Workflows
 
 ### Setting up a new documentation site
 
-1. Add the site to the database (manually or via SQL)
-2. Add users who should have access:
-   ```bash
-   ./add-users.sh add my-docs.vercel.app user1@example.com
-   ./add-users.sh add my-docs.vercel.app user2@example.com
-   ```
+No site registration needed! Just add users with domain access:
+```bash
+./add-users.sh add my-docs.vercel.app user1@example.com
+./add-users.sh add my-docs.vercel.app user2@example.com
+```
 
 ### Onboarding multiple team members