@knowcode/doc-builder 1.7.3 → 1.7.5

package/.claude/settings.local.json

@@ -29,7 +29,12 @@
       "Bash(mkdir:*)",
       "Bash(cp:*)",
       "Bash(./publish.sh)",
-      "Bash(mv:*)"
+      "Bash(mv:*)",
+      "WebFetch(domain:convert-to-markdown.vercel.app)",
+      "Bash(pkill:*)",
+      "Bash(curl:*)",
+      "Bash(./cli.js build:*)",
+      "Bash(./cli.js deploy:*)"
     ],
     "deny": []
   }

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.7.5] - 2025-07-25
+
+### Changed
+- **BREAKING**: Authentication is now disabled by default in all configurations
+- Changed default `authentication: false` in both defaultConfig and notionInspiredPreset
+- Public documentation sites now work out of the box without configuration
+- Authentication must be explicitly enabled with `authentication: 'supabase'`
+
+### Added
+- `--no-auth` flag for build command to override authentication settings
+- `--no-auth` flag for deploy command to override authentication settings
+- Documentation for public site deployment workflows
+- Migration guide for authentication changes
+
+### Improved
+- Simplified createDefaultConfig to only prompt for Supabase authentication
+- Better alignment with common use case of public documentation
+
+## [1.7.4] - 2025-07-24
+
+### Fixed
+- Republished package to fix potential npm registry issues
+- No code changes from 1.7.3
+
 ## [1.7.3] - 2025-07-24
 
 ### Added

package/README.md

@@ -72,7 +72,7 @@ This aligns perfectly with our mission: beautiful documentation should be access
 
 ### 🎯 Advanced Features  
 - 🔍 **SEO Optimized** - Meta tags & structured data
-- 🔐 **Authentication** - Password protection
+- 🔐 **Optional Auth** - Supabase authentication (opt-in)
 - 📊 **Mermaid Diagrams** - Built-in diagram support
 - 🌙 **Dark Mode** - Automatic theme switching
 - ☁️ **Vercel Deploy** - One-command deployment
