@knowcode/doc-builder 1.8.0 → 1.8.1

package/html/sitemap.xml

@@ -2,259 +2,259 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://doc-builder-delta.vercel.app/404.html</loc>
-    <lastmod>2025-07-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/README.html</loc>
-    <lastmod>2025-07-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</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-26T09:59:23.023Z</lastmod>
+    <lastmod>2025-07-26T10:20:52.454Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

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

@@ -46,6 +46,39 @@
     <link rel="stylesheet" href="/css/notion-style.css">
     
     
+    <!-- Hide content until auth check -->
+    <style>
+      body { 
+        visibility: hidden; 
+        opacity: 0; 
+        transition: opacity 0.3s ease;
+      }
+      body.authenticated { 
+        visibility: visible; 
+        opacity: 1; 
+      }
+      /* Show login/logout pages immediately */
+      body.auth-page {
+        visibility: visible;
+        opacity: 1;
+      }
+      /* Style auth button consistently */
+      .auth-btn {
+        background: none;
+        border: none;
+        color: var(--text-secondary);
+        cursor: pointer;
+        padding: 0.5rem;
+        border-radius: 0.5rem;
+        transition: all 0.2s;
+        font-size: 1.1rem;
+      }
+      .auth-btn:hover {
+        background: var(--bg-secondary);
+        color: var(--text-primary);
+      }
+    </style>
+    
     
     <!-- 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>">
@@ -65,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T09:59:23.014Z",
-  "dateModified": "2025-07-26T09:59:23.014Z",
+  "datePublished": "2025-07-26T10:20:52.444Z",
+  "dateModified": "2025-07-26T10:20:52.444Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -99,10 +132,14 @@
             
             <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, 09:59 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 10:20 AM UTC</span>
                 </div>
                 
                 
+                <a href="../login.html" class="auth-btn" title="Login/Logout">
+                    <i class="fas fa-sign-in-alt"></i>
+                </a>
+                
                 
                 <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
                     <i class="fas fa-moon"></i>
@@ -162,7 +199,7 @@
         <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/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/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder now includes automatic authentication for documents placed in a directory."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
+        <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder provides flexible authentication options to protect your documentation."><i class="fas fa-file-alt"></i> Private Directory Authentication</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>
@@ -408,6 +445,7 @@ vercel --scope team-name
     };
     </script>
     <script src="/js/main.js"></script>
-    
+    <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
+    <script src="/js/auth.js"></script>
 </body>
 </html>

package/html/vercel-first-time-setup-guide.html

@@ -46,6 +46,39 @@
     <link rel="stylesheet" href="/css/notion-style.css">
     
     
+    <!-- Hide content until auth check -->
+    <style>
+      body { 
+        visibility: hidden; 
+        opacity: 0; 
+        transition: opacity 0.3s ease;
+      }
+      body.authenticated { 
+        visibility: visible; 
+        opacity: 1; 
+      }
+      /* Show login/logout pages immediately */
+      body.auth-page {
+        visibility: visible;
+        opacity: 1;
+      }
+      /* Style auth button consistently */
+      .auth-btn {
+        background: none;
+        border: none;
+        color: var(--text-secondary);
+        cursor: pointer;
+        padding: 0.5rem;
+        border-radius: 0.5rem;
+        transition: all 0.2s;
+        font-size: 1.1rem;
+      }
+      .auth-btn:hover {
+        background: var(--bg-secondary);
+        color: var(--text-primary);
+      }
+    </style>
+    
     
     <!-- 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>">
@@ -65,8 +98,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-26T09:59:23.016Z",
-  "dateModified": "2025-07-26T09:59:23.016Z",
+  "datePublished": "2025-07-26T10:20:52.446Z",
+  "dateModified": "2025-07-26T10:20:52.446Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -99,10 +132,14 @@
             
             <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, 09:59 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 10:20 AM UTC</span>
                 </div>
                 
                 
+                <a href="../login.html" class="auth-btn" title="Login/Logout">
+                    <i class="fas fa-sign-in-alt"></i>
+                </a>
+                
                 
                 <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
                     <i class="fas fa-moon"></i>
@@ -162,7 +199,7 @@
         <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/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/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder now includes automatic authentication for documents placed in a directory."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
+        <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder provides flexible authentication options to protect your documentation."><i class="fas fa-file-alt"></i> Private Directory Authentication</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>
@@ -367,6 +404,7 @@
     };
     </script>
     <script src="/js/main.js"></script>
-    
+    <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
+    <script src="/js/auth.js"></script>
 </body>
 </html>

package/lib/config.js

@@ -264,9 +264,8 @@ async function loadConfig(configPath, options = {}) {
   if (options.output) {
     config.outputDir = options.output;
   }
-  if (options.auth === false) {
-    config.features.authentication = false;
-  }
+  // Note: We don't apply auth=false here anymore because private directory detection
+  // should always override to ensure security
   if (options.changelog === false) {
     config.features.changelog = false;
     config.changelog.enabled = false;
@@ -307,24 +306,19 @@ async function loadConfig(configPath, options = {}) {
     // Check for private directory and auto-enable authentication if found
     const privatePath = path.join(docsPath, 'private');
     if (fs.existsSync(privatePath) && fs.statSync(privatePath).isDirectory()) {
-      // Only auto-enable if not already configured
-      if (!config.features.authentication) {
-        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. Private directory found but authentication will not work.'));
-          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.warn(chalk.yellow(''));
-          console.warn(chalk.yellow('   Or disable authentication by removing the private directory.'));
-          // Disable authentication if credentials are missing
-          config.features.authentication = false;
-        }
+      // Auto-enable authentication when private directory exists
+      // This overrides any config setting to ensure private directories are always protected
+      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'));
       }
     }
   }

package/lib/core-builder.js

@@ -1192,8 +1192,15 @@ 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
+  const authConfig = {
+    supabaseUrl: config.auth.supabaseUrl || 'https://placeholder.supabase.co',
+    supabaseAnonKey: config.auth.supabaseAnonKey || 'placeholder-key',
+    siteId: config.auth.siteId || 'placeholder-site-id'
+  };
+
   // Create Supabase auth instance
-  const supabaseAuth = new SupabaseAuth(config.auth);
+  const supabaseAuth = new SupabaseAuth(authConfig);
 
   // Generate auth script and save to js/auth.js
   const authScript = supabaseAuth.generateAuthScript();
@@ -1213,6 +1220,7 @@ async function generateSupabaseAuthFiles(outputDir, config) {
   console.log(chalk.green('✓ Generated Supabase authentication files'));
 }
 
+
 // Create default index page when no documentation exists
 async function createDefaultIndexPage(outputDir, config, version) {
   const siteName = config.siteName || 'Documentation';

package/lib/supabase-auth.js

@@ -320,21 +320,27 @@ class SupabaseAuth {
   static validateConfig(config) {
     const errors = [];
     
-    if (!config.auth.supabaseUrl) {
-      errors.push('auth.supabaseUrl is required');
-    }
-    
-    if (!config.auth.supabaseAnonKey) {
-      errors.push('auth.supabaseAnonKey is required');
-    }
-    
-    if (!config.auth.siteId) {
-      errors.push('auth.siteId is required');
-    }
+    // 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;
     
-    // 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)');
+    if (hasAnyCredential) {
+      if (!config.auth.supabaseUrl) {
+        errors.push('auth.supabaseUrl is required');
+      }
+      
+      if (!config.auth.supabaseAnonKey) {
+        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)');
+      }
     }
     
     return errors;

package/package.json

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