@knowcode/doc-builder 1.9.1 โ†’ 1.9.3

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 (49) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/CLAUDE.md +35 -0
  3. package/README.md +1 -0
  4. package/assets/css/notion-style.css +2 -2
  5. package/html/README.html +151 -33
  6. package/html/auth.js +4 -3
  7. package/html/css/notion-style.css +394 -13
  8. package/html/documentation-index.html +134 -10
  9. package/html/guides/authentication-default-change.html +132 -7
  10. package/html/guides/authentication-guide.html +143 -19
  11. package/html/guides/claude-workflow-guide.html +139 -22
  12. package/html/guides/documentation-standards.html +135 -11
  13. package/html/guides/html-embedding-guide.html +451 -0
  14. package/html/guides/image-modal-guide.html +134 -10
  15. package/html/guides/phosphor-icons-guide.html +152 -27
  16. package/html/guides/private-directory-authentication-troubleshooting.html +545 -0
  17. package/html/guides/private-directory-authentication.html +132 -7
  18. package/html/guides/public-site-deployment.html +132 -7
  19. package/html/guides/search-engine-verification-guide.html +132 -7
  20. package/html/guides/seo-guide.html +132 -7
  21. package/html/guides/seo-optimization-guide.html +161 -38
  22. package/html/guides/troubleshooting-guide.html +143 -19
  23. package/html/guides/windows-setup-guide.html +163 -38
  24. package/html/image-modal-test.html +127 -8
  25. package/html/index.html +151 -33
  26. package/html/js/auth.js +119 -39
  27. package/html/js/main.js +259 -25
  28. package/html/private/cache-control-anti-pattern.html +137 -12
  29. package/html/private/launch/README.html +146 -15
  30. package/html/private/launch/auth-cleanup-summary.html +155 -24
  31. package/html/private/launch/bubble-plugin-specification.html +138 -7
  32. package/html/private/launch/go-to-market-strategy.html +140 -9
  33. package/html/private/launch/launch-announcements.html +154 -24
  34. package/html/private/launch/vercel-deployment-auth-setup.html +140 -9
  35. package/html/private/next-steps-walkthrough.html +139 -14
  36. package/html/private/supabase-auth-implementation-completed.html +145 -21
  37. package/html/private/supabase-auth-implementation-plan.html +138 -14
  38. package/html/private/supabase-auth-integration-plan.html +144 -21
  39. package/html/private/supabase-auth-setup-guide.html +141 -16
  40. package/html/private/test-private-doc.html +132 -7
  41. package/html/private/user-management-tooling.html +132 -7
  42. package/html/prompts/markdown-document-standards.html +136 -12
  43. package/html/sitemap.xml +70 -46
  44. package/html/vercel-cli-setup-guide.html +130 -11
  45. package/html/vercel-first-time-setup-guide.html +127 -8
  46. package/lib/config.js +2 -0
  47. package/lib/emoji-mapper.js +2 -0
  48. package/lib/supabase-auth.js +4 -3
  49. package/package.json +1 -1
@@ -3,14 +3,41 @@
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="Beautiful documentation with the least effort possible">
7
- <title>Vercel Deployment Authentication Setup Guide - @knowcode/doc-builder</title>
6
+ <meta name="description" content="Your test documentation site is now live at:">
7
+ <title>Vercel Deployment Authentication Setup Guide</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/launch/vercel-deployment-auth-setup.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/launch/vercel-deployment-auth-setup.html">
17
+ <meta property="og:title" content="Vercel Deployment Authentication Setup Guide">
18
+ <meta property="og:description" content="Your test documentation site is now live at:">
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="Vercel Deployment Authentication Setup Guide">
28
+ <meta name="twitter:description" content="Your test documentation site is now live at:">
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">
8
34
 
9
35
  <!-- Fonts -->
10
36
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
11
37
 
12
38
  <!-- Icons -->
13
39
  <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">
14
41
 
15
42
  <!-- Mermaid -->
16
43
  <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -18,8 +45,96 @@
18
45
  <!-- Styles -->
19
46
  <link rel="stylesheet" href="/css/notion-style.css">
