@knowcode/doc-builder 1.9.10 → 1.9.12

package/README.md

@@ -230,22 +230,67 @@ module.exports = {
 };
 ```
 
-### 🔐 Authentication Setup
+### 🔐 Supabase Authentication
 
-For secure documentation sites, use Supabase authentication:
+Secure your documentation with enterprise-grade authentication powered by **Supabase**. Built-in credentials mean zero configuration required!
 
+#### ✨ Authentication Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔐 **Enterprise Security** | JWT tokens, bcrypt hashing, Row Level Security |
+| 🏗️ **Zero Configuration** | Built-in Supabase credentials - just enable and go |
+| 🌐 **Domain-based Access** | No site registration needed - uses your domain automatically |
+| 📁 **Private Directory Support** | `/private/` folders automatically protected |
+| 👥 **Multi-user Management** | Unlimited users with fine-grained access control |
+| 🔄 **Session Management** | Auto-refresh tokens, persistent sessions |
+| 🎨 **Beautiful Login Pages** | Auto-generated login/logout pages with your theme |
+
+#### 🚀 Quick Setup
+
+**Option 1: Private Directory (Recommended)**
 ```bash
-# Initialize authentication
-npx @knowcode/doc-builder auth:init
+# Create private folder - authentication automatically enabled!
+mkdir docs/private
+echo "# Secret Documentation" > docs/private/admin.md
+npx @knowcode/doc-builder deploy
+```
+
+**Option 2: Global Authentication**
+```javascript
+// doc-builder.config.js
+module.exports = {
+  features: {
+    authentication: 'supabase'  // Protect entire site
+  }
+};
+```
 
-# Add your site to database  
-npx @knowcode/doc-builder auth:add-site --domain docs.example.com --name "My Docs"
+#### 👥 User Management
 
-# Grant user access
-npx @knowcode/doc-builder auth:grant --email user@example.com --site-id xxx
+```bash
+# Grant user access to your domain (SQL in Supabase dashboard)
+INSERT INTO docbuilder_access (user_id, domain)
+VALUES (
+    (SELECT id FROM auth.users WHERE email = 'user@example.com'),
+    'your-docs-domain.vercel.app'
+);
 ```
 
-See the [Supabase Authentication Guide](docs/guides/supabase-auth-setup-guide.md) for complete setup instructions.
+#### 🔧 Authentication Modes
+
+- **🌍 Global Auth**: Entire site requires login (`authentication: 'supabase'`)
+- **📁 Private Directory**: Only `/private/` folders protected (automatic)
+- **🔄 Hybrid**: Public docs + private sections (most flexible)
+
+#### 📚 Complete Guide
+
+See the [Complete Supabase Authentication Guide](docs/guides/authentication-guide.md) for:
+- Detailed setup instructions
+- Database schema setup
+- User management workflows  
+- Security best practices
+- Troubleshooting guide
 
 ### 📎 Attachment Support
 

package/doc-builder.config.js

@@ -1,5 +1,5 @@
 module.exports = {
-  "configVersion": "1.9.8",
+  "configVersion": "1.9.11",
   "docsDir": "docs",
   "outputDir": "html",
   "siteName": "@knowcode/doc-builder",

package/doc-builder.config.js.backup.1753945707032

@@ -0,0 +1,115 @@
+module.exports = {
+  "configVersion": "1.9.8",
+  "docsDir": "docs",
+  "outputDir": "html",
+  "siteName": "@knowcode/doc-builder",
+  "siteDescription": "Beautiful documentation with the least effort possible",
+  "favicon": "✨",
+  "features": {
+    "authentication": false,
+    "changelog": true,
+    "mermaid": true,
+    "tooltips": true,
+    "search": false,
+    "darkMode": true,
+    "phosphorIcons": true,
+    "phosphorWeight": "regular",
+    "phosphorSize": "1.2em",
+    "normalizeTitle": true,
+    "showPdfDownload": true,
+    "menuDefaultOpen": false,
+    "attachments": true,
+    "dynamicNavIcons": true,
+    "subtleColors": true,
+    "privateDirectoryAuth": false
+  },
+  "auth": {
+    "supabaseUrl": "https://xcihhnfcitjrwbynxmka.supabase.co",
+    "supabaseAnonKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY"
+  },
+  "changelog": {
+    "daysBack": 14,
+    "enabled": true
+  },
+  "folderOrder": [],
+  "folderDescriptions": {},
+  "folderIcons": {},
+  "deployment": {
+    "platform": "vercel",
+    "outputDirectory": "html"
+  },
+  "seo": {
+    "enabled": true,
+    "siteUrl": "https://doc-builder-delta.vercel.app",
+    "author": "Lindsay Smith",
+    "twitterHandle": "@planbbackups",
+    "language": "en-US",
+    "keywords": [
+      "documentation",
+      "markdown",
+      "static site generator",
+      "vercel",
+      "notion-style"
+    ],
+    "titleTemplate": "{pageTitle} | {siteName}",
+    "autoKeywords": true,
+    "keywordLimit": 7,
+    "descriptionFallback": "smart",
+    "organization": {
+      "name": "Knowcode Ltd",
+      "url": "https://knowcode.tech",
+      "logo": ""
+    },
+    "ogImage": "/og-default.png",
+    "generateSitemap": true,
+    "generateRobotsTxt": true,
+    "customMetaTags": [
+      {
+        "name": "google-site-verification",
+        "content": "FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ"
+      },
+      {
+        "name": "msvalidate.01",
+        "content": "B2D8C4C12C530D47AA962B24CAA09630"
+      }
+    ]
+  },
+  "attachmentTypes": [
+    ".pdf",
+    ".doc",
+    ".docx",
+    ".xls",
+    ".xlsx",
+    ".csv",
+    ".ppt",
+    ".pptx",
+    ".txt",
+    ".rtf",
+    ".html",
+    ".htm",
+    ".zip",
+    ".tar",
+    ".gz",
+    ".7z",
+    ".rar",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".webp",
+    ".ico",
+    ".bmp",
+    ".json",
+    ".xml",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".mp4",
+    ".mp3",
+    ".wav",
+    ".avi",
+    ".mov"
+  ],
+  "productionUrl": "https://doc-builder-delta.vercel.app"
+};

package/html/README.html

@@ -6,6 +6,7 @@
     <meta name="description" content="&lt;div align=&quot;center&quot;&gt;">
     <title>@knowcode/doc-builder | @knowcode/doc-builder</title>
     
+    <meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
     <meta name="author" content="Lindsay Smith">
     <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, width, table">
     <meta name="robots" content="index, follow">
@@ -98,8 +99,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-29T09:30:31.298Z",
-  "dateModified": "2025-07-29T09:30:31.298Z",
+  "datePublished": "2025-07-31T07:08:27.327Z",
+  "dateModified": "2025-07-31T07:08:27.327Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -132,7 +133,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.5">Last updated: Jul 29, 2025, 09:30 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
                 </div>
                 
                 
@@ -198,6 +199,7 @@
         <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="ph ph-file-text"></i> Authentication Default Change</a>
         <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform."><i class="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
+        <a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration 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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
         <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
         <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
@@ -208,6 +210,7 @@
         <a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
         <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
+        <a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete 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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
         <a href="/guides/windows-setup-guide.html" class="nav-item" data-tooltip="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel."><i class="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
       <div class="nav-section private-nav" data-level="1">
@@ -239,6 +242,7 @@
           <i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
         </a>
         <div class="nav-content" id="nav-prompts-1">
+        <a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
         <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
             </nav>
             <div class="resize-handle"></div>
@@ -254,26 +258,26 @@
 <p>Transform your markdown documentation into beautiful, searchable websites with Notion-inspired styling</p>
 </blockquote>
 <p><a href="https://www.npmjs.com/package/@knowcode/doc-builder"><img src="https://img.shields.io/npm/v/@knowcode/doc-builder" alt="npm version"></a><br><a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a></p>
-<h3><i class="ph ph-rocket-launch" aria-label="launch"></i> Quick Start</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> Quick Start</h3>
 <pre><code class="language-bash">npx @knowcode/doc-builder@latest deploy
 </code></pre>
 <p><a href="https://doc-builder-delta.vercel.app"><strong>You are looking at a demo</strong></a> | <a href="https://www.npmjs.com/package/@knowcode/doc-builder"><strong>NPM Package</strong></a> | <a href="https://github.com/wapdat/doc-builder"><strong>GitHub</strong></a></p>
 </div>
 
 <hr>
-<h2><i class="ph ph-sparkle" aria-label="special"></i> Features</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-sparkle" aria-label="special"></i> Features</h2>
 <table>
 <tr>
 <td width="50%">
 
-<h3><i class="ph ph-palette" aria-label="design"></i> Design &amp; UX</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-palette" aria-label="design"></i> Design &amp; UX</h3>
 <ul>
 <li><strong>Notion-inspired UI</strong> - Clean, modern interface</li>
 <li><strong>Dark mode support</strong> - Automatic theme switching</li>
 <li><strong>Responsive layout</strong> - Perfect on any device</li>
 <li><strong>Syntax highlighting</strong> - Beautiful code blocks</li>
 </ul>
-<h3><i class="ph ph-magnifying-glass" aria-label="search"></i> Navigation</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-magnifying-glass" aria-label="search"></i> Navigation</h3>
 <ul>
 <li><strong>Full-text search</strong> - Find anything instantly</li>
 <li><strong>Smart navigation</strong> - Hierarchical structure</li>
@@ -283,14 +287,14 @@
 </td>
 <td width="50%">
 
-<h3><i class="ph ph-chart-bar" aria-label="chart"></i> Content Support</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-chart-bar" aria-label="chart"></i> Content Support</h3>
 <ul>
 <li><strong>Mermaid diagrams</strong> - Visual documentation</li>
 <li><strong>GitHub markdown</strong> - Full GFM support</li>
 <li><strong>Interactive tooltips</strong> - Document previews</li>
 <li><strong>Version tracking</strong> - Build metadata</li>
 </ul>
-<h3><i class="ph ph-rocket-launch" aria-label="launch"></i> Deployment</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> Deployment</h3>
 <ul>
 <li><strong>One-command deploy</strong> - Push to Vercel</li>
 <li><strong>Static generation</strong> - Fast &amp; secure</li>
@@ -301,7 +305,7 @@
 </tr>
 </table>
 
-<h2><i class="ph ph-target" aria-label="goal"></i> Use Cases</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-target" aria-label="goal"></i> Use Cases</h2>
 <table>
 <tr>
 <td width="25%">
@@ -327,7 +331,7 @@
 </tr>
 </table>
 
-<h2><i class="ph ph-gear-six" aria-label="tools"></i> Simple Workflow</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-gear-six" aria-label="tools"></i> Simple Workflow</h2>
 <table>
 <tr>
 <td width="50%">
@@ -347,8 +351,15 @@
 </tr>
 </table>
 
-<h2><i class="ph ph-gear" aria-label="settings"></i> Configuration</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-gear" aria-label="settings"></i> Configuration</h2>
 <p>Configuration is fully managed through the CLI tools - no manual file editing required! The tool handles all settings automatically during setup and deployment.</p>
+<h3><i style="font-size: 1.2em" class="ph ph-arrows-clockwise" aria-label="refresh"></i> Auto-Configuration</h3>
+<ul>
+<li><strong>Auto-creation</strong>: If no <code>doc-builder.config.js</code> exists, one is created with all default settings</li>
+<li><strong>Auto-update</strong>: When upgrading versions, new features are automatically added to your config</li>
+<li><strong>Safe migration</strong>: Your customizations are preserved while adding new defaults</li>
+<li><strong>Backup protection</strong>: Config files are backed up before major updates</li>
+</ul>
 <table>
 <tr>
 <td width="50%">
@@ -382,7 +393,7 @@ features: {
 </tr>
 </table>
 
-<h2><i class="ph ph-chart-bar" aria-label="chart"></i> Rich Content Examples</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-chart-bar" aria-label="chart"></i> Rich Content Examples</h2>
 <table>
 <tr>
 <td width="50%">
@@ -413,12 +424,12 @@ docBuilder.build({
 </tr>
 </table>
 
-<h2><i class="ph ph-star-four" aria-label="sparkle"></i> Why Choose doc-builder?</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-star-four" aria-label="sparkle"></i> Why Choose doc-builder?</h2>
 <table>
 <tr>
 <td width="33%">
 
-<h3><i class="ph ph-rocket-launch" aria-label="launch"></i> Performance</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> Performance</h3>
 <ul>
 <li><strong>Lightning fast</strong> - Static generation</li>
 <li><strong>SEO optimized</strong> - Search friendly</li>
@@ -427,7 +438,7 @@ docBuilder.build({
 </td>
 <td width="33%">
 
-<h3><i class="ph ph-gear-six" aria-label="tools"></i> Developer Experience</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-gear-six" aria-label="tools"></i> Developer Experience</h3>
 <ul>
 <li><strong>Zero config</strong> - Works instantly</li>
 <li><strong>Version control</strong> - Git-friendly</li>
@@ -436,7 +447,7 @@ docBuilder.build({
 </td>
 <td width="33%">
 
-<h3><i class="ph ph-money" aria-label="money"></i> Cost Effective</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-money" aria-label="money"></i> Cost Effective</h3>
 <ul>
 <li><strong>Free hosting</strong> - Vercel free tier</li>
 <li><strong>No vendor lock-in</strong> - Your content</li>
@@ -446,7 +457,7 @@ docBuilder.build({
 </tr>
 </table>
 
-<h2><i class="ph ph-handshake" aria-label="partnership"></i> Get Involved</h2>
+<h2><i style="font-size: 1.2em" class="ph ph-handshake" aria-label="partnership"></i> Get Involved</h2>
 <table>
 <tr>
 <td width="50%">
@@ -455,10 +466,10 @@ docBuilder.build({
 <p>We welcome contributions! Check our <a href="https://github.com/wapdat/doc-builder">contribution guide</a> to get started.</p>
 <p><strong>Ways to help:</strong></p>
 <ul>
-<li><i class="ph ph-bug" aria-label="bug"></i> Report bugs</li>
-<li><i class="ph ph-lightbulb" aria-label="idea"></i> Suggest features</li>
-<li><i class="ph ph-note-pencil" aria-label="edit"></i> Improve docs</li>
-<li><i class="ph ph-wrench" aria-label="settings"></i> Submit PRs</li>
+<li><i style="font-size: 1.2em" class="ph ph-bug" aria-label="bug"></i> Report bugs</li>
+<li><i style="font-size: 1.2em" class="ph ph-lightbulb" aria-label="idea"></i> Suggest features</li>
+<li><i style="font-size: 1.2em" class="ph ph-note-pencil" aria-label="edit"></i> Improve docs</li>
+<li><i style="font-size: 1.2em" class="ph ph-wrench" aria-label="settings"></i> Submit PRs</li>
 </ul>
 </td>
 <td width="50%">
@@ -467,10 +478,10 @@ docBuilder.build({
 <p>Join our growing community of documentation enthusiasts!</p>
 <p><strong>Connect with us:</strong></p>
 <ul>
-<li><i class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
-<li><i class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/wapdat/doc-builder">GitHub Repo</a></li>
-<li><i class="ph ph-globe" aria-label="global"></i> <a href="https://knowcode.com">Website</a></li>
-<li><i class="ph ph-chat-circle" aria-label="chat"></i> <a href="https://github.com/wapdat/doc-builder/discussions">Discussions</a></li>
+<li><i style="font-size: 1.2em" class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
+<li><i style="font-size: 1.2em" class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/wapdat/doc-builder">GitHub Repo</a></li>
+<li><i style="font-size: 1.2em" class="ph ph-globe" aria-label="global"></i> <a href="https://knowcode.com">Website</a></li>
+<li><i style="font-size: 1.2em" class="ph ph-chat-circle" aria-label="chat"></i> <a href="https://github.com/wapdat/doc-builder/discussions">Discussions</a></li>
 </ul>
 </td>
 </tr>
@@ -479,8 +490,8 @@ docBuilder.build({
 <hr>
 <div align="center">
 
-<h3><i class="ph ph-note-pencil" aria-label="edit"></i> License: MIT © KnowCode</h3>
-<p>Built with <i class="ph ph-heart" aria-label="love"></i> by developers, for developers</p>
+<h3><i style="font-size: 1.2em" class="ph ph-note-pencil" aria-label="edit"></i> License: MIT © KnowCode</h3>
+<p>Built with <i style="font-size: 1.2em" class="ph ph-heart" aria-label="love"></i> by developers, for developers</p>
 <p><a href="https://www.npmjs.com/package/@knowcode/doc-builder"><strong>Get Started</strong></a> | <a href="https://doc-builder-delta.vercel.app"><strong>You are looking at a demo</strong></a> | <a href="https://github.com/wapdat/doc-builder"><strong>Star on GitHub</strong></a></p>
 </div>
 

package/html/auth.js

@@ -27,6 +27,10 @@
     // Check authentication and site access
     async function checkAuth() {
         try {
+            // Check authentication mode
+            const isGlobalAuthEnabled = false;
+            const isPrivateDirectoryAuthEnabled = true;
+            
             // Check if current page is in private directory
             const currentPath = window.location.pathname;
             const isPrivatePage = currentPath.includes('/private/');
@@ -35,11 +39,11 @@
             const { data: { user }, error: userError } = await supabaseClient.auth.getUser();
             
             if (userError || !user) {
-                // Only redirect if we're on a private page
-                if (isPrivatePage) {
+                // Redirect if global auth is enabled OR if we're on a private page with private auth enabled
+                if (isGlobalAuthEnabled || (isPrivateDirectoryAuthEnabled && isPrivatePage)) {
                     redirectToLogin();
                 } else {
-                    // Public page, just show it
+                    // Public page (no global auth and either no private auth or not on private page)
                     document.body.classList.add('authenticated'); // Use same class to show body
                     updateAuthButton(false);
                 }
@@ -55,7 +59,7 @@
                 .single();
             
             if (accessError || !access) {
-                if (isPrivatePage) {
+                if (isGlobalAuthEnabled || (isPrivateDirectoryAuthEnabled && isPrivatePage)) {
                     showAccessDenied();
                 } else {
                     // Public page, show it but don't grant private navigation access
@@ -65,15 +69,21 @@
                 return;
             }
             
-            // User is authenticated and has domain access - grant full access including private nav
+            // User is authenticated and has domain access - grant appropriate access
             console.log('User authenticated and authorized');
             document.body.classList.add('authenticated');
-            document.body.classList.add('has-private-access'); // Grant private navigation access
+            
+            // Grant private navigation access if private directory auth is enabled
+            if (isPrivateDirectoryAuthEnabled || isGlobalAuthEnabled) {
+                document.body.classList.add('has-private-access');
+            }
+            
             updateAuthButton(true);
             
         } catch (error) {
             console.error('Auth check failed:', error);
-            if (window.location.pathname.includes('/private/')) {
+            const isPrivatePage = window.location.pathname.includes('/private/');
+            if (isGlobalAuthEnabled || (isPrivateDirectoryAuthEnabled && isPrivatePage)) {
                 redirectToLogin();
             } else {
                 // Public page, show it anyway

package/html/documentation-index.html

@@ -6,6 +6,7 @@
     <meta name="description" content="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose.">
     <title>Documentation Index | @knowcode/doc-builder</title>
     
+    <meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
     <meta name="author" content="Lindsay Smith">
     <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, guide, guides">
     <meta name="robots" content="index, follow">
@@ -98,8 +99,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-29T09:30:31.310Z",
-  "dateModified": "2025-07-29T09:30:31.310Z",
+  "datePublished": "2025-07-31T07:08:27.337Z",
+  "dateModified": "2025-07-31T07:08:27.337Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -132,7 +133,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.5">Last updated: Jul 29, 2025, 09:30 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
                 </div>
                 
                 
@@ -198,6 +199,7 @@
         <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="ph ph-file-text"></i> Authentication Default Change</a>
         <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform."><i class="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
+        <a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration 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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
         <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
         <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
@@ -208,6 +210,7 @@
         <a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
         <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
+        <a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete 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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
         <a href="/guides/windows-setup-guide.html" class="nav-item" data-tooltip="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel."><i class="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
       <div class="nav-section private-nav" data-level="1">
@@ -239,6 +242,7 @@
           <i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
         </a>
         <div class="nav-content collapsed" id="nav-prompts-1">
+        <a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
         <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
             </nav>
             <div class="resize-handle"></div>
@@ -265,7 +269,7 @@
     └── troubleshooting-guide.md # Common issues and solutions
 </code></pre>
 <h2>Documentation Categories</h2>
-<h3><i class="ph ph-books" aria-label="documentation"></i> Core Documentation</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-books" aria-label="documentation"></i> Core Documentation</h3>
 <table>
 <thead>
 <tr>
@@ -290,7 +294,7 @@
 <td>Claude Code integration guide</td>
 </tr>
 </tbody></table>
-<h3><i class="ph ph-book-open" aria-label="reading"></i> Guides</h3>
+<h3><i style="font-size: 1.2em" class="ph ph-book-open" aria-label="reading"></i> Guides</h3>
 <table>
 <thead>
 <tr>
@@ -305,6 +309,11 @@
 <td>How to write docs for this project</td>
 </tr>
 <tr>
+<td>Configuration Guide</td>
+<td><a href="./guides/configuration-guide.md">guides/configuration-guide.md</a></td>
+<td>Config file management and auto-updates</td>
+</tr>
+<tr>
 <td>Authentication Guide</td>
 <td><a href="./guides/authentication-guide.md">guides/authentication-guide.md</a></td>
 <td>Setting up password protection</td>

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

@@ -6,6 +6,7 @@
     <meta name="description" content="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites. This change makes it easier to deploy...">
     <title>Authentication Default Change | @knowcode/doc-builder</title>
     
+    <meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
     <meta name="author" content="Lindsay Smith">
     <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, authentication, public">
     <meta name="robots" content="index, follow">
@@ -98,8 +99,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-29T09:30:31.314Z",
-  "dateModified": "2025-07-29T09:30:31.314Z",
+  "datePublished": "2025-07-31T07:08:27.341Z",
+  "dateModified": "2025-07-31T07:08:27.341Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-default-change.html"
@@ -138,7 +139,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.5">Last updated: Jul 29, 2025, 09:30 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
                 </div>
                 
                 
@@ -204,6 +205,7 @@
         <a href="/guides/authentication-default-change.html" class="nav-item active" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="ph ph-file-text"></i> Authentication Default Change</a>
         <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform."><i class="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
+        <a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration 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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
         <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
         <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
@@ -214,6 +216,7 @@
         <a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
         <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
+        <a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete 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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
         <a href="/guides/windows-setup-guide.html" class="nav-item" data-tooltip="This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel."><i class="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
       <div class="nav-section private-nav" data-level="1">
@@ -245,6 +248,7 @@
           <i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
         </a>
         <div class="nav-content collapsed" id="nav-prompts-1">
+        <a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
         <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
             </nav>
             <div class="resize-handle"></div>