@@ -210,20 +210,38 @@ module.exports = {
   
   // Features
   features: {
-    authentication: true,
+    authentication: 'supabase',  // or false for no auth
     changelog: true,
     mermaid: true,
     darkMode: true
   },
   
-  // Authentication
+  // Supabase Authentication
   auth: {
-    username: 'admin',
-    password: 'secret'
+    supabaseUrl: process.env.SUPABASE_URL,
+    supabaseAnonKey: process.env.SUPABASE_ANON_KEY,
+    siteId: process.env.DOC_SITE_ID
   }
 };
 ```
 
+### 🔐 Authentication Setup
+
+For secure documentation sites, use Supabase authentication:
+
+```bash
+# Initialize authentication
+npx @knowcode/doc-builder auth:init
+
+# Add your site to database  
+npx @knowcode/doc-builder auth:add-site --domain docs.example.com --name "My Docs"
+
+# Grant user access
+npx @knowcode/doc-builder auth:grant --email user@example.com --site-id xxx
+```
+
+See the [Supabase Authentication Guide](docs/guides/supabase-auth-setup-guide.md) for complete setup instructions.
+
 ## 📋 Commands Overview
 
 <table>
@@ -273,7 +291,6 @@ Options:
   -i, --input <dir>    Input directory (default: docs)
   -o, --output <dir>   Output directory (default: html)
   --preset <preset>    Use a preset configuration
-  --no-auth           Disable authentication
   --no-changelog      Disable changelog generation
 
 Examples:

package/RELEASE-NOTES-1.7.5.md

@@ -0,0 +1,64 @@
+# Release Notes - v1.7.5
+
+## 🎉 Major Change: Authentication is Now Optional by Default!
+
+Starting with v1.7.5, @knowcode/doc-builder defaults to creating **public documentation sites** without authentication. This aligns with the most common use case and makes it even easier to get started.
+
+### What's New
+
+#### 🔓 No Authentication by Default
+- Documentation sites are now public by default
+- No configuration needed for public docs
+- Authentication must be explicitly enabled when needed
+
+#### 🚀 New CLI Flags
+- `--no-auth` flag for both build and deploy commands
+- Override any authentication settings in your config
+- Perfect for quick public deployments
+
+### Examples
+
+```bash
+# Deploy public documentation (default behavior)
+npx @knowcode/doc-builder deploy
+
+# Force public deployment even if config has auth
+npx @knowcode/doc-builder deploy --no-auth
+
+# Enable authentication in config
+# doc-builder.config.js
+module.exports = {
+  features: {
+    authentication: 'supabase'  // Explicitly enable
+  }
+};
+```
+
+### Migration Guide
+
+#### If you want PUBLIC documentation:
+No changes needed! Your sites are now public by default.
+
+#### If you want PRIVATE documentation:
+Add this to your config:
+```javascript
+features: {
+  authentication: 'supabase'
+}
+```
+
+### Why This Change?
+
+- Most documentation should be publicly accessible
+- Reduces friction for new users
+- Makes the tool more intuitive
+- Authentication becomes an intentional choice
+
+### Full Changelog
+
+- **Changed**: Authentication disabled by default in all configurations
+- **Added**: `--no-auth` flags for build and deploy commands
+- **Improved**: Simplified configuration prompts
+- **Docs**: Added public site deployment guide
+
+This is a breaking change, but one that makes the tool simpler and more aligned with common use cases.

package/cli.js

@@ -13,6 +13,7 @@ const { loadConfig, createDefaultConfig } = require('./lib/config');
 const { generateDescription } = require('./lib/seo');
 const { execSync } = require('child_process');
 const matter = require('gray-matter');
+const SupabaseAuth = require('./lib/supabase-auth');
 
 // Package info
 const packageJson = require('./package.json');
@@ -70,22 +71,31 @@ program
   .option('-o, --output <dir>', 'output directory for HTML files (default: html)')
   .option('--preset <preset>', 'use a preset configuration (available: notion-inspired)')
   .option('--legacy', 'use legacy mode for backward compatibility')
-  .option('--no-auth', 'disable authentication even if configured')
   .option('--no-changelog', 'disable automatic changelog generation')
   .option('--no-pdf', 'hide PDF download icon in header')
   .option('--menu-closed', 'start with navigation menu closed')
+  .option('--no-auth', 'build without authentication (for public sites)')
   .addHelpText('after', `
 ${chalk.yellow('Examples:')}
   ${chalk.gray('$')} doc-builder build                        ${chalk.gray('# Build with defaults')}
   ${chalk.gray('$')} doc-builder build --input docs --output dist
   ${chalk.gray('$')} doc-builder build --preset notion-inspired ${chalk.gray('# Use Notion-inspired preset')}
   ${chalk.gray('$')} doc-builder build --config my-config.js  ${chalk.gray('# Use custom config')}
+  ${chalk.gray('$')} doc-builder build --no-auth              ${chalk.gray('# Build public site without authentication')}
 `)
   .action(async (options) => {
     const spinner = ora('Building documentation...').start();
     
     try {
       const config = await loadConfig(options.config || 'doc-builder.config.js', { ...options, command: 'build' });
+      
+      // Handle no-auth option
+      if (options.auth === false) {
+        // Temporarily disable authentication for this build
+        config.features = config.features || {};
+        config.features.authentication = false;
+      }
+      
       await build(config);
       spinner.succeed('Documentation built successfully!');
     } catch (error) {
@@ -595,10 +605,12 @@ program
   .option('--no-prod', 'deploy as preview instead of production')
   .option('--force', 'force deployment without confirmation')
   .option('--production-url <url>', 'override production URL for this deployment')
+  .option('--no-auth', 'build without authentication (for public sites)')
   .addHelpText('after', `
 ${chalk.yellow('Examples:')}
   ${chalk.gray('$')} doc-builder deploy                 ${chalk.gray('# Deploy to production')}
   ${chalk.gray('$')} doc-builder deploy --no-prod       ${chalk.gray('# Deploy preview only')}
+  ${chalk.gray('$')} doc-builder deploy --no-auth       ${chalk.gray('# Deploy public site without authentication')}
 
 ${chalk.yellow('First-time Vercel Setup:')}
   
@@ -744,6 +756,13 @@ ${chalk.yellow('Troubleshooting:')}
           : 'https://' + options.productionUrl;
       }
       
+      // Handle no-auth option
+      if (options.auth === false) {
+        // Temporarily disable authentication for this build
+        config.features = config.features || {};
+        config.features.authentication = false;
+      }
+      
       // Always build first
       spinner.stop();
       console.log(chalk.blue('\n📦 Building documentation first...\n'));
