@knowcode/doc-builder 1.7.6 → 1.8.0

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

@@ -65,8 +65,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-25T13:49:06.580Z",
-  "dateModified": "2025-07-25T13:49:06.580Z",
+  "datePublished": "2025-07-26T09:59:23.016Z",
+  "dateModified": "2025-07-26T09:59:23.016Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -99,7 +99,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.7.5">Last updated: Jul 25, 2025, 01:49 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 09:59 AM UTC</span>
                 </div>
                 
                 
@@ -158,31 +158,17 @@
         </a>
         <div class="nav-content collapsed" id="nav-guides-1">
         <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/authentication-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase - a secure, scalable authentication platform."><i class="fas fa-file-alt"></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="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/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/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" href="/launch/README.html" data-target="nav-launch-1" >
-          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
-        </a>
-        <div class="nav-content collapsed" id="nav-launch-1">
-        <a href="/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
-        <a href="/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
-        <a href="/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy &amp; Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
-        <a href="/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a></div></div>
             </nav>
             <div class="resize-handle"></div>
         </aside>

package/lib/config.js

@@ -303,6 +303,30 @@ async function loadConfig(configPath, options = {}) {
       console.log(chalk.gray(`Create it with: mkdir ${config.docsDir} && echo "# Documentation" > ${config.docsDir}/README.md`));
     }
     // Don't throw error - let commands handle missing directories appropriately
+  } else {
+    // 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;
+        }
+      }
+    }
   }
   
   return config;

package/lib/core-builder.js

@@ -362,6 +362,21 @@ ${seoTags}
         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>
     ` : ''}
     
@@ -389,8 +404,8 @@ ${seoTags}
                 </div>
                 
                 ${config.features?.authentication === 'supabase' ? `
