@knowcode/doc-builder 1.8.7 → 1.9.1

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 (48) hide show
  1. package/.claude/settings.local.json +2 -1
  2. package/CHANGELOG.md +27 -0
  3. package/README.md +2 -0
  4. package/assets/css/notion-style.css +141 -0
  5. package/assets/js/main.js +76 -0
  6. package/html/README.html +41 -149
  7. package/html/css/notion-style.css +13 -253
  8. package/html/documentation-index.html +24 -127
  9. package/html/guides/authentication-default-change.html +15 -130
  10. package/html/guides/authentication-guide.html +27 -141
  11. package/html/guides/claude-workflow-guide.html +30 -137
  12. package/html/guides/documentation-standards.html +19 -133
  13. package/html/guides/image-modal-guide.html +381 -0
  14. package/html/guides/phosphor-icons-guide.html +35 -150
  15. package/html/guides/private-directory-authentication.html +15 -130
  16. package/html/guides/public-site-deployment.html +15 -130
  17. package/html/guides/search-engine-verification-guide.html +15 -130
  18. package/html/guides/seo-guide.html +15 -130
  19. package/html/guides/seo-optimization-guide.html +46 -159
  20. package/html/guides/troubleshooting-guide.html +27 -141
  21. package/html/guides/windows-setup-guide.html +46 -161
  22. package/html/image-modal-test.html +189 -0
  23. package/html/index.html +41 -149
  24. package/html/js/auth.js +39 -118
  25. package/html/js/main.js +25 -183
  26. package/html/private/cache-control-anti-pattern.html +20 -135
  27. package/html/private/launch/README.html +23 -144
  28. package/html/private/launch/auth-cleanup-summary.html +32 -153
  29. package/html/private/launch/bubble-plugin-specification.html +15 -136
  30. package/html/private/launch/go-to-market-strategy.html +17 -138
  31. package/html/private/launch/launch-announcements.html +31 -151
  32. package/html/private/launch/vercel-deployment-auth-setup.html +17 -138
  33. package/html/private/next-steps-walkthrough.html +21 -136
  34. package/html/private/supabase-auth-implementation-completed.html +29 -143
  35. package/html/private/supabase-auth-implementation-plan.html +22 -136
  36. package/html/private/supabase-auth-integration-plan.html +29 -142
  37. package/html/private/supabase-auth-setup-guide.html +24 -139
  38. package/html/private/test-private-doc.html +15 -130
  39. package/html/private/user-management-tooling.html +15 -130
  40. package/html/prompts/markdown-document-standards.html +288 -0
  41. package/html/sitemap.xml +56 -44
  42. package/html/vercel-cli-setup-guide.html +19 -128
  43. package/html/vercel-first-time-setup-guide.html +16 -125
  44. package/lib/core-builder.js +1 -0
  45. package/lib/emoji-mapper.js +25 -0
  46. package/package/assets/css/notion-style.css +432 -135
  47. package/package/assets/js/main.js +259 -25
  48. package/package.json +1 -1
@@ -3,41 +3,14 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <meta name="description" content="Now that we&#039;ve implemented Supabase authentication, let&#039;s walk through testing the implementation and preparing for deployment. This guide provides detailed,...">
7
- <title>Next Steps: Testing and Deployment Walkthrough</title>
8
-
9
- <meta name="author" content="Lindsay Smith">
10
- <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, test, step">
11
- <meta name="robots" content="index, follow">
12
- <link rel="canonical" href="https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html">
13
-
14
- <!-- Open Graph / Facebook -->
15
- <meta property="og:type" content="article">
16
- <meta property="og:url" content="https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html">
17
- <meta property="og:title" content="Next Steps: Testing and Deployment Walkthrough">
18
- <meta property="og:description" content="Now that we&#39;ve implemented Supabase authentication, let&#39;s walk through testing the implementation and preparing for deployment. This guide provides detailed,...">
19
- <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
20
- <meta property="og:site_name" content="@knowcode/doc-builder">
21
- <meta property="og:locale" content="en_US">
22
-
23
- <!-- Twitter Card -->
24
- <meta name="twitter:card" content="summary_large_image">
25
- <meta name="twitter:site" content="@planbbackups">
26
- <meta name="twitter:creator" content="@planbbackups">
27
- <meta name="twitter:title" content="Next Steps: Testing and Deployment Walkthrough">
28
- <meta name="twitter:description" content="Now that we&#39;ve implemented Supabase authentication, let&#39;s walk through testing the implementation and preparing for deployment. This guide provides detailed,...">
29
- <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
30
-
31
- <!-- Custom Meta Tags -->
32
- <meta name="google-site-verification" content="FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ">
33
- <meta name="msvalidate.01" content="B2D8C4C12C530D47AA962B24CAA09630">
6
+ <meta name="description" content="Beautiful documentation with the least effort possible">
7
+ <title>Next Steps: Testing and Deployment Walkthrough - @knowcode/doc-builder</title>
34
8
 