@@ -1466,7 +1485,7 @@ program
       console.log(`  • Favicon: ${chalk.green(config.favicon || '✨')}`);
       
       console.log(chalk.yellow('\n✨ Features:'));
-      console.log(`  • Authentication: ${config.features?.authentication ? chalk.green('Enabled') : chalk.gray('Disabled')}`);
+      console.log(`  • Authentication: ${config.features?.authentication === 'supabase' ? chalk.green('Supabase') : chalk.gray('Disabled')}`);
       console.log(`  • Dark mode: ${config.features?.darkMode !== false ? chalk.green('Enabled') : chalk.gray('Disabled')}`);
       console.log(`  • Mermaid diagrams: ${config.features?.mermaid !== false ? chalk.green('Enabled') : chalk.gray('Disabled')}`);
       console.log(`  • Changelog: ${config.features?.changelog !== false ? chalk.green('Enabled') : chalk.gray('Disabled')}`);
@@ -1475,10 +1494,11 @@ program
       console.log(`  • PDF download: ${config.features?.showPdfDownload !== false ? chalk.green('Shown') : chalk.gray('Hidden')}`);
       console.log(`  • Menu default: ${config.features?.menuDefaultOpen !== false ? chalk.green('Open') : chalk.gray('Closed')}`);
       
-      if (config.features?.authentication) {
-        console.log(chalk.yellow('\n🔐 Authentication:'));
-        console.log(`  • Username: ${chalk.green(config.auth?.username || 'admin')}`);
-        console.log(`  • Password: ${chalk.gray('***' + (config.auth?.password?.slice(-2) || '**'))}`);
+      if (config.features?.authentication === 'supabase') {
+        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) {
@@ -1495,11 +1515,198 @@ program
     }
   });
 
-// Update the help text to mention the settings command
+// Authentication management commands
+program
+  .command('auth:init')
+  .description('Initialize Supabase authentication for this project')
+  .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
+  .action(async (options) => {
+    console.log(chalk.cyan('\n🔐 Initialize Supabase Authentication\n'));
+    
+    try {
+      const answers = await prompts([
+        {
+          type: 'text',
+          name: 'supabaseUrl',
+          message: 'Enter your Supabase project URL:',
+          validate: (value) => value.match(/^https:\/\/\w+\.supabase\.co$/) ? true : 'Please enter a valid Supabase URL (https://xxx.supabase.co)'
+        },
+        {
+          type: 'password',
+          name: 'supabaseAnonKey',
+          message: 'Enter your Supabase anonymous key:'
+        },
+        {
+          type: 'text',
+          name: 'siteName',
+          message: 'Enter a name for this documentation site:',
+          initial: 'Documentation'
+        }
+      ]);
+
+      if (!answers.supabaseUrl || !answers.supabaseAnonKey) {
+        console.log(chalk.yellow('Setup cancelled.'));
+        return;
+      }
+
+      // Create or update config file
+      const configPath = options.config || 'doc-builder.config.js';
+      const configContent = `module.exports = {
+  siteName: '${answers.siteName}',
+  
+  features: {
+    authentication: 'supabase'
+  },
+  
+  auth: {
+    supabaseUrl: '${answers.supabaseUrl}',
+    supabaseAnonKey: '${answers.supabaseAnonKey}',
+    siteId: ''  // Will be set after creating site in database
+  }
+};`;
+
+      await fs.writeFile(configPath, configContent);
+      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');
+      
+    } 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);
+    }
+  });
+
+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')
+  .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'));
+    
+    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.'));
+        return;
+      }
+
+      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}');`));
+      
+    } catch (error) {
+      console.error(chalk.red('Error granting access:'), error.message);
+    }
+  });
+
+program
+  .command('auth:revoke')
+  .description('Revoke user access to documentation site')
+  .requiredOption('--email <email>', 'user email address')
+  .requiredOption('--site-id <id>', 'site ID from database')
+  .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
+  .action(async (options) => {
+    console.log(chalk.cyan('\n🚫 Revoke User Access\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.'));
+        return;
+      }
+
+      console.log(chalk.yellow('🚧 This command requires Supabase admin integration.'));
+      console.log('For now, manually remove from your Supabase database:');
+      console.log('');
+      console.log(chalk.gray('DELETE FROM docbuilder_access'));
+      console.log(chalk.gray('WHERE user_id = (SELECT id FROM auth.users WHERE email = \'user@example.com\')'));
+      console.log(chalk.gray(`AND site_id = '${options.siteId}';`));
+      
+    } catch (error) {
+      console.error(chalk.red('Error revoking access:'), error.message);
+    }
+  });
+
+program
+  .command('auth:list-users')
+  .description('List users with access to documentation site')
+  .requiredOption('--site-id <id>', 'site ID from database')
+  .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
+  .action(async (options) => {
+    console.log(chalk.cyan('\n👥 List Site Users\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.'));
+        return;
+      }
+
+      console.log(chalk.yellow('🚧 This command requires Supabase admin integration.'));
+      console.log('For now, manually query your Supabase database:');
+      console.log('');
+      console.log(chalk.gray('SELECT u.email, da.created_at as granted_at'));
+      console.log(chalk.gray('FROM docbuilder_access da'));
+      console.log(chalk.gray('JOIN auth.users u ON u.id = da.user_id'));
+      console.log(chalk.gray(`WHERE da.site_id = '${options.siteId}';`));
+      
+    } catch (error) {
+      console.error(chalk.red('Error listing users:'), error.message);
+    }
+  });
+
+// Update the help text to mention new commands
 program.addHelpText('after', `
 ${chalk.cyan('📋 View Settings:')}
   ${chalk.gray('$')} doc-builder settings                    ${chalk.gray('# Show current configuration')}
   ${chalk.gray('$')} doc-builder settings --config custom.js  ${chalk.gray('# Show specific config file')}
+
+${chalk.cyan('🔐 Authentication Management:')}
+  ${chalk.gray('$')} doc-builder auth:init                   ${chalk.gray('# Set up Supabase authentication')}
+  ${chalk.gray('$')} doc-builder auth:add-site --domain docs.example.com --name "Company Docs"
+  ${chalk.gray('$')} doc-builder auth:grant --email user@example.com --site-id xxx
+  ${chalk.gray('$')} doc-builder auth:list-users --site-id xxx
 `);
 
 // Parse arguments