20
47
 
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
+
21
83
  <!-- Favicon -->
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>">
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": "Vercel Deployment Authentication Setup Guide",
91
+ "description": "Your test documentation site is now live at:",
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-28T16:34:27.969Z",
102
+ "dateModified": "2025-07-28T16:34:27.969Z",
103
+ "mainEntityOfPage": {
104
+ "@type": "WebPage",
105
+ "@id": "https://doc-builder-delta.vercel.app/private/launch/vercel-deployment-auth-setup.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": "Launch",
126
+ "item": "https://doc-builder-delta.vercel.app/private/launch/"
127
+ },
128
+ {
129
+ "@type": "ListItem",
130
+ "position": 4,
131
+ "name": "Vercel Deployment Auth Setup",
132
+ "item": "https://doc-builder-delta.vercel.app/private/launch/vercel-deployment-auth-setup.html"
133
+ }
134
+ ]
135
+ }
136
+ }
137
+ </script>
23
138
  </head>
24
139
  <body>
25
140
  <!-- Header -->
@@ -29,10 +144,14 @@
29
144
 
30
145
  <div class="header-actions">
31
146
  <div class="deployment-info">
32
- <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 27, 2025, 08:32 AM UTC</span>
147
+ <span class="deployment-date" title="Built with doc-builder v1.9.3">Last updated: Jul 28, 2025, 04:34 PM UTC</span>
33
148
  </div>
34
149
 
35
150
 
151
+ <a href="../../../login.html" class="auth-btn" title="Login/Logout">
152
+ <i class="fas fa-sign-in-alt"></i>
153
+ </a>
154
+
36
155
 
37
156
  <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
38
157
  <i class="fas fa-moon"></i>
@@ -92,16 +211,18 @@
92
211
  <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>
93
212
  <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>
94
213
  <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>
214
+ <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="fas fa-file-alt"></i> Html Embedding Guide</a>
95
215
  <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>
96
216
  <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>
97
217
  <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>
218
+ <a href="/guides/private-directory-authentication-troubleshooting.html" class="nav-item" data-tooltip="Private Directory Authentication Troubleshooting."><i class="fas fa-file-alt"></i> Private Directory Authentication Troubleshooting</a>
98
219
  <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>
99
220
  <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>
100
221
  <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>
101
222
  <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>
102
223
  <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>
103
224
  <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>
104
- <div class="nav-section" data-level="1">
225
+ <div class="nav-section private-nav" data-level="1">
105
226
  <a class="nav-title collapsible expanded" href="#" data-target="nav-private-1" >
106
227
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
107
228
  </a>
@@ -114,7 +235,7 @@
114
235
  <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>
115
236
  <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>
116
237
  <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>
117
- <div class="nav-section" data-level="2">
238
+ <div class="nav-section private-nav" data-level="2">
118
239
  <a class="nav-title collapsible expanded" href="/private/launch/README.html" data-target="nav-private-launch-2" >
119
240
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
120
241
  </a>
@@ -191,7 +312,7 @@ WHERE da.domain = &#39;doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app&#
191
312
  <li>After successful login, you should see the test documentation content</li>
192
313
  </ol>
193
314
  <h2>Step 3: Verify Authentication Features</h2>
194
- <h3>โœ… What Should Work:</h3>
315
+ <h3><i class="ph ph-check-circle" aria-label="checked"></i> What Should Work:</h3>
195
316
  <ul>
196
317
  <li>Automatic redirect to login for unauthenticated users</li>
197
318
  <li>No content flash before redirect (fixed with CSS)</li>
@@ -200,7 +321,7 @@ WHERE da.domain = &#39;doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app&#
200
321
  <li>Logout functionality</li>
201
322
  <li>Session persistence across page refreshes</li>
202
323
  </ul>
203
- <h3>๐Ÿ” Things to Check:</h3>
324
+ <h3><i class="ph ph-magnifying-glass" aria-label="search"></i> Things to Check:</h3>
204
325
  <ol>
205
326
  <li><strong>Network Tab</strong>: Look for Supabase API calls to verify authentication</li>
206
327
  <li><strong>Console</strong>: Check for any JavaScript errors</li>
@@ -270,7 +391,17 @@ npx @knowcode/doc-builder auth:add-user production-email@example.com
270
391
  </div>
271
392
 
272
393
  <!-- Scripts -->