35
9
  <!-- Fonts -->
36
10
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
37
11
 
38
12
  <!-- Icons -->
39
13
  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
40
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
41
14
 
42
15
  <!-- Mermaid -->
43
16
  <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -45,90 +18,8 @@
45
18
  <!-- Styles -->
46
19
  <link rel="stylesheet" href="/css/notion-style.css">
47
20
 
48
-
49
- <!-- Hide content until auth check -->
50
- <style>
51
- body {
52
- visibility: hidden;
53
- opacity: 0;
54
- transition: opacity 0.3s ease;
55
- }
56
- body.authenticated {
57
- visibility: visible;
58
- opacity: 1;
59
- }
60
- /* Show login/logout pages immediately */
61
- body.auth-page {
62
- visibility: visible;
63
- opacity: 1;
64
- }
65
- /* Style auth button consistently */
66
- .auth-btn {
67
- background: none;
68
- border: none;
69
- color: var(--text-secondary);
70
- cursor: pointer;
71
- padding: 0.5rem;
72
- border-radius: 0.5rem;
73
- transition: all 0.2s;
74
- font-size: 1.1rem;
75
- }
76
- .auth-btn:hover {
77
- background: var(--bg-secondary);
78
- color: var(--text-primary);
79
- }
80
- </style>
81
-
82
-
83
21
  <!-- Favicon -->
84
- <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>">
85
-
86
- <script type="application/ld+json">
87
- {
88
- "@context": "https://schema.org",
89
- "@type": "TechArticle",
90
- "headline": "Next Steps: Testing and Deployment Walkthrough",
91
- "description": "Now that we've implemented Supabase authentication, let's walk through testing the implementation and preparing for deployment. This guide provides detailed,...",
92
- "author": {
93
- "@type": "Person",
94
- "name": "Lindsay Smith"
95
- },
96
- "publisher": {
97
- "@type": "Organization",
98
- "name": "Knowcode Ltd",
99
- "url": "https://knowcode.tech"
100
- },
101
- "datePublished": "2025-07-26T16:10:10.646Z",
102
- "dateModified": "2025-07-26T16:10:10.646Z",
103
- "mainEntityOfPage": {
104
- "@type": "WebPage",
105
- "@id": "https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html"
106
- },
107
- "breadcrumb": {
108
- "@type": "BreadcrumbList",
109
- "itemListElement": [
110
- {
111
- "@type": "ListItem",
112
- "position": 1,
113
- "name": "@knowcode/doc-builder",
114
- "item": "https://doc-builder-delta.vercel.app"
115
- },
116
- {
117
- "@type": "ListItem",
118
- "position": 2,
119
- "name": "Private",
120
- "item": "https://doc-builder-delta.vercel.app/private/"
121
- },
122
- {
123
- "@type": "ListItem",
124
- "position": 3,
125
- "name": "Next Steps Walkthrough",
126
- "item": "https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html"
127
- }
128
- ]
129
- }
130
- }
131
- </script>
22
+ <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>">
132
23
  </head>
133
24
  <body>
134
25
  <!-- Header -->
@@ -138,14 +29,10 @@
138
29
 
139
30
  <div class="header-actions">
140
31
  <div class="deployment-info">
141
- <span class="deployment-date" title="Built with doc-builder v1.8.6">Last updated: Jul 26, 2025, 04:10 PM UTC</span>
32
+ <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 27, 2025, 08:32 AM UTC</span>
142
33
  </div>
143
34
 
144
35
 
145
- <a href="../../login.html" class="auth-btn" title="Login/Logout">
146
- <i class="fas fa-sign-in-alt"></i>
147
- </a>
148
-
149
36
 
150
37
  <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
151
38
  <i class="fas fa-moon"></i>
