npm - @knowcode/doc-builder - Versions diffs - 1.9.30 → 1.10.0 - Mend

@knowcode/doc-builder 1.9.30 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (198) hide show

package/lib/core-builder.js +164 -174
package/lib/emoji-mapper.js +27 -12
package/package.json +12 -2
package/.claude/settings.local.json +0 -56
package/CACHE-BUSTING-GUIDE.md +0 -82
package/CLAUDE.md +0 -86
package/CONTRIBUTING.md +0 -148
package/GITHUB_SETUP.md +0 -203
package/RELEASE-NOTES-1.7.5.md +0 -64
package/Screenshot 2025-07-22 at 19.51.21.png +0 -0
package/Screenshot 2025-07-26 at 17.06.49.png +0 -0
package/add-user-clive.sql +0 -35
package/add-user-lindsay-fixed.sql +0 -85
package/add-user-lindsay.sql +0 -68
package/add-user-pmorgan.sql +0 -35
package/add-user-robbie.sql +0 -35
package/add-wru-users.sql +0 -105
package/debug-login.sql +0 -30
package/doc-builder.config.js +0 -126
package/doc-builder.config.js.backup.1753793768283 +0 -47
package/doc-builder.config.js.backup.1753803964423 +0 -114
package/doc-builder.config.js.backup.1753945707032 +0 -115
package/doc-builder.config.js.backup.1754059241330 +0 -115
package/doc-builder.config.js.backup.1754119567787 +0 -123
package/doc-builder.config.js.backup.1754120048862 +0 -124
package/doc-builder.config.js.backup.1754120529913 +0 -124
package/doc-builder.config.js.backup.1754218469785 +0 -124
package/doc-builder.config.js.backup.1754384764054 +0 -124
package/doc-builder.config.js.backup.1754567425847 +0 -124
package/doc-builder.config.js.backup.1754568137859 +0 -126
package/doc-builder.config.js.backup.1754569388252 +0 -126
package/doc-builder.config.js.backup.1754576694123 +0 -126
package/doc-builder.config.js.backup.1755031374829 +0 -126
package/doc-builder.config.js.backup.1755034500990 +0 -126
package/doc-builder.config.js.backup.1755034809236 +0 -126
package/grant-access.sql +0 -15
package/html/11.png +0 -0
package/html/404.html +0 -115
package/html/README.html +0 -522
package/html/Screenshot 2025-08-12 at 21.35.07.png +0 -0
package/html/about-doc-builder.html +0 -491
package/html/auth.js +0 -157
package/html/claude-workflow-guide.html +0 -525
package/html/css/notion-style.css +0 -2502
package/html/documentation-index.html +0 -471
package/html/guides/authentication-default-change.html +0 -370
package/html/guides/authentication-guide.html +0 -509
package/html/guides/cache-control-anti-pattern.html +0 -361
package/html/guides/claude-workflow-guide.html +0 -1074
package/html/guides/configuration-guide.html +0 -472
package/html/guides/document-standards.html +0 -518
package/html/guides/documentation-standards.html +0 -694
package/html/guides/html-embedding-guide.html +0 -461
package/html/guides/image-modal-guide.html +0 -515
package/html/guides/next-steps-walkthrough.html +0 -638
package/html/guides/phosphor-icons-guide.html +0 -584
package/html/guides/private-directory-authentication-troubleshooting.html +0 -555
package/html/guides/private-directory-authentication.html +0 -541
package/html/guides/public-site-deployment.html +0 -431
package/html/guides/search-engine-verification-guide.html +0 -542
package/html/guides/seo-guide.html +0 -661
package/html/guides/seo-optimization-guide.html +0 -887
package/html/guides/supabase-auth-implementation-plan.html +0 -543
package/html/guides/supabase-auth-integration-plan.html +0 -671
package/html/guides/supabase-auth-setup-guide.html +0 -498
package/html/guides/supabase-authentication-complete-guide.html +0 -866
package/html/guides/troubleshooting-guide.html +0 -633
package/html/guides/vercel-deployment-auth-setup.html +0 -337
package/html/guides/windows-setup-guide.html +0 -859
package/html/image-modal-test.html +0 -318
package/html/index.html +0 -522
package/html/js/auth.js +0 -157
package/html/js/main.js +0 -1754
package/html/launch/README.html +0 -297
package/html/launch/bubble-plugin-specification.html +0 -933
package/html/launch/go-to-market-strategy.html +0 -663
package/html/launch/launch-announcements.html +0 -593
package/html/login.html +0 -102
package/html/logout.html +0 -18
package/html/private/cache-control-anti-pattern.html +0 -429
package/html/private/launch/README.html +0 -371
package/html/private/launch/auth-cleanup-summary.html +0 -361
package/html/private/launch/bubble-plugin-specification.html +0 -1007
package/html/private/launch/go-to-market-strategy.html +0 -737
package/html/private/launch/launch-announcements.html +0 -667
package/html/private/launch/vercel-deployment-auth-setup.html +0 -417
package/html/private/next-steps-walkthrough.html +0 -679
package/html/private/supabase-auth-implementation-completed.html +0 -454
package/html/private/supabase-auth-implementation-plan.html +0 -594
package/html/private/supabase-auth-integration-plan.html +0 -704
package/html/private/supabase-auth-setup-guide.html +0 -555
package/html/private/test-private-doc.html +0 -302
package/html/private/user-management-tooling.html +0 -601
package/html/prompts/Screenshot 2025-08-02 at 08.49.55.png +0 -0
package/html/prompts/beautiful-documentation-design.html +0 -784
package/html/prompts/markdown-document-standards.html +0 -422
package/html/prompts/project-rename-strategy-sasha-publish.html +0 -530
package/html/robots.txt +0 -9
package/html/sitemap.xml +0 -357
package/html/test-questions/how-does-it-work%3F.html +0 -294
package/html/test-questions/step-1%3A%20getting-started.html +0 -289
package/html/test-questions/what-is-the-purpose.html +0 -293
package/html/test-status.html +0 -281
package/html/vercel-cli-setup-guide.html +0 -495
package/html/vercel-first-time-setup-guide.html +0 -454
package/html/vercel.json +0 -29
package/html-static/11.png +0 -0
package/html-static/404.html +0 -115
package/html-static/README.html +0 -609
package/html-static/Screenshot 2025-08-12 at 21.35.07.png +0 -0
package/html-static/about-doc-builder.html +0 -578
package/html-static/css/notion-style.css +0 -2502
package/html-static/documentation-index.html +0 -558
package/html-static/guides/authentication-default-change.html +0 -457
package/html-static/guides/authentication-guide.html +0 -596
package/html-static/guides/claude-workflow-guide.html +0 -1161
package/html-static/guides/configuration-guide.html +0 -559
package/html-static/guides/documentation-standards.html +0 -781
package/html-static/guides/html-embedding-guide.html +0 -548
package/html-static/guides/image-modal-guide.html +0 -602
package/html-static/guides/phosphor-icons-guide.html +0 -671
package/html-static/guides/private-directory-authentication-troubleshooting.html +0 -642
package/html-static/guides/private-directory-authentication.html +0 -628
package/html-static/guides/public-site-deployment.html +0 -518
package/html-static/guides/search-engine-verification-guide.html +0 -629
package/html-static/guides/seo-guide.html +0 -748
package/html-static/guides/seo-optimization-guide.html +0 -974
package/html-static/guides/supabase-authentication-complete-guide.html +0 -953
package/html-static/guides/troubleshooting-guide.html +0 -720
package/html-static/guides/windows-setup-guide.html +0 -946
package/html-static/image-modal-test.html +0 -405
package/html-static/index.html +0 -609
package/html-static/js/main.js +0 -1754
package/html-static/prompts/Screenshot 2025-08-02 at 08.49.55.png +0 -0
package/html-static/prompts/beautiful-documentation-design.html +0 -871
package/html-static/prompts/markdown-document-standards.html +0 -509
package/html-static/prompts/project-rename-strategy-sasha-publish.html +0 -617
package/html-static/robots.txt +0 -5
package/html-static/sitemap.xml +0 -195
package/html-static/test-questions/how-does-it-work%3F.html +0 -381
package/html-static/test-questions/step-1%3A%20getting-started.html +0 -376
package/html-static/test-questions/what-is-the-purpose.html +0 -380
package/html-static/vercel-cli-setup-guide.html +0 -582
package/html-static/vercel-first-time-setup-guide.html +0 -541
package/manage-users.sql +0 -191
package/migrate-to-domain-auth.sql +0 -47
package/package/CACHE-BUSTING-GUIDE.md +0 -82
package/package/CHANGELOG.md +0 -902
package/package/README.md +0 -248
package/package/assets/css/notion-style.css +0 -2211
package/package/assets/js/auth.js +0 -67
package/package/assets/js/main.js +0 -1565
package/package/cli.js +0 -764
package/package/index.js +0 -38
package/package/knowcode-doc-builder-1.3.15.tgz +0 -0
package/package/lib/builder.js +0 -32
package/package/lib/config.js +0 -278
package/package/lib/core-builder.js +0 -957
package/package/lib/deploy.js +0 -497
package/package/lib/dev-server.js +0 -96
package/package/package.json +0 -34
package/package/scripts/npx-runner.js +0 -27
package/package/scripts/setup.js +0 -56
package/package/test-cache-bust.sh +0 -43
package/public-config.js +0 -22
package/public-html/404.html +0 -115
package/public-html/README.html +0 -149
package/public-html/css/notion-style.css +0 -2036
package/public-html/index.html +0 -149
package/public-html/js/auth.js +0 -67
package/public-html/js/main.js +0 -1485
package/quick-test-commands.md +0 -40
package/recordings/Screenshot 2025-07-24 at 18.22.01.png +0 -0
package/recordings/mh-ls-22jul.txt +0 -2305
package/screenshot.png +0 -0
package/scripts/Screenshot 2025-07-23 at 15.39.41.png +0 -0
package/setup-database-v2.sql +0 -53
package/setup-database.sql +0 -41
package/test-auth-config.js +0 -17
package/test-cache-bust.sh +0 -43
package/test-docs/README.md +0 -39
package/test-html/404.html +0 -115
package/test-html/README.html +0 -172
package/test-html/auth.js +0 -97
package/test-html/css/notion-style.css +0 -2036
package/test-html/index.html +0 -172
package/test-html/js/auth.js +0 -97
package/test-html/js/main.js +0 -1485
package/test-html/login.html +0 -102
package/test-html/logout.html +0 -18
package/update-domain.sql +0 -9
package/user-access-view.sql +0 -49
package/user-management/README.md +0 -301
package/user-management/add-users.sh +0 -776
package/user-management/create-user.js +0 -65
package/user-management/users.txt +0 -15
package/view-all-users.sql +0 -40
package/wru-auth-config.js +0 -17