394
+ <script>
395
+ // Pass configuration to frontend
396
+ window.docBuilderConfig = {
397
+ features: {
398
+ showPdfDownload: true,
399
+ menuDefaultOpen: false
400
+ }
401
+ };
402
+ </script>
273
403
  <script src="/js/main.js"></script>
274
-
404
+ <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
405
+ <script src="/js/auth.js"></script>
275
406
  </body>
276
407
  </html>
@@ -3,14 +3,41 @@
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="Beautiful documentation with the least effort possible">
7
- <title>Next Steps: Testing and Deployment Walkthrough - @knowcode/doc-builder</title>
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">
8
34
 
9
35
  <!-- Fonts -->
10
36
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
11
37
 
12
38
  <!-- Icons -->
13
39
  <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">
14
41
 
15
42
  <!-- Mermaid -->
16
43
  <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
@@ -18,8 +45,90 @@
18
45
  <!-- Styles -->
19
46
  <link rel="stylesheet" href="/css/notion-style.css">
20
47
 
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
+
21
83
  <!-- Favicon -->
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>">
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-28T16:34:27.972Z",
102
+ "dateModified": "2025-07-28T16:34:27.972Z",
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>
23
132
  </head>
24
133
  <body>
25
134
  <!-- Header -->
@@ -29,10 +138,14 @@
29
138
 
30
139
  <div class="header-actions">
31
140
  <div class="deployment-info">
32
- <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 27, 2025, 08:32 AM UTC</span>
141
+ <span class="deployment-date" title="Built with doc-builder v1.9.3">Last updated: Jul 28, 2025, 04:34 PM UTC</span>
33
142
  </div>
34
143
 
35
144
 
145
+ <a href="../../login.html" class="auth-btn" title="Login/Logout">
146
+ <i class="fas fa-sign-in-alt"></i>
147
+ </a>
148
+
36
149
 
37
150
  <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
38
151
  <i class="fas fa-moon"></i>
@@ -92,16 +205,18 @@
92
205
  <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>
93
206
  <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>
94
207
  <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>
208
+ <a href="/guides/html-embedding-guide.html" class="nav-item" data-tooltip="Starting from version 1.9.2, doc-builder treats HTML files ( and ) as attachments that are automatically copied to your output directory during the..."><i class="fas fa-file-alt"></i> Html Embedding Guide</a>
95
209
  <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>
96
210
  <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>
97
211
  <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>
212
+ <a href="/guides/private-directory-authentication-troubleshooting.html" class="nav-item" data-tooltip="Private Directory Authentication Troubleshooting."><i class="fas fa-file-alt"></i> Private Directory Authentication Troubleshooting</a>
98
213
  <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>
99
214
  <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>
100
215
  <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>
101
216
  <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>
102
217
  <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>
103
218
  <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>
104
- <div class="nav-section" data-level="1">
219
+ <div class="nav-section private-nav" data-level="1">
105
220
  <a class="nav-title collapsible expanded" href="#" data-target="nav-private-1" >
106
221
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Private
107
222
  </a>
@@ -114,7 +229,7 @@
114
229
  <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>
115
230
  <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>
116
231
  <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>
117
- <div class="nav-section" data-level="2">
232
+ <div class="nav-section private-nav" data-level="2">
118
233
  <a class="nav-title collapsible" href="/private/launch/README.html" data-target="nav-private-launch-2" >
119
234
  <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
120
235
  </a>
@@ -141,7 +256,7 @@
141
256
  <h1>Next Steps: Testing and Deployment Walkthrough</h1>
142
257
  <h2>Overview</h2>
143
258
  <p>Now that we&#39;ve implemented Supabase authentication, let&#39;s walk through testing the implementation and preparing for deployment. This guide provides detailed, step-by-step instructions.</p>
144
- <h2>๐Ÿงช Phase 1: Local Testing</h2>
259
+ <h2><i class="ph ph-test-tube" aria-label="test"></i> Phase 1: Local Testing</h2>
145
260
  <h3>Step 1: Install Dependencies</h3>
146
261
  <p>First, install the new Supabase dependency:</p>
147
262
  <pre><code class="language-bash">cd /Users/lindsaysmith/Documents/lambda1.nosync/doc-builder
