@knowcode/doc-builder 1.7.5 → 1.8.0

package/.claude/settings.local.json

@@ -34,7 +34,9 @@
       "Bash(pkill:*)",
       "Bash(curl:*)",
       "Bash(./cli.js build:*)",
-      "Bash(./cli.js deploy:*)"
+      "Bash(./cli.js deploy:*)",
+      "Bash(./add-users.sh:*)",
+      "Bash(python3:*)"
     ],
     "deny": []
   }

package/CHANGELOG.md

@@ -5,6 +5,60 @@ 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.8.0] - 2025-07-26
+
+### Added
+- **Automatic Private Directory Authentication**: Simply create a `docs/private/` folder to enable authentication
+- Private documents are completely hidden from unauthenticated users
+- Unified login/logout button that dynamically changes icon based on authentication state
+- Smart navigation filtering - private files only shown on authenticated pages
+- Comprehensive guide for private directory authentication feature
+
+### Changed
+- Navigation building now filters files based on authentication status
+- Auth button replaces separate logout button for cleaner UI
+- Public pages remain accessible even when authentication is enabled
+- Authentication script only redirects on private pages, not public ones
+
+### How it Works
+- Create a `docs/private/` directory and authentication is automatically enabled
+- Private documents don't appear in navigation for unauthenticated users
+- Attempting to access private URLs directly redirects to login
+- After login, users see complete navigation including private sections
+- Zero configuration required - just organize your files
+
+## [1.7.6] - 2025-07-25
+
+### Added
+- **Attachment Support**: Automatically copy Excel files, PDFs, and other attachments to deployment
+- New configuration option `features.attachments` (enabled by default)
+- Configurable `attachmentTypes` array for supported file extensions
+- `--no-attachments` flag for build and deploy commands to disable attachment copying
+- Support for preserving directory structure when copying attachments
+- Comprehensive file type support including:
+  - Documents: PDF, Excel, Word, PowerPoint, CSV, RTF
+  - Archives: ZIP, TAR, GZ, 7Z, RAR
+  - Images: PNG, JPG, JPEG, GIF, SVG, WEBP, ICO, BMP
+  - Data files: JSON, XML, YAML, YML, TOML
+  - Media: MP4, MP3, WAV, AVI, MOV
+
+### How it Works
+- During build, doc-builder scans for attachment files in your docs directory
+- Files with supported extensions are automatically copied to the output directory
+- Directory structure is preserved (e.g., `docs/data/report.xlsx` → `html/data/report.xlsx`)
+- Links in markdown files to these attachments will work seamlessly in the deployed site
+- Feature is enabled by default but can be disabled with `--no-attachments` flag
+
+### Configuration
+```javascript
+features: {
+  attachments: true  // Enable/disable attachment copying
+},
+attachmentTypes: [
+  '.pdf', '.xlsx', '.docx', // ... etc
+]
+```
+
 ## [1.7.5] - 2025-07-25
 
 ### Changed

package/README.md

@@ -77,6 +77,7 @@ This aligns perfectly with our mission: beautiful documentation should be access
 - 🌙 **Dark Mode** - Automatic theme switching
 - ☁️ **Vercel Deploy** - One-command deployment
 - ✅ **Google Verification** - Search Console ready
+- 📎 **Attachment Support** - Excel, PDF & more deploy with docs
 
 </td>
 </tr>
@@ -213,7 +214,8 @@ module.exports = {
     authentication: 'supabase',  // or false for no auth
     changelog: true,
     mermaid: true,
-    darkMode: true
+    darkMode: true,
+    attachments: true           // Copy PDFs, Excel files, etc. (default: true)
   },
   
   // Supabase Authentication
@@ -242,6 +244,23 @@ 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.
 
+### 📎 Attachment Support
+
+doc-builder automatically copies attachment files (Excel, PDF, images, etc.) to your deployment:
+
+- **Enabled by default** - No configuration needed
+- **Preserves directory structure** - Files maintain their relative paths
+- **Supported file types**:
+  - Documents: `.pdf`, `.doc`, `.docx`, `.xls`, `.xlsx`, `.csv`, `.ppt`, `.pptx`
+  - Images: `.png`, `.jpg`, `.jpeg`, `.gif`, `.svg`, `.webp`
+  - Archives: `.zip`, `.tar`, `.gz`, `.7z`, `.rar`
+  - Data files: `.json`, `.xml`, `.yaml`, `.yml`
+  - And more...
+
+**Example**: If you have `docs/data/report.xlsx`, it will be copied to `html/data/report.xlsx` and links like `[Download Report](data/report.xlsx)` will work perfectly.
+
+To disable attachment copying, use the `--no-attachments` flag with build or deploy commands.
+
 ## 📋 Commands Overview
 
 <table>