package/grant-access.sql

@@ -0,0 +1,15 @@
+-- Grant access to test user
+-- Run this in your Supabase SQL Editor
+
+INSERT INTO docbuilder_access (user_id, site_id)
+VALUES ('46cad259-9692-4df7-b19d-839e164a0390', '4d8a53bf-dcdd-48c0-98e0-cd1451518735');
+
+-- Verify the access was granted
+SELECT 
+    u.email,
+    s.name as site_name,
+    da.created_at as access_granted
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id  
+JOIN docbuilder_sites s ON s.id = da.site_id
+WHERE da.user_id = '46cad259-9692-4df7-b19d-839e164a0390';

package/html/README.html

@@ -45,6 +45,8 @@
     <!-- Styles -->
     <link rel="stylesheet" href="/css/notion-style.css">
     
+    
+    
     <!-- Favicon -->
     <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>✨</text></svg>">
     
@@ -63,8 +65,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-24T09:07:52.307Z",
-  "dateModified": "2025-07-24T09:07:52.307Z",
+  "datePublished": "2025-07-25T13:01:14.155Z",
+  "dateModified": "2025-07-25T13:01:14.155Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -97,7 +99,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.7.2">Last updated: Jul 24, 2025, 09:07 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.7.5">Last updated: Jul 25, 2025, 01:01 PM UTC</span>
                 </div>
                 
                 
@@ -155,14 +157,22 @@
           <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
         </a>
         <div class="nav-content" id="nav-guides-1">
