@knowcode/doc-builder 1.7.4 → 1.7.6

package/quick-test-commands.md

@@ -0,0 +1,40 @@
+# Quick Test Commands for Vercel Deployment
+
+## 1. Update Domain in Supabase
+
+Run this SQL in your Supabase SQL Editor:
+```sql
+UPDATE docbuilder_sites 
+SET domain = 'doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app'
+WHERE id = '4d8a53bf-dcdd-48c0-98e0-cd1451518735';
+```
+
+## 2. Test the Site
+
+Visit: https://doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app
+
+Login with:
+- Email: `testuser@example.com`
+- Password: `testpass123`
+
+## 3. Check Authentication
+
+After login, you should see:
+- "🔐 Test Documentation with Supabase Auth"
+- "✅ Authentication is Working!"
+
+## 4. Common Issues
+
+If content doesn't show after login:
+- Clear browser cache (Cmd+Shift+R on Mac)
+- Try incognito mode
+- Check browser console for errors
+
+## 5. Production Deployment
+
+Once test works:
+```bash
+vercel --prod
+```
+
+Then update domain in Supabase to production URL.

package/setup-database.sql

@@ -0,0 +1,41 @@
+-- Doc-builder Supabase Database Setup
+-- Run this in your Supabase SQL Editor
+
+-- Table 1: Documentation sites
+CREATE TABLE docbuilder_sites (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    domain TEXT UNIQUE NOT NULL,
+    name TEXT NOT NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Table 2: User access mapping
+CREATE TABLE docbuilder_access (
+    user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
+    site_id UUID REFERENCES docbuilder_sites(id) ON DELETE CASCADE,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    PRIMARY KEY (user_id, site_id)
+);
+
+-- Enable Row Level Security
+ALTER TABLE docbuilder_sites ENABLE ROW LEVEL SECURITY;
+ALTER TABLE docbuilder_access ENABLE ROW LEVEL SECURITY;
+
+-- RLS Policy: Users can only see sites they have access to
+CREATE POLICY "Users see accessible sites" ON docbuilder_sites
+    FOR SELECT USING (
+        EXISTS (
+            SELECT 1 FROM docbuilder_access
+            WHERE site_id = docbuilder_sites.id
+            AND user_id = auth.uid()
+        )
+    );
+
+-- RLS Policy: Users can see their own access
+CREATE POLICY "Users see own access" ON docbuilder_access
+    FOR SELECT USING (user_id = auth.uid());
+
+-- Insert a test site for localhost development
+INSERT INTO docbuilder_sites (domain, name) 
+VALUES ('localhost:3000', 'Test Documentation Site')
+RETURNING id, domain, name;

package/test-auth-config.js

@@ -0,0 +1,17 @@
+module.exports = {
+  siteName: 'Test Documentation',
+  siteDescription: 'Testing Supabase authentication integration',
+  
+  features: {
+    authentication: 'supabase',
+    darkMode: true,
+    mermaid: true,
+    changelog: false  // Disable for simpler testing
+  },
+  
+  auth: {
+    supabaseUrl: 'https://xcihhnfcitjrwbynxmka.supabase.co',
+    supabaseAnonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY',
+    siteId: '4d8a53bf-dcdd-48c0-98e0-cd1451518735'
+  }
+};

package/test-docs/README.md

@@ -0,0 +1,39 @@
+# 🔐 Test Documentation with Supabase Auth
+
+Welcome to the test documentation site! If you can see this page, it means:
+
+## ✅ Authentication is Working!
+
+- You successfully logged in with Supabase
+- Your user account has access to this documentation site
+- The JWT token is valid and verified
+- Row Level Security is properly configured
+
+## 🧪 Test Features
+
+### Secure Access
+This page is protected by enterprise-grade Supabase authentication. Only authorized users can view this content.
+
+### Modern Technology Stack
+- **Frontend**: Generated static HTML with auth checking
+- **Backend**: Supabase authentication and database
+- **Security**: JWT tokens, bcrypt password hashing, RLS policies
+
+### What This Proves
+1. **Database Setup**: Tables were created correctly
+2. **Authentication Flow**: Login → JWT → Access check → Content
+3. **Integration**: doc-builder + Supabase working together
+4. **Security**: Only authenticated users with proper access can see this
+
+## 🎯 Next Steps
+
+Once this test works, we can:
+- Deploy to Vercel with production settings
+- Add more users and documentation sites  
+- Set up your real documentation content
+- Configure custom domains and advanced features
+
+---
+
+**Generated by**: @knowcode/doc-builder with Supabase authentication  
+**Test Date**: July 25, 2025

package/test-html/404.html

@@ -0,0 +1,115 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Page Not Found - Redirecting...</title>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+            margin: 0;
+            padding: 0;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            min-height: 100vh;
+            background-color: #f7f7f5;
+            color: #37352f;
+        }
+        .container {
+            text-align: center;
+            padding: 2rem;
+            max-width: 600px;
+        }
+        h1 {
+            font-size: 3rem;
+            margin: 0 0 1rem 0;
+            color: #37352f;
+        }
+        p {
+            font-size: 1.125rem;
+            line-height: 1.6;
+            color: #6b6b6b;
+            margin: 0 0 2rem 0;
+        }
+        a {
+            color: #0366d6;
+            text-decoration: none;
+        }
+        a:hover {
+            text-decoration: underline;
+        }
+        .emoji {
+            font-size: 4rem;
+            margin-bottom: 1rem;
+        }
+        .loading {
+            display: none;
+            color: #0366d6;
+            margin-top: 1rem;
+        }
+        .redirect-message {
+            display: none;
+            background-color: #e8f4fd;
+            border: 1px solid #c3e0f7;
+            padding: 1rem;
+            border-radius: 8px;
+            margin-top: 1rem;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="emoji">🔍</div>
+        <h1>404</h1>
+        <p id="message">The page you're looking for doesn't exist.</p>
+        <div id="redirect-message" class="redirect-message">
+            Redirecting to the correct page...
+        </div>
+        <p id="loading" class="loading">Redirecting...</p>
+        <p>
+            <a href="/" id="home-link">Go to Home</a>
+        </p>
+    </div>
+
+    <script>
+        // Check if the URL ends with .md
+        const pathname = window.location.pathname;
+        
+        if (pathname.endsWith('.md')) {
+            // Convert .md to .html
+            const htmlPath = pathname.replace(/\.md$/, '.html');
+            
+            // Show redirect message
+            document.getElementById('message').textContent = 'Found a markdown link. Redirecting to the HTML version...';
+            document.getElementById('redirect-message').style.display = 'block';
+            document.getElementById('loading').style.display = 'block';
+            
+            // Redirect after a brief delay to show the message
+            setTimeout(() => {
+                window.location.replace(htmlPath);
+            }, 500);
+        } else {
+            // For true 404s, show the standard message
+            document.getElementById('message').textContent = "The page you're looking for doesn't exist.";
+            
+            // Also check if we can suggest a similar page
+            // Remove common suffixes and try to find a match
+            const basePath = pathname
+                .replace(/\.(html|htm|php|asp|aspx)$/, '')
+                .replace(/\/$/, '');
+            
+            if (basePath && basePath !== pathname) {
+                document.getElementById('message').innerHTML = 
+                    `The page you're looking for doesn't exist.<br>
+                     <small>Did you mean <a href="${basePath}.html">${basePath}.html</a>?</small>`;
+            }
+        }
+        
+        // Update home link to use the correct base URL
+        const baseUrl = window.location.origin;
+        document.getElementById('home-link').href = baseUrl;
+    </script>
+</body>
+</html>

package/test-html/README.html

@@ -0,0 +1,172 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="description" content="Welcome to the test documentation site! If you can see this page, it means:">
+    <title>🔐 Test Documentation with Supabase Auth - Test Documentation</title>
+    
+
+    
+    <!-- Fonts -->
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+    
+    <!-- Icons -->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    
+    
+    <!-- Mermaid -->
+    <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
+    
+    <!-- Styles -->
+    <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>
+    
+    
+    <!-- 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>">
+    
+    
+</head>
+<body>
+    <!-- Header -->
+    <header class="header">
+        <div class="header-content">
+            <a href="/index.html" class="logo">Test Documentation</a>
+            
+            <div class="header-actions">
+                <div class="deployment-info">
+                    <span class="deployment-date" title="Built with doc-builder v1.7.4">Last updated: Jul 25, 2025, 12:27 PM UTC</span>
+                </div>
+                
+                
+                <a href="../logout.html" class="logout-btn" title="Logout">
+                    <i class="fas fa-sign-out-alt"></i>
+                </a>
+                
+                
+                <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
+                    <i class="fas fa-moon"></i>
+                </button>
+                
+                <button id="menu-toggle" class="menu-toggle" aria-label="Toggle menu">
+                    <i class="fas fa-bars"></i>
+                </button>
+            </div>
+        </div>
+    </header>
+    
+    <!-- Preview Banner -->
+    <div id="preview-banner" class="preview-banner">
+        <div class="banner-content">
+            <i class="fas fa-exclamation-triangle banner-icon"></i>
+            <span class="banner-text">This documentation is a preview version - some content may be incomplete</span>
+            <button id="dismiss-banner" class="banner-dismiss" aria-label="Dismiss banner">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+    </div>
+    
+    <!-- Breadcrumbs -->
+    <nav class="breadcrumbs" id="breadcrumbs">
+        <!-- Breadcrumbs will be generated by JavaScript -->
+    </nav>
+    
+    <!-- Main Content -->
+    <div class="main-wrapper">
+        <!-- Sidebar -->
+        <aside class="sidebar">
+            <div class="sidebar-header">
+                <div class="filter-box">
+                    <input type="text" placeholder="Filter items..." class="filter-input" id="nav-filter">
+                    <i class="fas fa-search filter-icon"></i>
+                </div>
+            </div>
+            <nav class="navigation">
+                
+      <div class="nav-section" data-level="0">
+        <a class="nav-title expanded" href="/README.html"  >
+          <i class="fas fa-home"></i> Documentation
+        </a>
+        <div class="nav-content" >
+        <a href="/README.html" class="nav-item active" data-tooltip="🔐 Test Documentation with Supabase Auth."><i class="fas fa-file-alt"></i> Overview</a></div></div>
+            </nav>
+            <div class="resize-handle"></div>
+        </aside>
+        
+        <!-- Content Area -->
+        <main class="content">
+            <div class="content-inner">
+                <h1><i class="ph ph-lock-key" aria-label="secure"></i> Test Documentation with Supabase Auth</h1>
+<p>Welcome to the test documentation site! If you can see this page, it means:</p>
+<h2><i class="ph ph-check-circle" aria-label="checked"></i> Authentication is Working!</h2>
+<ul>
+<li>You successfully logged in with Supabase</li>
+<li>Your user account has access to this documentation site</li>
+<li>The JWT token is valid and verified</li>
+<li>Row Level Security is properly configured</li>
+</ul>
+<h2>🧪 Test Features</h2>
+<h3>Secure Access</h3>
+<p>This page is protected by enterprise-grade Supabase authentication. Only authorized users can view this content.</p>
+<h3>Modern Technology Stack</h3>
+<ul>
+<li><strong>Frontend</strong>: Generated static HTML with auth checking</li>
+<li><strong>Backend</strong>: Supabase authentication and database</li>
+<li><strong>Security</strong>: JWT tokens, bcrypt password hashing, RLS policies</li>
+</ul>
+<h3>What This Proves</h3>
+<ol>
+<li><strong>Database Setup</strong>: Tables were created correctly</li>
+<li><strong>Authentication Flow</strong>: Login → JWT → Access check → Content</li>
+<li><strong>Integration</strong>: doc-builder + Supabase working together</li>
+<li><strong>Security</strong>: Only authenticated users with proper access can see this</li>
+</ol>
+<h2><i class="ph ph-target" aria-label="goal"></i> Next Steps</h2>
+<p>Once this test works, we can:</p>
+<ul>
+<li>Deploy to Vercel with production settings</li>
+<li>Add more users and documentation sites  </li>
+<li>Set up your real documentation content</li>
+<li>Configure custom domains and advanced features</li>
+</ul>
+<hr>
+<p><strong>Generated by</strong>: @knowcode/doc-builder with Supabase authentication<br><strong>Test Date</strong>: July 25, 2025</p>
+
+            </div>
+        </main>
+    </div>
+    
+    <!-- Scripts -->
+    <script>
+    // Pass configuration to frontend
+    window.docBuilderConfig = {
+      features: {
+        showPdfDownload: true,
+        menuDefaultOpen: true
+      }
+    };
+    </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/test-html/auth.js

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