@@ -292,11 +311,13 @@ Options:
   -o, --output <dir>   Output directory (default: html)
   --preset <preset>    Use a preset configuration
   --no-changelog      Disable changelog generation
+  --no-attachments    Disable copying of attachment files
 
 Examples:
   doc-builder build                          # Build with defaults
   doc-builder build --input docs --output dist
   doc-builder build --preset notion-inspired
+  doc-builder build --no-attachments         # Build without copying PDFs, Excel files, etc.
 ```
 </details>
 
@@ -311,11 +332,13 @@ Options:
   --no-prod              Deploy as preview
   --force                Force without confirmation
   --production-url <url> Override production URL
+  --no-attachments       Disable copying of attachment files
 
 Examples:
   doc-builder deploy                    # Deploy to production
   doc-builder deploy --no-prod          # Deploy as preview
   doc-builder deploy --production-url my-docs.vercel.app
+  doc-builder deploy --no-attachments  # Deploy without attachment files
 ```
 </details>
 

package/add-user-clive.sql

@@ -0,0 +1,35 @@
+-- =====================================================
+-- ADD SINGLE USER: clive@hyperforma.co.uk
+-- Site: https://wru-bid-analysis.vercel.app/
+-- =====================================================
+
+-- STEP 1: Check if clive@hyperforma.co.uk exists
+SELECT email, id, created_at, last_sign_in_at
+FROM auth.users 
+WHERE email = 'clive@hyperforma.co.uk';
+
+-- If NO RESULTS above, create the user:
+-- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
+-- 2. Click "Invite user"
+-- 3. Enter: clive@hyperforma.co.uk
+-- 4. Click "Send invitation"
+
+-- STEP 2: After user is created, grant access
+INSERT INTO docbuilder_access (user_id, site_id)
+VALUES (
+    (SELECT id FROM auth.users WHERE email = 'clive@hyperforma.co.uk'),
+    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+)
+ON CONFLICT (user_id, site_id) DO NOTHING;
+
+-- STEP 3: Verify access was granted
+SELECT 
+    u.email,
+    u.id as user_id,
+    da.created_at as access_granted,
+    ds.domain as site_domain
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+JOIN docbuilder_sites ds ON ds.id = da.site_id
+WHERE u.email = 'clive@hyperforma.co.uk'
+AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-user-lindsay-fixed.sql