@@ -193,6 +80,7 @@
193
80
  <div class="nav-content" >
194
81
  <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
195
82
  <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>
83
+ <a href="/image-modal-test.html" class="nav-item" data-tooltip="This document tests the new image modal functionality in doc-builder."><i class="fas fa-file-alt"></i> Image Modal Test</a>
196
84
  <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>
197
85
  <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>
198
86
  <div class="nav-section" data-level="1">
@@ -204,6 +92,7 @@
204
92
  <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>
205
93
  <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>
206
94
  <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>
95
+ <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="fas fa-file-alt"></i> Image Modal Guide</a>
207
96
  <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>
208
97
  <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder provides flexible authentication options to protect your documentation."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
209
98
  <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>
@@ -212,7 +101,7 @@
212
101
  <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>
213
102
  <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>
214
103
  <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>
215
- <div class="nav-section private-nav" data-level="1">
104
+ <div class="nav-section" data-level="1">
216
105
  <a class="nav-title collapsible expanded" href="#" data-target="nav-private-1" >
217
106
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
218
107
  </a>
@@ -225,7 +114,7 @@
225
114
  <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
226
115
  <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
227
116
  <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
228
- <div class="nav-section private-nav" data-level="2">
117
+ <div class="nav-section" data-level="2">
229
118
  <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
230
119
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
231
120
  </a>
@@ -236,6 +125,12 @@
236
125
  <a href="/private/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>
237
126
  <a href="/private/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>
238
127
  <a href="/private/launch/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></div></div>
128
+ <div class="nav-section" data-level="1">
129
+ <a class="nav-title collapsible" href="#" data-target="nav-prompts-1" >
130
+ <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Prompts
131
+ </a>
132
+ <div class="nav-content collapsed" id="nav-prompts-1">
133
+ <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="fas fa-file-alt"></i> Markdown Document Standards</a></div></div>
239
134
  </nav>
240
135
  <div class="resize-handle"></div>
241
136
  </aside>