package/html/launch/bubble-plugin-specification.html DELETED Viewed

@@ -1,933 +0,0 @@
-<!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="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers to...">
-    <title>Bubble.io Plugin Specification | @knowcode/doc-builder</title>
-    <meta name="author" content="Lindsay Smith">
-    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, text, bubble">
-    <meta name="robots" content="index, follow">
-    <link rel="canonical" href="https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html">
-    <!-- Open Graph / Facebook -->
-    <meta property="og:type" content="article">
-    <meta property="og:url" content="https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html">
-    <meta property="og:title" content="Bubble.io Plugin Specification | @knowcode/doc-builder">
-    <meta property="og:description" content="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers to...">
-    <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
-    <meta property="og:site_name" content="@knowcode/doc-builder">
-    <meta property="og:locale" content="en_US">
-    <!-- Twitter Card -->
-    <meta name="twitter:card" content="summary_large_image">
-    <meta name="twitter:site" content="@planbbackups">
-    <meta name="twitter:creator" content="@planbbackups">
-    <meta name="twitter:title" content="Bubble.io Plugin Specification | @knowcode/doc-builder">
-    <meta name="twitter:description" content="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers to...">
-    <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
-    <!-- Custom Meta Tags -->
-    <meta name="google-site-verification" content="FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ">
-    <meta name="msvalidate.01" content="B2D8C4C12C530D47AA962B24CAA09630">
-    <!-- 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">
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.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">
-    <!-- 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>">
-    <script type="application/ld+json">
-{
-  "@context": "https://schema.org",
-  "@type": "TechArticle",
-  "headline": "Bubble.io Plugin Specification",
-  "description": "This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers to...",
-  "author": {
-    "@type": "Person",
-    "name": "Lindsay Smith"
-  },
-  "publisher": {
-    "@type": "Organization",
-    "name": "Knowcode Ltd",
-    "url": "https://knowcode.tech"
-  },
-  "datePublished": "2025-07-25T13:49:06.569Z",
-  "dateModified": "2025-07-25T13:49:06.569Z",
-  "mainEntityOfPage": {
-    "@type": "WebPage",
-    "@id": "https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html"
-  },
-  "breadcrumb": {
-    "@type": "BreadcrumbList",
-    "itemListElement": [
-      {
-        "@type": "ListItem",
-        "position": 1,
-        "name": "@knowcode/doc-builder",
-        "item": "https://doc-builder-delta.vercel.app"
-      },
-      {
-        "@type": "ListItem",
-        "position": 2,
-        "name": "Launch",
-        "item": "https://doc-builder-delta.vercel.app/launch/"
-      },
-      {
-        "@type": "ListItem",
-        "position": 3,
-        "name": "Bubble Plugin Specification",
-        "item": "https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html"
-      }
-    ]
-  }
-}
-</script>
-</head>
-<body>
-    <!-- Header -->
-    <header class="header">
-        <div class="header-content">
-            <a href="/index.html" class="logo">@knowcode/doc-builder</a>
-            <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>
-                </div>
-                <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" href="/README.html"  >
-          <i class="fas fa-home"></i> Documentation
-        </a>
-        <div class="nav-content" >
-        <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
-        <a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
-        <a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
-        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the Vercel deployment process when using ."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
-      <div class="nav-section" data-level="1">
-        <a class="nav-title collapsible" href="#" data-target="nav-guides-1" >
-          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
-        </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/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/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 active" 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>
-        <!-- Content Area -->
-        <main class="content">
-            <div class="content-inner">
-                <h1>Bubble.io Plugin Specification</h1>
-<h2>Overview</h2>
-<p>This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers to create and manage beautiful documentation directly from their Bubble applications.</p>
-<h2>Plugin Architecture</h2>
-<h3>Core Components</h3>
-<pre><code>bubble-doc-builder/
-├── plugin.json              # Plugin manifest
-├── elements/
-│   ├── DocViewer/          # Main documentation viewer
-│   │   ├── element.json    # Element configuration
-│   │   ├── preview.js      # Editor preview
-│   │   ├── runtime.js      # Runtime behavior
-│   │   └── style.css       # Component styling
-│   ├── DocSearch/          # Search component
-│   └── DocNav/             # Navigation widget
-├── actions/
-│   ├── generate-docs/      # Generate documentation
-│   ├── deploy-to-vercel/   # Deploy documentation
-│   ├── update-content/     # Update doc content
-│   └── sync-from-bubble/   # Sync Bubble data
-├── api/
-│   ├── calls/              # API definitions
-│   └── shared.js           # Shared utilities
-└── assets/
-    ├── icons/              # Plugin icons
-    └── templates/          # Doc templates
-</code></pre>
-<h2>Element Specifications</h2>
-<h3>1. DocViewer Element</h3>
-<p>The main component for displaying documentation within Bubble apps.</p>
-<h4>Properties</h4>
-<table>
-<thead>
-<tr>
-<th>Property</th>
-<th>Type</th>
-<th>Default</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>doc_url</td>
-<td>text</td>
-<td>&quot;&quot;</td>
-<td>URL of hosted documentation</td>
-</tr>
-<tr>
-<td>theme</td>
-<td>dropdown</td>
-<td>&quot;light&quot;</td>
-<td>Theme selection (light/dark/auto)</td>
-</tr>
-<tr>
-<td>show_navigation</td>
-<td>boolean</td>
-<td>true</td>
-<td>Show/hide navigation sidebar</td>
-</tr>
-<tr>
-<td>show_search</td>
-<td>boolean</td>
-<td>true</td>
-<td>Enable search functionality</td>
-</tr>
-<tr>
-<td>custom_css</td>
-<td>text</td>
-<td>&quot;&quot;</td>
-<td>Custom CSS overrides</td>
-</tr>
-<tr>
-<td>height</td>
-<td>number</td>
-<td>600</td>
-<td>Viewer height in pixels</td>
-</tr>
-<tr>
-<td>auth_required</td>
-<td>boolean</td>
-<td>false</td>
-<td>Require authentication</td>
-</tr>
-<tr>
-<td>auth_token</td>
-<td>text</td>
-<td>&quot;&quot;</td>
-<td>Authentication token</td>
-</tr>
-</tbody></table>
-<h4>States</h4>
-<table>
-<thead>
-<tr>
-<th>State</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>is_loading</td>
-<td>boolean</td>
-<td>Documentation loading state</td>
-</tr>
-<tr>
-<td>current_page</td>
-<td>text</td>
-<td>Current page path</td>
-</tr>
-<tr>
-<td>search_results</td>
-<td>list</td>
-<td>Search results array</td>
-</tr>
-<tr>
-<td>error_message</td>
-<td>text</td>
-<td>Error details if any</td>
-</tr>
-</tbody></table>
-<h4>Events</h4>
-<ul>
-<li><strong>Documentation Loaded</strong> - Triggered when docs load</li>
-<li><strong>Page Changed</strong> - Fired on navigation</li>
-<li><strong>Search Performed</strong> - When user searches</li>
-<li><strong>Error Occurred</strong> - On loading errors</li>
-</ul>
-<h3>2. DocSearch Element</h3>
-<p>Standalone search widget for documentation.</p>
-<h4>Properties</h4>
-<table>
-<thead>
-<tr>
-<th>Property</th>
-<th>Type</th>
-<th>Default</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>doc_source</td>
-<td>text</td>
-<td>&quot;&quot;</td>
-<td>Documentation source URL</td>
-</tr>
-<tr>
-<td>placeholder</td>
-<td>text</td>
-<td>&quot;Search docs...&quot;</td>
-<td>Search placeholder</td>
-</tr>
-<tr>
-<td>max_results</td>
-<td>number</td>
-<td>10</td>
-<td>Maximum results</td>
-</tr>
-<tr>
-<td>show_preview</td>
-<td>boolean</td>
-<td>true</td>
-<td>Show result previews</td>
-</tr>
-</tbody></table>
-<h3>3. DocNav Element</h3>
-<p>Navigation tree component.</p>
-<h4>Properties</h4>
-<table>
-<thead>
-<tr>
-<th>Property</th>
-<th>Type</th>
-<th>Default</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>doc_structure</td>
-<td>text</td>
-<td>&quot;&quot;</td>
-<td>JSON navigation structure</td>
-</tr>
-<tr>
-<td>collapsible</td>
-<td>boolean</td>
-<td>true</td>
-<td>Allow collapse/expand</td>
-</tr>
-<tr>
-<td>show_icons</td>
-<td>boolean</td>
-<td>true</td>
-<td>Show file/folder icons</td>
-</tr>
-</tbody></table>
-<h2>Action Specifications</h2>
-<h3>1. Generate Documentation</h3>
-<p>Creates documentation from Bubble app data.</p>
-<h4>Parameters</h4>
-<table>
-<thead>
-<tr>
-<th>Parameter</th>
-<th>Type</th>
-<th>Required</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>source_type</td>
-<td>dropdown</td>
-<td>Yes</td>
-<td>Data source (database/API/page)</td>
-</tr>
-<tr>
-<td>content_list</td>
-<td>list</td>
-<td>Yes</td>
-<td>List of content to document</td>
-</tr>
-<tr>
-<td>output_format</td>
-<td>dropdown</td>
-<td>Yes</td>
-<td>Format (markdown/html)</td>
-</tr>
-<tr>
-<td>include_schemas</td>
-<td>boolean</td>
-<td>No</td>
-<td>Include data schemas</td>
-</tr>
-<tr>
-<td>template</td>
-<td>dropdown</td>
-<td>No</td>
-<td>Documentation template</td>
-</tr>
-</tbody></table>
-<h4>Output</h4>
-<ul>
-<li><code>documentation_url</code> - Generated documentation URL</li>
-<li><code>generation_time</code> - Time taken in ms</li>
-<li><code>page_count</code> - Number of pages created</li>
-</ul>
-<h3>2. Deploy to Vercel</h3>
-<p>Deploys documentation to Vercel.</p>
-<h4>Parameters</h4>
-<table>
-<thead>
-<tr>
-<th>Parameter</th>
-<th>Type</th>
-<th>Required</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>project_name</td>
-<td>text</td>
-<td>Yes</td>
-<td>Vercel project name</td>
-</tr>
-<tr>
-<td>vercel_token</td>
-<td>text</td>
-<td>Yes</td>
-<td>Vercel API token</td>
-</tr>
-<tr>
-<td>domain</td>
-<td>text</td>
-<td>No</td>
-<td>Custom domain</td>
-</tr>
-<tr>
-<td>production</td>
-<td>boolean</td>
-<td>No</td>
-<td>Deploy to production</td>
-</tr>
-</tbody></table>
-<h4>Output</h4>
-<ul>
-<li><code>deployment_url</code> - Live documentation URL</li>
-<li><code>deployment_id</code> - Vercel deployment ID</li>
-<li><code>status</code> - Deployment status</li>
-</ul>
-<h3>3. Update Content</h3>
-<p>Updates specific documentation content.</p>
-<h4>Parameters</h4>
-<table>
-<thead>
-<tr>
-<th>Parameter</th>
-<th>Type</th>
-<th>Required</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>page_path</td>
-<td>text</td>
-<td>Yes</td>
-<td>Path to page</td>
-</tr>
-<tr>
-<td>new_content</td>
-<td>text</td>
-<td>Yes</td>
-<td>Updated content</td>
-</tr>
-<tr>
-<td>commit_message</td>
-<td>text</td>
-<td>No</td>
-<td>Change description</td>
-</tr>
-<tr>
-<td>auto_deploy</td>
-<td>boolean</td>
-<td>No</td>
-<td>Auto-deploy changes</td>
-</tr>
-</tbody></table>
-<h3>4. Sync from Bubble</h3>
-<p>Synchronizes documentation with Bubble data.</p>
-<h4>Parameters</h4>
-<table>
-<thead>
-<tr>
-<th>Parameter</th>
-<th>Type</th>
-<th>Required</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>sync_type</td>
-<td>dropdown</td>
-<td>Yes</td>
-<td>Manual/automatic/scheduled</td>
-</tr>
-<tr>
-<td>data_types</td>
-<td>list</td>
-<td>Yes</td>
-<td>Bubble data types to sync</td>
-</tr>
-<tr>
-<td>sync_interval</td>
-<td>number</td>
-<td>No</td>
-<td>Interval in minutes</td>
-</tr>
-<tr>
-<td>webhook_url</td>
-<td>text</td>
-<td>No</td>
-<td>Webhook for updates</td>
-</tr>
-</tbody></table>
-<h2>API Integration</h2>
-<h3>Authentication Flow</h3>
-<pre><code class="language-javascript">// Initialize doc-builder API
-function initializeDocBuilder(apiKey, bubbleAppId) {
-  return {
-    baseUrl: &#39;https://api.doc-builder.io&#39;,
-    headers: {
-      &#39;Authorization&#39;: `Bearer ${apiKey}`,
-      &#39;X-Bubble-App-ID&#39;: bubbleAppId,
-      &#39;Content-Type&#39;: &#39;application/json&#39;
-    }
-  };
-}
-</code></pre>
-<h3>Webhook Events</h3>
-<table>
-<thead>
-<tr>
-<th>Event</th>
-<th>Payload</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>docs.generated</td>
-<td><code>{pages, url, timestamp}</code></td>
-<td>Documentation generated</td>
-</tr>
-<tr>
-<td>docs.deployed</td>
-<td><code>{url, version, environment}</code></td>
-<td>Deployment complete</td>
-</tr>
-<tr>
-<td>docs.updated</td>
-<td><code>{changes, author, timestamp}</code></td>
-<td>Content updated</td>
-</tr>
-<tr>
-<td>docs.error</td>
-<td><code>{error, context, timestamp}</code></td>
-<td>Error occurred</td>
-</tr>
-</tbody></table>
-<h2>Bubble Database Schema</h2>
-<h3>DocBuilder Config</h3>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>api_key</td>
-<td>text</td>
-<td>Doc-builder API key</td>
-</tr>
-<tr>
-<td>vercel_token</td>
-<td>text</td>
-<td>Vercel deployment token</td>
-</tr>
-<tr>
-<td>project_name</td>
-<td>text</td>
-<td>Documentation project name</td>
-</tr>
-<tr>
-<td>base_url</td>
-<td>text</td>
-<td>Documentation base URL</td>
-</tr>
-<tr>
-<td>last_sync</td>
-<td>date</td>
-<td>Last synchronization</td>
-</tr>
-<tr>
-<td>auto_sync</td>
-<td>boolean</td>
-<td>Enable auto-sync</td>
-</tr>
-<tr>
-<td>sync_interval</td>
-<td>number</td>
-<td>Sync interval (minutes)</td>
-</tr>
-</tbody></table>
-<h3>Documentation Pages</h3>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>title</td>
-<td>text</td>
-<td>Page title</td>
-</tr>
-<tr>
-<td>slug</td>
-<td>text</td>
-<td>URL slug</td>
-</tr>
-<tr>
-<td>content</td>
-<td>text</td>
-<td>Markdown content</td>
-</tr>
-<tr>
-<td>parent_page</td>
-<td>DocPage</td>
-<td>Parent for hierarchy</td>
-</tr>
-<tr>
-<td>order</td>
-<td>number</td>
-<td>Sort order</td>
-</tr>
-<tr>
-<td>is_published</td>
-<td>boolean</td>
-<td>Publication status</td>
-</tr>
-<tr>
-<td>last_modified</td>
-<td>date</td>
-<td>Last update</td>
-</tr>
-<tr>
-<td>author</td>
-<td>User</td>
-<td>Page author</td>
-</tr>
-</tbody></table>
-<h3>Documentation Templates</h3>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>name</td>
-<td>text</td>
-<td>Template name</td>
-</tr>
-<tr>
-<td>description</td>
-<td>text</td>
-<td>Template description</td>
-</tr>
-<tr>
-<td>structure</td>
-<td>text</td>
-<td>JSON structure</td>
-</tr>
-<tr>
-<td>styles</td>
-<td>text</td>
-<td>Custom CSS</td>
-</tr>
-<tr>
-<td>is_default</td>
-<td>boolean</td>
-<td>Default template</td>
-</tr>
-</tbody></table>
-<h2>Use Cases</h2>
-<h3>1. API Documentation</h3>
-<p>Automatically generate API documentation from Bubble API workflows:</p>
-<pre><code class="language-javascript">// Generate API docs from workflows
-generateDocs({
-  source_type: &#39;api_workflows&#39;,
-  include_schemas: true,
-  template: &#39;api_reference&#39;
-});
-</code></pre>
-<h3>2. User Guides</h3>
-<p>Create user documentation from Bubble pages:</p>
-<pre><code class="language-javascript">// Generate user guide from app pages
-generateDocs({
-  source_type: &#39;pages&#39;,
-  content_list: [&#39;dashboard&#39;, &#39;settings&#39;, &#39;profile&#39;],
-  template: &#39;user_guide&#39;
-});
-</code></pre>
-<h3>3. Database Documentation</h3>
-<p>Document data types and fields:</p>
-<pre><code class="language-javascript">// Document database structure
-generateDocs({
-  source_type: &#39;database&#39;,
-  include_schemas: true,
-  template: &#39;data_dictionary&#39;
-});
-</code></pre>
-<h2>Implementation Roadmap</h2>
-<h3>Phase 1: MVP (2 weeks)</h3>
-<ul>
-<li><input disabled="" type="checkbox"> Basic DocViewer element</li>
-<li><input disabled="" type="checkbox"> Generate documentation action</li>
-<li><input disabled="" type="checkbox"> Simple deployment to Vercel</li>
-<li><input disabled="" type="checkbox"> Basic authentication</li>
-</ul>
-<h3>Phase 2: Enhanced Features (2 weeks)</h3>
-<ul>
-<li><input disabled="" type="checkbox"> DocSearch element</li>
-<li><input disabled="" type="checkbox"> DocNav element</li>
-<li><input disabled="" type="checkbox"> Update content action</li>
-<li><input disabled="" type="checkbox"> Webhook integration</li>
-</ul>
-<h3>Phase 3: Advanced Integration (2 weeks)</h3>
-<ul>
-<li><input disabled="" type="checkbox"> Auto-sync from Bubble</li>
-<li><input disabled="" type="checkbox"> Custom templates</li>
-<li><input disabled="" type="checkbox"> Multi-language support</li>
-<li><input disabled="" type="checkbox"> Analytics integration</li>
-</ul>
-<h3>Phase 4: Polish &amp; Launch (1 week)</h3>
-<ul>
-<li><input disabled="" type="checkbox"> Performance optimization</li>
-<li><input disabled="" type="checkbox"> Error handling</li>
-<li><input disabled="" type="checkbox"> Documentation</li>
-<li><input disabled="" type="checkbox"> Marketplace submission</li>
-</ul>
-<h2>Plugin Settings</h2>
-<h3>General Settings</h3>
-<pre><code class="language-json">{
-  &quot;name&quot;: &quot;Doc Builder for Bubble&quot;,
-  &quot;description&quot;: &quot;Create beautiful documentation from your Bubble app&quot;,
-  &quot;categories&quot;: [&quot;data&quot;, &quot;visual elements&quot;, &quot;analytics&quot;],
-  &quot;plugin_version&quot;: &quot;1.0.0&quot;,
-  &quot;documentation_url&quot;: &quot;https://doc-builder.io/bubble-plugin&quot;,
-  &quot;support_email&quot;: &quot;support@doc-builder.io&quot;
-}
-</code></pre>
-<h3>API Connections</h3>
-<pre><code class="language-json">{
-  &quot;api_connections&quot;: [
-    {
-      &quot;name&quot;: &quot;DocBuilder API&quot;,
-      &quot;base_url&quot;: &quot;https://api.doc-builder.io/v1&quot;,
-      &quot;authentication&quot;: &quot;bearer_token&quot;,
-      &quot;shared_headers&quot;: {
-        &quot;X-Plugin-Version&quot;: &quot;1.0.0&quot;,
-        &quot;X-Platform&quot;: &quot;bubble&quot;
-      }
-    }
-  ]
-}
-</code></pre>
-<h2>Security Considerations</h2>
-<h3>API Key Management</h3>
-<ul>
-<li>Store API keys encrypted in Bubble database</li>
-<li>Use Bubble&#39;s privacy rules for key access</li>
-<li>Implement key rotation mechanism</li>
-<li>Log all API key usage</li>
-</ul>
-<h3>Content Security</h3>
-<ul>
-<li>Sanitize all user-generated content</li>
-<li>Implement CSP headers for embedded docs</li>
-<li>Use iframe sandboxing for viewer</li>
-<li>Validate all webhook signatures</li>
-</ul>
-<h3>Access Control</h3>
-<ul>
-<li>Integrate with Bubble&#39;s user roles</li>
-<li>Implement document-level permissions</li>
-<li>Support SSO for enterprise users</li>
-<li>Audit trail for all actions</li>
-</ul>
-<h2>Performance Optimization</h2>
-<h3>Caching Strategy</h3>
-<ul>
-<li>Cache generated documentation (1 hour)</li>
-<li>CDN integration for static assets</li>
-<li>Lazy load documentation sections</li>
-<li>Progressive enhancement</li>
-</ul>
-<h3>Resource Management</h3>
-<ul>
-<li>Limit concurrent API calls</li>
-<li>Implement request queuing</li>
-<li>Optimize large documentation sets</li>
-<li>Background processing for heavy tasks</li>
-</ul>
-<h2>Pricing Model for Plugin</h2>
-<h3>Free Tier</h3>
-<ul>
-<li>Up to 10 documentation pages</li>
-<li>Basic templates</li>
-<li>Community support</li>
-<li>Bubble.io branding</li>
-</ul>
-<h3>Pro Tier ($19/month)</h3>
-<ul>
-<li>Unlimited pages</li>
-<li>Custom templates</li>
-<li>Priority support</li>
-<li>White-label option</li>
-</ul>
-<h3>Team Tier ($49/month)</h3>
-<ul>
-<li>Everything in Pro</li>
-<li>Team collaboration</li>
-<li>Advanced analytics</li>
-<li>API access</li>
-</ul>
-<h2>Success Metrics</h2>
-<h3>Usage Metrics</h3>
-<ul>
-<li>Plugin installations</li>
-<li>Active users (MAU)</li>
-<li>Documentation pages created</li>
-<li>Deployments per month</li>
-</ul>
-<h3>Performance Metrics</h3>
-<ul>
-<li>API response time (&lt;200ms)</li>
-<li>Documentation load time (&lt;2s)</li>
-<li>Search response time (&lt;100ms)</li>
-<li>Uptime (99.9%)</li>
-</ul>
-<h3>Business Metrics</h3>
-<ul>
-<li>Conversion rate (free to paid)</li>
-<li>Customer lifetime value</li>
-<li>Monthly recurring revenue</li>
-<li>Support ticket volume</li>
-</ul>
-<hr>
-<h2>Document History</h2>
-<table>
-<thead>
-<tr>
-<th>Date</th>
-<th>Author</th>
-<th>Changes</th>
-</tr>
-</thead>
-<tbody><tr>
-<td>2025-07-22</td>
-<td>System</td>
-<td>Initial plugin specification</td>
-</tr>
-</tbody></table>
-            </div>
-        </main>
-    </div>
-    <!-- Scripts -->
-    <script>
-    // Pass configuration to frontend
-    window.docBuilderConfig = {
-      features: {
-        showPdfDownload: true,
-        menuDefaultOpen: false
-      }
-    };
-    </script>
-    <script src="/js/main.js"></script>
-</body>
-</html>