@@ -0,0 +1,85 @@
+-- =====================================================
+-- ADD SINGLE USER: lindsay@knowcode.tech
+-- Site: https://wru-bid-analysis.vercel.app/
+-- =====================================================
+
+-- STEP 1: Update domain (only run once - you've already done this)
+-- UPDATE docbuilder_sites 
+-- SET domain = 'wru-bid-analysis.vercel.app',
+--     name = 'WRU Bid Analysis Documentation'
+-- WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- =====================================================
+-- STEP 2: CHECK IF USER EXISTS (RUN THIS FIRST!)
+-- =====================================================
+SELECT email, id, created_at 
+FROM auth.users 
+WHERE email = 'lindsay@knowcode.tech';
+
+-- ⚠️ IF THE ABOVE QUERY RETURNS NO ROWS, YOU MUST CREATE THE USER FIRST!
+
+-- =====================================================
+-- STEP 3: CREATE USER IN SUPABASE (if not exists)
+-- =====================================================
+-- Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
+-- 1. Click the "Invite user" button
+-- 2. Enter email: lindsay@knowcode.tech
+-- 3. Click "Send invitation"
+-- 4. User will receive email to set password
+-- 5. WAIT for user to appear in the auth.users table before continuing!
+
+-- =====================================================
+-- STEP 4: VERIFY USER NOW EXISTS
+-- =====================================================
+-- Run this again to get the user ID:
+SELECT email, id 
+FROM auth.users 
+WHERE email = 'lindsay@knowcode.tech';
+
+-- Copy the ID from above (it will look like: 123e4567-e89b-12d3-a456-426614174000)
+
+-- =====================================================
+-- STEP 5: GRANT ACCESS (only after user exists!)
+-- =====================================================
+-- Option A: If Step 4 returned a user, run this:
+INSERT INTO docbuilder_access (user_id, site_id)
+SELECT 
+    u.id,
+    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+FROM auth.users u
+WHERE u.email = 'lindsay@knowcode.tech'
+AND EXISTS (
+    SELECT 1 FROM auth.users WHERE email = 'lindsay@knowcode.tech'
+);
+
+-- Option B: If you have the user ID from Step 4, use it directly:
+-- INSERT INTO docbuilder_access (user_id, site_id)
+-- VALUES (
+--     'paste-user-id-here',
+--     '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+-- );
+
+-- =====================================================
+-- STEP 6: VERIFY ACCESS WAS GRANTED
+-- =====================================================
+SELECT 
+    u.email,
+    u.id as user_id,
+    da.created_at as access_granted
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+WHERE u.email = 'lindsay@knowcode.tech';
+
+-- =====================================================
+-- TROUBLESHOOTING
+-- =====================================================
+-- If you still get errors, check:
+-- 1. Does the user exist? 
+SELECT COUNT(*) as user_exists FROM auth.users WHERE email = 'lindsay@knowcode.tech';
+
+-- 2. Do they already have access?
+SELECT COUNT(*) as has_access 
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+WHERE u.email = 'lindsay@knowcode.tech' 
+AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-user-lindsay.sql

@@ -0,0 +1,68 @@
+-- =====================================================
+-- ADD SINGLE USER: lindsay@knowcode.tech
+-- Site: https://wru-bid-analysis.vercel.app/
+-- =====================================================
+
+-- STEP 1: Update domain (only run once)
+UPDATE docbuilder_sites 
+SET domain = 'wru-bid-analysis.vercel.app',
+    name = 'WRU Bid Analysis Documentation'
+WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- Verify domain is correct
+SELECT id, domain, name FROM docbuilder_sites 
+WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- =====================================================
+-- STEP 2: Check if lindsay@knowcode.tech exists
+-- =====================================================
+SELECT email, id, created_at, last_sign_in_at
+FROM auth.users 
+WHERE email = 'lindsay@knowcode.tech';
+
+-- If NO RESULTS above, create the user:
+-- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
+-- 2. Click "Invite user"
+-- 3. Enter: lindsay@knowcode.tech
+-- 4. Click "Send invitation"
+
+-- =====================================================
+-- STEP 3: After user is created, grant access
+-- =====================================================
+-- Run this AFTER the user exists in Supabase
+INSERT INTO docbuilder_access (user_id, site_id)
+VALUES (
+    (SELECT id FROM auth.users WHERE email = 'lindsay@knowcode.tech'),
+    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+)
+ON CONFLICT (user_id, site_id) DO NOTHING;
+
+-- =====================================================
+-- STEP 4: Verify access was granted
+-- =====================================================
+SELECT 
+    u.email,
+    u.id as user_id,
+    da.created_at as access_granted,
+    ds.domain as site_domain
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+JOIN docbuilder_sites ds ON ds.id = da.site_id
+WHERE u.email = 'lindsay@knowcode.tech'
+AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- Should show:
+-- email: lindsay@knowcode.tech
+-- access_granted: (timestamp)
+-- site_domain: wru-bid-analysis.vercel.app
+
+-- =====================================================
+-- TROUBLESHOOTING
+-- =====================================================
+-- If access wasn't granted, check for errors:
+SELECT id, email FROM auth.users WHERE email = 'lindsay@knowcode.tech';
+
+-- If user can't log in after getting access:
+-- 1. Clear browser cache
+-- 2. Check they're using correct URL: https://wru-bid-analysis.vercel.app/
+-- 3. Verify they set their password from invite email

package/add-user-pmorgan.sql

@@ -0,0 +1,35 @@
+-- =====================================================
+-- ADD SINGLE USER: pmorgan@wru.cymru
+-- Site: https://wru-bid-analysis.vercel.app/
+-- =====================================================
+
+-- STEP 1: Check if pmorgan@wru.cymru exists
+SELECT email, id, created_at, last_sign_in_at
+FROM auth.users 
+WHERE email = 'pmorgan@wru.cymru';
+
+-- If NO RESULTS above, create the user:
+-- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
+-- 2. Click "Invite user"
+-- 3. Enter: pmorgan@wru.cymru
+-- 4. Click "Send invitation"
+
+-- STEP 2: After user is created, grant access
+INSERT INTO docbuilder_access (user_id, site_id)
+VALUES (
+    (SELECT id FROM auth.users WHERE email = 'pmorgan@wru.cymru'),
+    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+)
+ON CONFLICT (user_id, site_id) DO NOTHING;
+
+-- STEP 3: Verify access was granted
+SELECT 
+    u.email,
+    u.id as user_id,
+    da.created_at as access_granted,
+    ds.domain as site_domain
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+JOIN docbuilder_sites ds ON ds.id = da.site_id
+WHERE u.email = 'pmorgan@wru.cymru'
+AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-user-robbie.sql

@@ -0,0 +1,35 @@
+-- =====================================================
+-- ADD SINGLE USER: robbie.macintosh@marbledropper.com
+-- Site: https://wru-bid-analysis.vercel.app/
+-- =====================================================
+
+-- STEP 1: Check if robbie.macintosh@marbledropper.com exists
+SELECT email, id, created_at, last_sign_in_at
+FROM auth.users 
+WHERE email = 'robbie.macintosh@marbledropper.com';
+
+-- If NO RESULTS above, create the user:
+-- 1. Go to: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka/auth/users
+-- 2. Click "Invite user"
+-- 3. Enter: robbie.macintosh@marbledropper.com
+-- 4. Click "Send invitation"
+
+-- STEP 2: After user is created, grant access
+INSERT INTO docbuilder_access (user_id, site_id)
+VALUES (
+    (SELECT id FROM auth.users WHERE email = 'robbie.macintosh@marbledropper.com'),
+    '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+)
+ON CONFLICT (user_id, site_id) DO NOTHING;
+
+-- STEP 3: Verify access was granted
+SELECT 
+    u.email,
+    u.id as user_id,
+    da.created_at as access_granted,
+    ds.domain as site_domain
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+JOIN docbuilder_sites ds ON ds.id = da.site_id
+WHERE u.email = 'robbie.macintosh@marbledropper.com'
+AND da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';

package/add-wru-users.sql

@@ -0,0 +1,105 @@
+-- =====================================================
+-- ADD USERS TO WRU BID ANALYSIS DOCUMENTATION
+-- Site: https://wru-bid-analysis.vercel.app/
+-- Date: 2025-07-25
+-- =====================================================
+
+-- STEP 1: Update the domain to match your Vercel deployment
+UPDATE docbuilder_sites 
+SET domain = 'wru-bid-analysis.vercel.app',
+    name = 'WRU Bid Analysis Documentation'
+WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- Verify the domain update
+SELECT id, domain, name FROM docbuilder_sites 
+WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- =====================================================
+-- STEP 2: CHECK IF USERS EXIST
+-- =====================================================
+-- Run this first to see which users already exist
+SELECT email, id, created_at 
+FROM auth.users 
+WHERE email IN (
+    'pmorgan@wru.cymru',
+    'clive@hyperforma.co.uk',
+    'robbie.macintosh@marbledropper.com',
+    'lindsay@knowcode.tech'
+);
+
+-- =====================================================
+-- IMPORTANT: CREATE MISSING USERS FIRST!
+-- =====================================================
+-- For any users that don't exist above:
+-- 1. Go to Supabase Dashboard: https://supabase.com/dashboard/project/xcihhnfcitjrwbynxmka
+-- 2. Navigate to Authentication → Users
+-- 3. Click "Invite user" 
+-- 4. Enter each missing email address
+-- 5. They'll receive an email to set their password
+
+-- =====================================================
+-- STEP 3: GRANT ACCESS TO ALL USERS
+-- =====================================================
+-- Run this after all users have been created
+WITH users_to_add AS (
+    SELECT email FROM (VALUES 
+        ('pmorgan@wru.cymru'),
+        ('clive@hyperforma.co.uk'),
+        ('robbie.macintosh@marbledropper.com'),
+        ('lindsay@knowcode.tech')
+    ) AS t(email)
+)
+INSERT INTO docbuilder_access (user_id, site_id)
+SELECT u.id, '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+FROM auth.users u
+JOIN users_to_add ua ON u.email = ua.email
+WHERE NOT EXISTS (
+    -- This prevents duplicate entries if someone already has access
+    SELECT 1 FROM docbuilder_access 
+    WHERE user_id = u.id AND site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+);
+
+-- =====================================================
+-- STEP 4: VERIFY ACCESS WAS GRANTED
+-- =====================================================
+-- Check who now has access to the site
+SELECT 
+    u.email,
+    u.created_at as user_created,
+    da.created_at as access_granted,
+    CASE 
+        WHEN u.last_sign_in_at IS NULL THEN 'Never logged in'
+        ELSE 'Has logged in'
+    END as login_status
+FROM docbuilder_access da
+JOIN auth.users u ON u.id = da.user_id
+WHERE da.site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+ORDER BY da.created_at DESC;
+
+-- =====================================================
+-- TROUBLESHOOTING
+-- =====================================================
+
+-- If someone can't log in, check if they exist:
+SELECT * FROM auth.users WHERE email = 'user@example.com';
+
+-- If someone still can't access after login, verify their access:
+SELECT * FROM docbuilder_access 
+WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com')
+AND site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- To remove a user's access:
+-- DELETE FROM docbuilder_access
+-- WHERE user_id = (SELECT id FROM auth.users WHERE email = 'user@example.com')
+-- AND site_id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+
+-- =====================================================
+-- USERS BEING ADDED:
+-- =====================================================
+-- 1. pmorgan@wru.cymru
+-- 2. clive@hyperforma.co.uk
+-- 3. robbie.macintosh@marbledropper.com
+-- 4. lindsay@knowcode.tech
+--
+-- Site URL: https://wru-bid-analysis.vercel.app/
+-- Site ID: 4d8a53bf-dcdd-48c0-98e0-cd1451518735

package/assets/css/notion-style.css

@@ -289,7 +289,8 @@ pre code {
   }
 }
 
-.logout-btn {
+.logout-btn,
+.auth-btn {
   background: none;
   border: none;
   font-size: var(--text-lg);
@@ -312,6 +313,13 @@ pre code {
   transform: translateY(-1px);
 }
 
+.auth-btn:hover {
+  background: var(--color-bg-tertiary);
+  opacity: 1;
+  color: var(--color-text-primary);
+  transform: translateY(-1px);
+}
+
 /* Sidebar */
 .sidebar {
   position: relative;

package/cli.js

@@ -75,6 +75,7 @@ program
   .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)')
+  .option('--no-attachments', 'skip copying attachment files (Excel, PDF, etc.)')
   .addHelpText('after', `
 ${chalk.yellow('Examples:')}
   ${chalk.gray('$')} doc-builder build                        ${chalk.gray('# Build with defaults')}
@@ -606,6 +607,7 @@ program
   .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)')
+  .option('--no-attachments', 'skip copying attachment files (Excel, PDF, etc.)')
   .addHelpText('after', `
 ${chalk.yellow('Examples:')}
   ${chalk.gray('$')} doc-builder deploy                 ${chalk.gray('# Deploy to production')}
@@ -763,6 +765,12 @@ ${chalk.yellow('Troubleshooting:')}
         config.features.authentication = false;
       }
       
+      // Handle no-attachments option
+      if (options.attachments === false) {
+        config.features = config.features || {};
+        config.features.attachments = false;
+      }
+      
       // Always build first
       spinner.stop();
       console.log(chalk.blue('\n📦 Building documentation first...\n'));
@@ -1153,7 +1161,7 @@ ${chalk.yellow('What gets created:')}
         const exampleFiles = {
           'README.md': `# Welcome to Your Documentation\n\nThis is an example documentation site created with @knowcode/doc-builder.\n\n## Features\n\n- 📝 Write in Markdown\n- 🎨 Beautiful Notion-inspired design\n- 📊 Mermaid diagram support\n- 🌙 Dark mode\n- 🚀 Deploy to Vercel\n\n## Getting Started\n\n1. Edit this file and add your content\n2. Create new markdown files\n3. Run \`npx @knowcode/doc-builder@latest\` to build and deploy\n\n## Example Diagram\n\n\`\`\`mermaid\ngraph TD\n    A[Write Docs] --> B[Build]\n    B --> C[Deploy]\n    C --> D[Share]\n\`\`\`\n`,
           'getting-started.md': `# Getting Started\n\n**Generated**: ${new Date().toISOString().split('T')[0]}\n**Status**: Draft\n**Verified**: ❓\n\n## Overview\n\nThis guide will help you get started with your documentation.\n\n## Installation\n\nNo installation required! Just use:\n\n\`\`\`bash\nnpx @knowcode/doc-builder@latest\n\`\`\`\n\n## Writing Documentation\n\n1. Create markdown files in the \`docs\` folder\n2. Use folders to organize your content\n3. Add front matter for metadata\n\n## Building\n\nTo build your documentation:\n\n\`\`\`bash\nnpx @knowcode/doc-builder@latest build\n\`\`\`\n\n## Deployment\n\nDeploy to Vercel:\n\n\`\`\`bash\nnpx @knowcode/doc-builder@latest deploy\n\`\`\`\n`,
-          'guides/configuration.md': `# Configuration Guide\n\n**Generated**: ${new Date().toISOString().split('T')[0]}\n**Status**: Draft\n**Verified**: ❓\n\n## Overview\n\n@knowcode/doc-builder works with zero configuration, but you can customize it.\n\n## Configuration File\n\nCreate \`doc-builder.config.js\`:\n\n\`\`\`javascript\nmodule.exports = {\n  siteName: 'My Documentation',\n  siteDescription: 'Documentation for my project',\n  \n  features: {\n    authentication: false,\n    changelog: true,\n    mermaid: true,\n    darkMode: true\n  }\n};\n\`\`\`\n\n## Options\n\n### Site Information\n\n- \`siteName\`: Your documentation site name\n- \`siteDescription\`: Brief description\n\n### Directories\n\n- \`docsDir\`: Input directory (default: 'docs')\n- \`outputDir\`: Output directory (default: 'html')\n\n### Features\n\n- \`authentication\`: Enable password protection\n- \`changelog\`: Generate changelog automatically\n- \`mermaid\`: Support for diagrams\n- \`darkMode\`: Dark theme support\n`
+          'guides/configuration.md': `# Configuration Guide\n\n**Generated**: ${new Date().toISOString().split('T')[0]}\n**Status**: Draft\n**Verified**: ❓\n\n## Overview\n\n@knowcode/doc-builder works with zero configuration, but you can customize it.\n\n## Configuration File\n\nCreate \`doc-builder.config.js\`:\n\n\`\`\`javascript\nmodule.exports = {\n  siteName: 'My Documentation',\n  siteDescription: 'Documentation for my project',\n  \n  features: {\n    authentication: false,\n    changelog: true,\n    mermaid: true,\n    darkMode: true\n  }\n};\n\`\`\`\n\n## Options\n\n### Site Information\n\n- \`siteName\`: Your documentation site name\n- \`siteDescription\`: Brief description\n\n### Directories\n\n- \`docsDir\`: Input directory (default: 'docs')\n- \`outputDir\`: Output directory (default: 'html')\n\n### Features\n\n- \`authentication\`: Enable Supabase authentication\n- \`changelog\`: Generate changelog automatically\n- \`mermaid\`: Support for diagrams\n- \`darkMode\`: Dark theme support\n`
         };
         
         // Create example files

package/html/README.html

@@ -65,8 +65,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-25T13:01:14.155Z",
-  "dateModified": "2025-07-25T13:01:14.155Z",
+  "datePublished": "2025-07-26T09:59:22.925Z",
+  "dateModified": "2025-07-26T09:59:22.925Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.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:01 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" 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 expanded" 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" 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/html/css/notion-style.css

@@ -289,7 +289,8 @@ pre code {
   }
 }
 
-.logout-btn {
+.logout-btn,
+.auth-btn {
   background: none;
   border: none;
   font-size: var(--text-lg);
@@ -312,6 +313,13 @@ pre code {
   transform: translateY(-1px);
 }
 
+.auth-btn:hover {
+  background: var(--color-bg-tertiary);
+  opacity: 1;
+  color: var(--color-text-primary);
+  transform: translateY(-1px);
+}
+
 /* Sidebar */
 .sidebar {
   position: relative;