@@ -412,7 +307,7 @@ VALUES (&#39;USER_ID_FROM_STEP_10&#39;, &#39;localhost:3001&#39;);
412
307
  <li><strong>Should see the test content</strong></li>
413
308
  <li><strong>Logout should work</strong></li>
414
309
  </ol>
415
- <h2><i class="ph ph-rocket-launch" aria-label="launch"></i> Phase 2: Deployment Testing</h2>
310
+ <h2>🚀 Phase 2: Deployment Testing</h2>
416
311
  <h3>Step 13: Test Vercel Deployment</h3>
417
312
  <ol>
418
313
  <li><strong>Update config for deployment</strong>:</li>
@@ -467,7 +362,7 @@ UPDATE docbuilder_sites
467
362
  SET domain = &#39;your-vercel-url.vercel.app&#39;
468
363
  WHERE id = &#39;your-site-id&#39;;
469
364
  </code></pre>
470
- <h2><i class="ph ph-wrench" aria-label="settings"></i> Phase 3: Version Management</h2>
365
+ <h2>🔧 Phase 3: Version Management</h2>
471
366
  <h3>Step 15: Update Version Number</h3>
472
367
  <ol>
473
368
  <li><strong>Update package.json</strong>:</li>
@@ -527,7 +422,7 @@ npm install ../doc-builder/*.tgz
527
422
  npx doc-builder --version
528
423
  npx doc-builder --help
529
424
  </code></pre>
530
- <h2><i class="ph ph-clipboard-text" aria-label="clipboard"></i> Phase 4: Quality Assurance</h2>
425
+ <h2>📋 Phase 4: Quality Assurance</h2>
531
426
  <h3>Step 17: Test All CLI Commands</h3>
532
427
  <pre><code class="language-bash"># Test help
533
428
  node cli.js --help
@@ -565,7 +460,7 @@ grep -r &quot;username.*:&quot; test-html/ || echo &quot;Good - no hardcoded use
565
460
  <h3>Step 19: Cross-Platform Testing</h3>
566
461
  <p>If possible, test on different systems:</p>
567
462
  <ul>
568
- <li><strong>macOS</strong>: Current system <i class="ph ph-check-circle" aria-label="checked"></i></li>
463
+ <li><strong>macOS</strong>: Current system ✅</li>
569
464
  <li><strong>Windows</strong>: Test in WSL or Windows machine</li>
570
465
  <li><strong>Linux</strong>: Test in Docker or Linux VM</li>
571
466
  </ul>
@@ -584,7 +479,7 @@ find docs/ -name &quot;*.md&quot; -exec grep -l &quot;]\(&quot; {} \;
584
479
  </ul>
585
480
  </li>
586
481
  </ol>
587
- <h2><i class="ph ph-target" aria-label="goal"></i> Success Criteria Checklist</h2>
482
+ <h2>🎯 Success Criteria Checklist</h2>
588
483
  <p>Before considering deployment ready:</p>
589
484
  <h3>Functionality</h3>
590
485
  <ul>
@@ -618,7 +513,7 @@ find docs/ -name &quot;*.md&quot; -exec grep -l &quot;]\(&quot; {} \;
618
513
  <li><input disabled="" type="checkbox"> Environment variable support</li>
619
514
  <li><input disabled="" type="checkbox"> Cross-platform functionality</li>
620
515
  </ul>
621
- <h2><i class="ph ph-siren" aria-label="alert"></i> Issues to Watch For</h2>
516
+ <h2>🚨 Issues to Watch For</h2>
622
517
  <h3>Common Problems</h3>
623
518
  <ol>
624
519
  <li><strong>Supabase URL format errors</strong> - Must be <code>https://xxx.supabase.co</code></li>
@@ -643,17 +538,7 @@ find docs/ -name &quot;*.md&quot; -exec grep -l &quot;]\(&quot; {} \;
643
538
  </div>
644
539
 
645
540
  <!-- Scripts -->
646
- <script>
647
- // Pass configuration to frontend
648
- window.docBuilderConfig = {
649
- features: {
650
- showPdfDownload: true,
651
- menuDefaultOpen: false
652
- }
653
- };
654
- </script>
655
541
  <script src="/js/main.js"></script>
656
- <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
657
- <script src="/js/auth.js"></script>
542
+
658
543
  </body>
659
544
  </html>
@@ -3,41 +3,14 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <meta name="description" content="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+. All references to the old insecure...">
7
- <title>Supabase Authentication Implementation - COMPLE...</title>
8
-
9
- <meta name="author" content="Lindsay Smith">
10
- <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, supabase, authentication">
11
- <meta name="robots" content="index, follow">
12
- <link rel="canonical" href="https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html">
13
-
14
- <!-- Open Graph / Facebook -->
15
- <meta property="og:type" content="article">
16
- <meta property="og:url" content="https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html">
17
- <meta property="og:title" content="Supabase Authentication Implementation - COMPLE...">
18
- <meta property="og:description" content="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+. All references to the old insecure...">
19
- <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
20
- <meta property="og:site_name" content="@knowcode/doc-builder">
21
- <meta property="og:locale" content="en_US">
22
-
23
- <!-- Twitter Card -->
24
- <meta name="twitter:card" content="summary_large_image">
25
- <meta name="twitter:site" content="@planbbackups">
26
- <meta name="twitter:creator" content="@planbbackups">
27
- <meta name="twitter:title" content="Supabase Authentication Implementation - COMPLE...">
28
- <meta name="twitter:description" content="This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+. All references to the old insecure...">
29
- <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
30
-
31
- <!-- Custom Meta Tags -->
32
- <meta name="google-site-verification" content="FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ">
33
- <meta name="msvalidate.01" content="B2D8C4C12C530D47AA962B24CAA09630">
6
+ <meta name="description" content="Beautiful documentation with the least effort possible">
7
+ <title>Supabase Authentication Implementation - COMPLETED ✅ - @knowcode/doc-builder</title>
34
8
 
35
9
  <!-- Fonts -->
36
10
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
37
11
 
38
12
  <!-- Icons -->
39
13
  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
40
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
41
14
 
42
15
  <!-- Mermaid -->
43
16
  <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -45,90 +18,8 @@
45
18
  <!-- Styles -->
46
19
  <link rel="stylesheet" href="/css/notion-style.css">
47
20
 
48
-
49
- <!-- Hide content until auth check -->
50
- <style>
51
- body {
52
- visibility: hidden;
53
- opacity: 0;
54
- transition: opacity 0.3s ease;
55
- }
56
- body.authenticated {
57
- visibility: visible;
58
- opacity: 1;
59
- }
60
- /* Show login/logout pages immediately */
61
- body.auth-page {
62
- visibility: visible;
63
- opacity: 1;
64
- }
65
- /* Style auth button consistently */
66
- .auth-btn {
67
- background: none;
68
- border: none;
69
- color: var(--text-secondary);
70
- cursor: pointer;
71
- padding: 0.5rem;
72
- border-radius: 0.5rem;
73
- transition: all 0.2s;
74
- font-size: 1.1rem;
75
- }
76
- .auth-btn:hover {
77
- background: var(--bg-secondary);
78
- color: var(--text-primary);
79
- }
80
- </style>
81
-
82
-
83
21
  <!-- Favicon -->
84
- <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>">
85
-
86
- <script type="application/ld+json">
87
- {
88
- "@context": "https://schema.org",
89
- "@type": "TechArticle",
90
- "headline": "Supabase Authentication Implementation - COMPLETED ✅",
91
- "description": "This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+. All references to the old insecure...",
92
- "author": {
93
- "@type": "Person",
94
- "name": "Lindsay Smith"
95
- },
96
- "publisher": {
97
- "@type": "Organization",
98
- "name": "Knowcode Ltd",
99
- "url": "https://knowcode.tech"
100
- },
101
- "datePublished": "2025-07-26T16:10:10.647Z",
102
- "dateModified": "2025-07-26T16:10:10.647Z",
103
- "mainEntityOfPage": {
104
- "@type": "WebPage",
105
- "@id": "https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html"
106
- },
107
- "breadcrumb": {
108
- "@type": "BreadcrumbList",
109
- "itemListElement": [
110
- {
111
- "@type": "ListItem",
112
- "position": 1,
113
- "name": "@knowcode/doc-builder",
114
- "item": "https://doc-builder-delta.vercel.app"
115
- },
116
- {
117
- "@type": "ListItem",
118
- "position": 2,
119
- "name": "Private",
120
- "item": "https://doc-builder-delta.vercel.app/private/"
121
- },
122
- {
123
- "@type": "ListItem",
124
- "position": 3,
125
- "name": "Supabase Auth Implementation Completed",
126
- "item": "https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html"
127
- }
128
- ]
129
- }
130
- }
131
- </script>
22
+ <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>">
132
23
  </head>
133
24
  <body>
134
25
  <!-- Header -->
@@ -138,14 +29,10 @@
138
29
 
139
30
  <div class="header-actions">
140
31
  <div class="deployment-info">
141
- <span class="deployment-date" title="Built with doc-builder v1.8.6">Last updated: Jul 26, 2025, 04:10 PM UTC</span>
32
+ <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 27, 2025, 08:32 AM UTC</span>
142
33
  </div>
143
34
 
144
35
 
145
- <a href="../../login.html" class="auth-btn" title="Login/Logout">
146
- <i class="fas fa-sign-in-alt"></i>
147
- </a>
148
-
149
36
 
150
37
  <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
151
38
  <i class="fas fa-moon"></i>
@@ -193,6 +80,7 @@
193
80
  <div class="nav-content" >
194
81
  <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
195
82
  <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>
83
+ <a href="/image-modal-test.html" class="nav-item" data-tooltip="This document tests the new image modal functionality in doc-builder."><i class="fas fa-file-alt"></i> Image Modal Test</a>
196
84
  <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>
197
85
  <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>
198
86
  <div class="nav-section" data-level="1">
@@ -204,6 +92,7 @@
204
92
  <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>
205
93
  <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>
206
94
  <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>
95
+ <a href="/guides/image-modal-guide.html" class="nav-item" data-tooltip="When users click on any image in your generated documentation, it opens in a professional modal overlay with: Full-screen viewing experience Smooth..."><i class="fas fa-file-alt"></i> Image Modal Guide</a>
207
96
  <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>
208
97
  <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder provides flexible authentication options to protect your documentation."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
209
98
  <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>
@@ -212,7 +101,7 @@
212
101
  <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>
213
102
  <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>
214
103
  <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>
215
- <div class="nav-section private-nav" data-level="1">
104
+ <div class="nav-section" data-level="1">
216
105
  <a class="nav-title collapsible expanded" href="#" data-target="nav-private-1" >
217
106
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
218
107
  </a>
@@ -225,7 +114,7 @@
225
114
  <a href="/private/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder supports enterprise-grade authentication through Supabase."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
226
115
  <a href="/private/test-private-doc.html" class="nav-item" data-tooltip="Test Private Document."><i class="fas fa-file-alt"></i> Test Private Doc</a>
227
116
  <a href="/private/user-management-tooling.html" class="nav-item" data-tooltip="The user management system is a set of tools designed to manage user access to Supabase-authenticated documentation sites built with."><i class="fas fa-file-alt"></i> User Management Tooling</a></div></div>
228
- <div class="nav-section private-nav" data-level="2">
117
+ <div class="nav-section" data-level="2">
229
118
  <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
230
119
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
231
120
  </a>
@@ -236,6 +125,12 @@
236
125
  <a href="/private/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>
237
126
  <a href="/private/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>
238
127
  <a href="/private/launch/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></div></div>
128
+ <div class="nav-section" data-level="1">
129
+ <a class="nav-title collapsible" href="#" data-target="nav-prompts-1" >
130
+ <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Prompts
131
+ </a>
132
+ <div class="nav-content collapsed" id="nav-prompts-1">
133
+ <a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="fas fa-file-alt"></i> Markdown Document Standards</a></div></div>
239
134
  </nav>
240
135
  <div class="resize-handle"></div>
241
136
  </aside>
@@ -243,33 +138,34 @@
243
138
  <!-- Content Area -->
244
139
  <main class="content">
245
140
  <div class="content-inner">
246
- <h1>Supabase Authentication Implementation - COMPLETED <i class="ph ph-check-circle" aria-label="checked"></i></h1>
141
+ <h1>Supabase Authentication Implementation - COMPLETED ✅</h1>
247
142
  <h2>Overview</h2>
248
143
  <p>This document records the successful implementation of Supabase authentication in @knowcode/doc-builder v1.7.5+. All references to the old insecure authentication system have been removed.</p>
249
144
  <h2>What Was Achieved</h2>
250
145
  <h3>1. Complete Removal of Old System</h3>
251
146
  <ul>
252
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Removed all client-side credential checking</li>
253
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Deleted old auth.js files</li>
254
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Cleaned up configuration options</li>
255
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Updated all documentation</li>
147
+ <li>✅ Removed all client-side credential checking</li>
148
+ <li>✅ Deleted old auth.js files</li>
149
+ <li>✅ Cleaned up configuration options</li>
150
+ <li>✅ Updated all documentation</li>
256
151
  </ul>
257
152
  <h3>2. Supabase Integration</h3>
258
153
  <ul>
259
- <li><i class="ph ph-check-circle" aria-label="checked"></i> JWT-based authentication</li>
260
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Row Level Security (RLS) </li>
261
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Multi-user support</li>
262
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Fine-grained access control</li>
263
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Session management</li>
154
+ <li>✅ JWT-based authentication</li>
155
+ <li>✅ Row Level Security (RLS) </li>
156
+ <li>✅ Multi-user support</li>
157
+ <li>✅ Fine-grained access control</li>
158
+ <li>✅ Session management</li>
264
159
  </ul>
265
160
  <h3>3. Default Behavior Change</h3>
266
161
  <ul>
267
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Authentication now <strong>disabled by default</strong></li>
268
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Public documentation works out of the box</li>
269
- <li><i class="ph ph-check-circle" aria-label="checked"></i> Authentication must be explicitly enabled</li>
162
+ <li>✅ Authentication now <strong>disabled by default</strong></li>
163
+ <li>✅ Public documentation works out of the box</li>
164
+ <li>✅ Authentication must be explicitly enabled</li>
270
165
  </ul>
271
166
  <h2>Current Architecture</h2>
272
167
  <div class="mermaid-wrapper">
168
+ <div class="mermaid-title">Diagram</div>
273
169
  <div class="mermaid">graph TD
274
170
  A[User Request] --> B{Auth Enabled?}
275
171
  B -->|No| C[Show Content]
@@ -418,17 +314,7 @@ auth: {
418
314
  </div>
419
315
 
420
316
  <!-- Scripts -->
421
- <script>
422
- // Pass configuration to frontend
423
- window.docBuilderConfig = {
424
- features: {
425
- showPdfDownload: true,
426
- menuDefaultOpen: false
427
- }
428
- };
429
- </script>
430
317
  <script src="/js/main.js"></script>
431
- <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
432
- <script src="/js/auth.js"></script>
318
+
433
319
  </body>
434
320
  </html>