@@ -307,7 +422,7 @@ VALUES (&#39;USER_ID_FROM_STEP_10&#39;, &#39;localhost:3001&#39;);
307
422
  <li><strong>Should see the test content</strong></li>
308
423
  <li><strong>Logout should work</strong></li>
309
424
  </ol>
310
- <h2>๐Ÿš€ Phase 2: Deployment Testing</h2>
425
+ <h2><i class="ph ph-rocket-launch" aria-label="launch"></i> Phase 2: Deployment Testing</h2>
311
426
  <h3>Step 13: Test Vercel Deployment</h3>
312
427
  <ol>
313
428
  <li><strong>Update config for deployment</strong>:</li>
@@ -362,7 +477,7 @@ UPDATE docbuilder_sites
362
477
  SET domain = &#39;your-vercel-url.vercel.app&#39;
363
478
  WHERE id = &#39;your-site-id&#39;;
364
479
  </code></pre>
365
- <h2>๐Ÿ”ง Phase 3: Version Management</h2>
480
+ <h2><i class="ph ph-wrench" aria-label="settings"></i> Phase 3: Version Management</h2>
366
481
  <h3>Step 15: Update Version Number</h3>
367
482
  <ol>
368
483
  <li><strong>Update package.json</strong>:</li>
@@ -422,7 +537,7 @@ npm install ../doc-builder/*.tgz
422
537
  npx doc-builder --version
423
538
  npx doc-builder --help
424
539
  </code></pre>
425
- <h2>๐Ÿ“‹ Phase 4: Quality Assurance</h2>
540
+ <h2><i class="ph ph-clipboard-text" aria-label="clipboard"></i> Phase 4: Quality Assurance</h2>
426
541
  <h3>Step 17: Test All CLI Commands</h3>
427
542
  <pre><code class="language-bash"># Test help
428
543
  node cli.js --help
@@ -460,7 +575,7 @@ grep -r &quot;username.*:&quot; test-html/ || echo &quot;Good - no hardcoded use
460
575
  <h3>Step 19: Cross-Platform Testing</h3>
461
576
  <p>If possible, test on different systems:</p>
462
577
  <ul>
463
- <li><strong>macOS</strong>: Current system โœ…</li>
578
+ <li><strong>macOS</strong>: Current system <i class="ph ph-check-circle" aria-label="checked"></i></li>
464
579
  <li><strong>Windows</strong>: Test in WSL or Windows machine</li>
465
580
  <li><strong>Linux</strong>: Test in Docker or Linux VM</li>
466
581
  </ul>
@@ -479,7 +594,7 @@ find docs/ -name &quot;*.md&quot; -exec grep -l &quot;]\(&quot; {} \;
479
594
  </ul>
480
595
  </li>
481
596
  </ol>
482
- <h2>๐ŸŽฏ Success Criteria Checklist</h2>
597
+ <h2><i class="ph ph-target" aria-label="goal"></i> Success Criteria Checklist</h2>
483
598
  <p>Before considering deployment ready:</p>
484
599
  <h3>Functionality</h3>
485
600
  <ul>
@@ -513,7 +628,7 @@ find docs/ -name &quot;*.md&quot; -exec grep -l &quot;]\(&quot; {} \;
513
628
  <li><input disabled="" type="checkbox"> Environment variable support</li>
514
629
  <li><input disabled="" type="checkbox"> Cross-platform functionality</li>
515
630
  </ul>
516
- <h2>๐Ÿšจ Issues to Watch For</h2>
631
+ <h2><i class="ph ph-siren" aria-label="alert"></i> Issues to Watch For</h2>
517
632
  <h3>Common Problems</h3>
518
633
  <ol>
519
634
  <li><strong>Supabase URL format errors</strong> - Must be <code>https://xxx.supabase.co</code></li>
@@ -538,7 +653,17 @@ find docs/ -name &quot;*.md&quot; -exec grep -l &quot;]\(&quot; {} \;
538
653
  </div>
539
654
 
540
655
  <!-- Scripts -->
656
+ <script>
657
+ // Pass configuration to frontend
658
+ window.docBuilderConfig = {
659
+ features: {
660
+ showPdfDownload: true,
661
+ menuDefaultOpen: false
662
+ }
663
+ };
664
+ </script>
541
665
  <script src="/js/main.js"></script>
542
-
666
+ <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
667
+ <script src="/js/auth.js"></script>
543
668
  </body>
544
669
  </html>