-        <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="This guide explains how to configure and use the built-in authentication feature in @knowcode/doc-builder to protect your documentation with basic..."><i class="fas fa-file-alt"></i> Authentication Guide</a>
+        <a href="/guides/authentication-default-change.html" class="nav-item" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="fas fa-file-alt"></i> Authentication Default Change</a>
+        <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="🚨 This authentication method has been REMOVED in version 2.0.0 due to serious security flaws."><i class="fas fa-file-alt"></i> Authentication Guide</a>
+        <a href="/guides/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="/guides/claude-workflow-guide.html" class="nav-item" data-tooltip="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it..."><i class="fas fa-file-alt"></i> Claude Workflow Guide</a>
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
+        <a href="/guides/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="/guides/phosphor-icons-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder automatically converts Unicode emojis in your markdown files to beautiful Phosphor icons in the generated HTML."><i class="fas fa-file-alt"></i> Phosphor Icons Guide</a>
+        <a href="/guides/public-site-deployment.html" class="nav-item" data-tooltip="The @knowcode/doc-builder now supports deploying public documentation sites without authentication."><i class="fas fa-file-alt"></i> Public Site Deployment</a>
         <a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="fas fa-file-alt"></i> Search Engine Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
         <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/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="/guides/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="/guides/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder now supports enterprise-grade authentication through Supabase, replacing the previous insecure basic authentication."><i class="fas fa-file-alt"></i> Supabase Auth Setup 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/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>
         <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" data-level="1">
         <a class="nav-title collapsible expanded" href="/launch/README.html" data-target="nav-launch-1" >

package/html/auth.js

@@ -0,0 +1,97 @@
+
+/**
+ * Supabase Authentication for Documentation Site
+ * Generated by @knowcode/doc-builder
+ */
+
+(function() {
+    'use strict';
+    
+    // Skip auth check on login and logout pages
+    const currentPage = window.location.pathname;
+    if (currentPage === '/login.html' || currentPage === '/logout.html' || 
+        currentPage.includes('login') || currentPage.includes('logout')) {
+        return;
+    }
+    
+    // Initialize Supabase client
+    const { createClient } = supabase;
+    const supabaseClient = createClient('https://xcihhnfcitjrwbynxmka.supabase.co', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY', {
+        auth: {
+            persistSession: true,
+            autoRefreshToken: true,
+            detectSessionInUrl: true
+        }
+    });
+    
+    // Check authentication and site access
+    async function checkAuth() {
+        try {
+            // Get current user session
+            const { data: { user }, error: userError } = await supabaseClient.auth.getUser();
+            
+            if (userError || !user) {
+                redirectToLogin();
+                return;
+            }
+            
+            // Check if user has access to this site
+            const { data: access, error: accessError } = await supabaseClient
+                .from('docbuilder_access')
+                .select('*')
+                .eq('user_id', user.id)
+                .eq('site_id', '4d8a53bf-dcdd-48c0-98e0-cd1451518735')
+                .single();
+            
+            if (accessError || !access) {
+                showAccessDenied();
+                return;
+            }
+            
+            // User is authenticated and has access
+            console.log('User authenticated and authorized');
+            document.body.classList.add('authenticated');
+            
+        } catch (error) {
+            console.error('Auth check failed:', error);
+            redirectToLogin();
+        }
+    }
+    
+    // Redirect to login page
+    function redirectToLogin() {
+        const currentUrl = window.location.pathname + window.location.search;
+        const loginUrl = '/login.html' + (currentUrl !== '/' ? '?redirect=' + encodeURIComponent(currentUrl) : '');
+        window.location.href = loginUrl;
+    }
+    
+    // Show access denied message
+    function showAccessDenied() {
+        document.body.classList.add('authenticated'); // Show the body
+        document.body.innerHTML = `
+            <div style="display: flex; justify-content: center; align-items: center; height: 100vh; font-family: Inter, sans-serif;">
+                <div style="text-align: center; max-width: 400px;">
+                    <h1 style="color: #ef4444; margin-bottom: 1rem;">Access Denied</h1>
+                    <p style="color: #6b7280; margin-bottom: 2rem;">You don't have permission to view this documentation site.</p>
+                    <a href="/login.html" style="background: #3b82f6; color: white; padding: 0.75rem 1.5rem; border-radius: 0.5rem; text-decoration: none;">Try Different Account</a>
+                </div>
+            </div>
+        `;
+    }
+    
+    // Add logout functionality
+    document.addEventListener('DOMContentLoaded', function() {
+        const logoutLinks = document.querySelectorAll('a[href*="logout"]');
+        logoutLinks.forEach(link => {
+            link.addEventListener('click', async function(e) {
+                e.preventDefault();
+                await supabaseClient.auth.signOut();
+                window.location.href = '/logout.html';
+            });
+        });
+    });
+    
+    // Run auth check
+    checkAuth();
+    
+})();