-                <a href="${relativePath}logout.html" class="logout-btn" title="Logout">
-                    <i class="fas fa-sign-out-alt"></i>
+                <a href="${relativePath}login.html" class="auth-btn" title="Login/Logout">
+                    <i class="fas fa-sign-in-alt"></i>
                 </a>
                 ` : ''}
                 
@@ -484,10 +499,23 @@ const folderDescriptions = {
 };
 
 // Build navigation structure with rich functionality
-function buildNavigationStructure(files, currentFile) {
+function buildNavigationStructure(files, currentFile, config = {}) {
   const tree = { files: [], folders: {} };
   
+  // Check if authentication is enabled
+  const isAuthEnabled = config.features?.authentication === 'supabase';
+  
+  // Filter files based on authentication status and whether we're building for an authenticated page
+  // We'll pass a flag from processMarkdownFile to indicate if this is a private page
+  const isPrivatePage = currentFile && (currentFile.startsWith('private/') || currentFile.includes('/private/'));
+  const shouldIncludePrivate = isAuthEnabled && isPrivatePage;
+  
   files.forEach(file => {
+    // Skip private files if we're not on an authenticated page
+    if (file.isPrivate && !shouldIncludePrivate) {
+      return;
+    }
+    
     const parts = file.urlPath.split('/');
     let current = tree;
     
@@ -704,8 +732,8 @@ async function processMarkdownFile(filePath, outputPath, allFiles, config) {
   // Process content
   const htmlContent = processMarkdownContent(content, config);
   
-  // Build navigation
-  const navigation = buildNavigationStructure(allFiles, urlPath);
+  // Build navigation - pass config to handle private file filtering
+  const navigation = buildNavigationStructure(allFiles, urlPath, config);
   
   // Generate full HTML (pass original content and front matter for SEO)
   const html = generateHTML(title, htmlContent, navigation, urlPath, config, content, frontMatter);
@@ -740,12 +768,18 @@ async function getAllMarkdownFiles(dir, baseDir = dir) {
       const content = await fs.readFile(fullPath, 'utf-8');
       const summary = extractSummary(content);
       
+      // Check if this file is in the private directory
+      const isPrivate = relativePath.split(path.sep)[0] === 'private' || 
+                       relativePath.startsWith('private/') || 
+                       relativePath.startsWith('private\\');
+      
       files.push({
         path: fullPath,
         relativePath,
         urlPath,
         displayName,
-        summary
+        summary,
+        isPrivate
       });
     }
   }

package/lib/supabase-auth.js

@@ -58,11 +58,22 @@ class SupabaseAuth {
     // Check authentication and site access
     async function checkAuth() {
         try {
+            // Check if current page is in private directory
+            const currentPath = window.location.pathname;
+            const isPrivatePage = currentPath.includes('/private/');
+            
             // Get current user session
             const { data: { user }, error: userError } = await supabaseClient.auth.getUser();
             
             if (userError || !user) {
-                redirectToLogin();
+                // Only redirect if we're on a private page
+                if (isPrivatePage) {
+                    redirectToLogin();
+                } else {
+                    // Public page, just show it
+                    document.body.classList.add('authenticated'); // Use same class to show body
+                    updateAuthButton(false);
+                }
                 return;
             }
             
@@ -75,17 +86,30 @@ class SupabaseAuth {
                 .single();
             
             if (accessError || !access) {
-                showAccessDenied();
+                if (isPrivatePage) {
+                    showAccessDenied();
+                } else {
+                    // Public page, just show it
+                    document.body.classList.add('authenticated');
+                    updateAuthButton(false);
+                }
                 return;
             }
             
             // User is authenticated and has access
             console.log('User authenticated and authorized');
             document.body.classList.add('authenticated');
+            updateAuthButton(true);
             
         } catch (error) {
             console.error('Auth check failed:', error);
-            redirectToLogin();
+            if (window.location.pathname.includes('/private/')) {
+                redirectToLogin();
+            } else {
+                // Public page, show it anyway
+                document.body.classList.add('authenticated');
+                updateAuthButton(false);
+            }
         }
     }
     
@@ -110,16 +134,41 @@ class SupabaseAuth {
         \`;
     }
     
-    // Add logout functionality
+    // Function to update auth button
+    function updateAuthButton(isAuthenticated) {
+        const authBtn = document.querySelector('.auth-btn');
+        if (authBtn) {
+            const icon = authBtn.querySelector('i');
+            if (icon) {
+                if (isAuthenticated) {
+                    icon.className = 'fas fa-sign-out-alt';
+                    authBtn.title = 'Logout';
+                    authBtn.href = '/logout.html';
+                } else {
+                    icon.className = 'fas fa-sign-in-alt';
+                    authBtn.title = 'Login';
+                    authBtn.href = '/login.html';
+                }
+            }
+        }
+    }
+    
+    // Add auth button 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';
+        const authBtn = document.querySelector('.auth-btn');
+        if (authBtn) {
+            authBtn.addEventListener('click', async function(e) {
+                // Check if we're logged in
+                const { data: { user } } = await supabaseClient.auth.getUser();
+                if (user) {
+                    // Logged in - sign out
+                    e.preventDefault();
+                    await supabaseClient.auth.signOut();
+                    window.location.href = '/logout.html';
+                }
+                // If not logged in, normal navigation to login page will occur
             });
-        });
+        }
     });
     
     // Run auth check

package/package.json

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

package/user-management/README.md

@@ -0,0 +1,81 @@
+# User Management for Doc-Builder Sites
+
+This directory contains a simple scripted solution for managing user access to Supabase-authenticated documentation sites.
+
+## Quick Start
+
+```bash
+# List all documentation sites
+./add-users.sh sites
+
+# Add a single user to a site
+./add-users.sh add wru-bid-analysis.vercel.app john@example.com
+
+# Add multiple users from a file
+./add-users.sh bulk wru-bid-analysis.vercel.app users.txt
+
+# List all users with access to a site
+./add-users.sh list wru-bid-analysis.vercel.app
+
+# Check if a user has access
+./add-users.sh check wru-bid-analysis.vercel.app john@example.com
+
+# Remove user access
+./add-users.sh remove wru-bid-analysis.vercel.app john@example.com
+```
+
+## How It Works
+
+1. The script generates SQL commands based on your input
+2. Copy the generated SQL and run it in the Supabase SQL Editor
+3. For new users, you'll need to create them in Supabase Dashboard first
+
+## Files
+
+- `add-users.sh` - Main user management script
+- `users.txt` - Example file for bulk user additions
+- `USER-MANAGEMENT.md` - This documentation
+
+## Important URLs
+
+- Supabase SQL Editor: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/sql
+- Supabase User Management: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
+
+## Workflow for Adding New Users
+
+1. First check if the user exists:
+   ```bash
+   ./add-users.sh check site-url user@email.com
+   ```
+
+2. If the user doesn't exist:
+   - Go to Supabase Dashboard > Authentication > Users
+   - Click "Invite user"
+   - Enter the email address
+   - They'll receive an email to set their password
+
+3. Grant access to the site:
+   ```bash
+   ./add-users.sh add site-url user@email.com
+   ```
+   Copy and run the generated SQL
+
+4. Verify access was granted:
+   ```bash
+   ./add-users.sh list site-url
+   ```
+
+## Bulk User Addition
+
+1. Edit `users.txt` with one email per line
+2. Run: `./add-users.sh bulk site-url users.txt`
+3. The script will generate SQL for all users
+4. Create any missing users in Supabase first
+5. Run the SQL to grant access
+
+## Notes
+
+- Site URLs should be without the `https://` prefix
+- Users must exist in Supabase before you can grant them access
+- The script only generates SQL - you need to run it manually
+- This gives you a chance to review before making changes