@knowcode/doc-builder 1.9.11 → 1.9.12
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.
- package/README.md +54 -9
- package/doc-builder.config.js +1 -1
- package/doc-builder.config.js.backup.1753945707032 +115 -0
- package/html/README.html +39 -28
- package/html/auth.js +17 -7
- package/html/documentation-index.html +14 -5
- package/html/guides/authentication-default-change.html +7 -3
- package/html/guides/authentication-guide.html +35 -15
- package/html/guides/claude-workflow-guide.html +14 -10
- package/html/guides/configuration-guide.html +443 -0
- package/html/guides/documentation-standards.html +11 -7
- package/html/guides/html-embedding-guide.html +17 -13
- package/html/guides/image-modal-guide.html +9 -5
- package/html/guides/phosphor-icons-guide.html +27 -23
- package/html/guides/private-directory-authentication-troubleshooting.html +21 -17
- package/html/guides/private-directory-authentication.html +7 -3
- package/html/guides/public-site-deployment.html +7 -3
- package/html/guides/search-engine-verification-guide.html +7 -3
- package/html/guides/seo-guide.html +7 -3
- package/html/guides/seo-optimization-guide.html +35 -31
- package/html/guides/supabase-authentication-complete-guide.html +860 -0
- package/html/guides/troubleshooting-guide.html +18 -14
- package/html/guides/windows-setup-guide.html +38 -34
- package/html/image-modal-test.html +7 -3
- package/html/index.html +39 -28
- package/html/js/auth.js +17 -7
- package/html/private/cache-control-anti-pattern.html +12 -8
- package/html/private/launch/README.html +15 -11
- package/html/private/launch/auth-cleanup-summary.html +24 -20
- package/html/private/launch/bubble-plugin-specification.html +7 -3
- package/html/private/launch/go-to-market-strategy.html +9 -5
- package/html/private/launch/launch-announcements.html +23 -19
- package/html/private/launch/vercel-deployment-auth-setup.html +9 -5
- package/html/private/next-steps-walkthrough.html +14 -10
- package/html/private/supabase-auth-implementation-completed.html +20 -16
- package/html/private/supabase-auth-implementation-plan.html +13 -9
- package/html/private/supabase-auth-integration-plan.html +19 -15
- package/html/private/supabase-auth-setup-guide.html +16 -12
- package/html/private/test-private-doc.html +7 -3
- package/html/private/user-management-tooling.html +7 -3
- package/html/prompts/beautiful-documentation-design.html +778 -0
- package/html/prompts/markdown-document-standards.html +11 -7
- package/html/sitemap.xml +69 -51
- package/html/vercel-cli-setup-guide.html +10 -6
- package/html/vercel-first-time-setup-guide.html +7 -3
- package/package.json +1 -1
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
<meta name="description" content="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels.">
|
|
7
7
|
<title>Launch Announcement Templates | @knowcode/doc-builder</title>
|
|
8
8
|
|
|
9
|
+
<meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
|
|
9
10
|
<meta name="author" content="Lindsay Smith">
|
|
10
11
|
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, doc, builder">
|
|
11
12
|
<meta name="robots" content="index, follow">
|
|
@@ -98,8 +99,8 @@
|
|
|
98
99
|
"name": "Knowcode Ltd",
|
|
99
100
|
"url": "https://knowcode.tech"
|
|
100
101
|
},
|
|
101
|
-
"datePublished": "2025-07-
|
|
102
|
-
"dateModified": "2025-07-
|
|
102
|
+
"datePublished": "2025-07-31T07:08:27.406Z",
|
|
103
|
+
"dateModified": "2025-07-31T07:08:27.406Z",
|
|
103
104
|
"mainEntityOfPage": {
|
|
104
105
|
"@type": "WebPage",
|
|
105
106
|
"@id": "https://doc-builder-delta.vercel.app/private/launch/launch-announcements.html"
|
|
@@ -144,7 +145,7 @@
|
|
|
144
145
|
|
|
145
146
|
<div class="header-actions">
|
|
146
147
|
<div class="deployment-info">
|
|
147
|
-
<span class="deployment-date" title="Built with doc-builder v1.9.
|
|
148
|
+
<span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
|
|
148
149
|
</div>
|
|
149
150
|
|
|
150
151
|
|
|
@@ -210,6 +211,7 @@
|
|
|
210
211
|
<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="ph ph-file-text"></i> Authentication Default Change</a>
|
|
211
212
|
<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="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
|
|
212
213
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
|
|
214
|
+
<a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration Guide</a>
|
|
213
215
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
|
|
214
216
|
<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="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
|
|
215
217
|
<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="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
|
|
@@ -220,6 +222,7 @@
|
|
|
220
222
|
<a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
|
|
221
223
|
<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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
|
|
222
224
|
<a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
|
|
225
|
+
<a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete Guide</a>
|
|
223
226
|
<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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
|
|
224
227
|
<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="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
|
|
225
228
|
<div class="nav-section private-nav" data-level="1">
|
|
@@ -251,6 +254,7 @@
|
|
|
251
254
|
<i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
|
|
252
255
|
</a>
|
|
253
256
|
<div class="nav-content collapsed" id="nav-prompts-1">
|
|
257
|
+
<a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
|
|
254
258
|
<a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
|
|
255
259
|
</nav>
|
|
256
260
|
<div class="resize-handle"></div>
|
|
@@ -278,7 +282,7 @@
|
|
|
278
282
|
<li>The output rarely looked professional</li>
|
|
279
283
|
</ul>
|
|
280
284
|
<p><strong>The Solution:</strong><br>Doc Builder transforms your markdown files into beautiful, searchable documentation sites with a single command. Think Notion meets documentation generator.</p>
|
|
281
|
-
<p><strong>Key Features:</strong><br><i class="ph ph-sparkle" aria-label="special"></i> <strong>Notion-inspired design</strong> - Clean, modern UI that readers love<br><i class="ph ph-rocket-launch" aria-label="launch"></i> <strong>One-command deployment</strong> - <code>npx @knowcode/doc-builder@latest deploy</code><br><i class="ph ph-magnifying-glass" aria-label="search"></i> <strong>Full-text search</strong> - Find anything instantly<br><i class="ph ph-moon-stars" aria-label="half moon"></i> <strong>Dark mode</strong> - Easy on the eyes<br><i class="ph ph-chart-bar" aria-label="chart"></i> <strong>Mermaid diagrams</strong> - Visualize complex concepts<br><i class="ph ph-lock-key" aria-label="secure"></i> <strong>Password protection</strong> - Keep internal docs secure<br><i class="ph ph-device-mobile" aria-label="mobile"></i> <strong>Fully responsive</strong> - Perfect on any device</p>
|
|
285
|
+
<p><strong>Key Features:</strong><br><i style="font-size: 1.2em" class="ph ph-sparkle" aria-label="special"></i> <strong>Notion-inspired design</strong> - Clean, modern UI that readers love<br><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> <strong>One-command deployment</strong> - <code>npx @knowcode/doc-builder@latest deploy</code><br><i style="font-size: 1.2em" class="ph ph-magnifying-glass" aria-label="search"></i> <strong>Full-text search</strong> - Find anything instantly<br><i style="font-size: 1.2em" class="ph ph-moon-stars" aria-label="half moon"></i> <strong>Dark mode</strong> - Easy on the eyes<br><i style="font-size: 1.2em" class="ph ph-chart-bar" aria-label="chart"></i> <strong>Mermaid diagrams</strong> - Visualize complex concepts<br><i style="font-size: 1.2em" class="ph ph-lock-key" aria-label="secure"></i> <strong>Password protection</strong> - Keep internal docs secure<br><i style="font-size: 1.2em" class="ph ph-device-mobile" aria-label="mobile"></i> <strong>Fully responsive</strong> - Perfect on any device</p>
|
|
282
286
|
<p><strong>Perfect for:</strong></p>
|
|
283
287
|
<ul>
|
|
284
288
|
<li>Open source projects</li>
|
|
@@ -330,7 +334,7 @@ npx @knowcode/doc-builder@latest deploy
|
|
|
330
334
|
<p>The code is MIT licensed. Would love feedback from the HN community!</p>
|
|
331
335
|
<h2>Twitter/X Thread</h2>
|
|
332
336
|
<h3>Thread</h3>
|
|
333
|
-
<p>🧵 1/7<br>Just launched Doc Builder - a tool that transforms your markdown into beautiful documentation sites with ONE command <i class="ph ph-rocket-launch" aria-label="launch"></i></p>
|
|
337
|
+
<p>🧵 1/7<br>Just launched Doc Builder - a tool that transforms your markdown into beautiful documentation sites with ONE command <i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i></p>
|
|
334
338
|
<p>No more hours of setup. No more ugly docs.</p>
|
|
335
339
|
<p>npx @knowcode/doc-builder@latest deploy</p>
|
|
336
340
|
<p>That's it. You're live on Vercel.</p>
|
|
@@ -342,7 +346,7 @@ npx @knowcode/doc-builder@latest deploy
|
|
|
342
346
|
<li>Costs too much for small projects</li>
|
|
343
347
|
</ul>
|
|
344
348
|
<p>I needed something better.</p>
|
|
345
|
-
<p>3/7<br>Doc Builder features:<br><i class="ph ph-sparkle" aria-label="special"></i> Notion-inspired design<br><i class="ph ph-magnifying-glass" aria-label="search"></i> Full-text search built-in<br><i class="ph ph-moon-stars" aria-label="half moon"></i> Automatic dark mode<br><i class="ph ph-chart-bar" aria-label="chart"></i> Mermaid diagram support<br><i class="ph ph-lock-key" aria-label="secure"></i> Optional password protection<br><i class="ph ph-device-mobile" aria-label="mobile"></i> Mobile responsive<br><i class="ph ph-lightning" aria-label="fast"></i> Lightning fast (static HTML)</p>
|
|
349
|
+
<p>3/7<br>Doc Builder features:<br><i style="font-size: 1.2em" class="ph ph-sparkle" aria-label="special"></i> Notion-inspired design<br><i style="font-size: 1.2em" class="ph ph-magnifying-glass" aria-label="search"></i> Full-text search built-in<br><i style="font-size: 1.2em" class="ph ph-moon-stars" aria-label="half moon"></i> Automatic dark mode<br><i style="font-size: 1.2em" class="ph ph-chart-bar" aria-label="chart"></i> Mermaid diagram support<br><i style="font-size: 1.2em" class="ph ph-lock-key" aria-label="secure"></i> Optional password protection<br><i style="font-size: 1.2em" class="ph ph-device-mobile" aria-label="mobile"></i> Mobile responsive<br><i style="font-size: 1.2em" class="ph ph-lightning" aria-label="fast"></i> Lightning fast (static HTML)</p>
|
|
346
350
|
<p>4/7<br>Perfect for:</p>
|
|
347
351
|
<ul>
|
|
348
352
|
<li>Open source projects</li>
|
|
@@ -369,11 +373,11 @@ npx @knowcode/doc-builder@latest deploy
|
|
|
369
373
|
<p>#buildinpublic #documentation #webdev #opensource</p>
|
|
370
374
|
<h2>LinkedIn Post</h2>
|
|
371
375
|
<h3>Post</h3>
|
|
372
|
-
<p><i class="ph ph-confetti" aria-label="party"></i> Excited to announce the launch of Doc Builder - a developer tool that transforms markdown documentation into beautiful, searchable websites with just one command.</p>
|
|
376
|
+
<p><i style="font-size: 1.2em" class="ph ph-confetti" aria-label="party"></i> Excited to announce the launch of Doc Builder - a developer tool that transforms markdown documentation into beautiful, searchable websites with just one command.</p>
|
|
373
377
|
<p><strong>The Challenge:</strong><br>As developers, we spend countless hours setting up documentation frameworks, configuring build tools, and wrestling with deployment pipelines. Time that could be better spent actually writing documentation or building features.</p>
|
|
374
378
|
<p><strong>The Solution:</strong><br>Doc Builder eliminates this complexity. With a single command, you can deploy professional-looking documentation to Vercel:</p>
|
|
375
379
|
<p><code>npx @knowcode/doc-builder@latest deploy</code></p>
|
|
376
|
-
<p><strong>Key Benefits:</strong><br>• <i class="ph ph-timer" aria-label="timer"></i> Save hours of setup time<br>• <i class="ph ph-palette" aria-label="design"></i> Professional Notion-inspired design out of the box<br>• <i class="ph ph-magnifying-glass" aria-label="search"></i> Built-in search functionality<br>• <i class="ph ph-moon-stars" aria-label="half moon"></i> Automatic dark mode support<br>• <i class="ph ph-chart-bar" aria-label="chart"></i> Mermaid diagram integration<br>• <i class="ph ph-lock-key" aria-label="secure"></i> Optional password protection<br>• <i class="ph ph-device-mobile" aria-label="mobile"></i> Fully responsive design</p>
|
|
380
|
+
<p><strong>Key Benefits:</strong><br>• <i style="font-size: 1.2em" class="ph ph-timer" aria-label="timer"></i> Save hours of setup time<br>• <i style="font-size: 1.2em" class="ph ph-palette" aria-label="design"></i> Professional Notion-inspired design out of the box<br>• <i style="font-size: 1.2em" class="ph ph-magnifying-glass" aria-label="search"></i> Built-in search functionality<br>• <i style="font-size: 1.2em" class="ph ph-moon-stars" aria-label="half moon"></i> Automatic dark mode support<br>• <i style="font-size: 1.2em" class="ph ph-chart-bar" aria-label="chart"></i> Mermaid diagram integration<br>• <i style="font-size: 1.2em" class="ph ph-lock-key" aria-label="secure"></i> Optional password protection<br>• <i style="font-size: 1.2em" class="ph ph-device-mobile" aria-label="mobile"></i> Fully responsive design</p>
|
|
377
381
|
<p><strong>Who It's For:</strong><br>• Open source maintainers<br>• API developers<br>• Technical writers<br>• Development teams<br>• Anyone who needs beautiful documentation quickly</p>
|
|
378
382
|
<p><strong>Impact So Far:</strong><br>• 21 releases on npm<br>• Active community of early adopters<br>• Used in production by multiple projects</p>
|
|
379
383
|
<p>Try the live demo: <a href="https://doc-builder-delta.vercel.app">https://doc-builder-delta.vercel.app</a></p>
|
|
@@ -425,19 +429,19 @@ npx @knowcode/doc-builder@latest deploy
|
|
|
425
429
|
</code></pre>
|
|
426
430
|
<p>That's it! Your documentation is now live on Vercel with a public URL.</p>
|
|
427
431
|
<h2>Key Features That Make It Special</h2>
|
|
428
|
-
<h3><i class="ph ph-palette" aria-label="design"></i> Beautiful by Default</h3>
|
|
432
|
+
<h3><i style="font-size: 1.2em" class="ph ph-palette" aria-label="design"></i> Beautiful by Default</h3>
|
|
429
433
|
<p>I spent weeks perfecting the design so you don't have to. The Notion-inspired interface is clean, modern, and professional.</p>
|
|
430
|
-
<h3><i class="ph ph-magnifying-glass" aria-label="search"></i> Search That Actually Works</h3>
|
|
434
|
+
<h3><i style="font-size: 1.2em" class="ph ph-magnifying-glass" aria-label="search"></i> Search That Actually Works</h3>
|
|
431
435
|
<p>Full-text search is built-in. No configuration needed. It just works.</p>
|
|
432
|
-
<h3><i class="ph ph-moon-stars" aria-label="half moon"></i> Dark Mode</h3>
|
|
436
|
+
<h3><i style="font-size: 1.2em" class="ph ph-moon-stars" aria-label="half moon"></i> Dark Mode</h3>
|
|
433
437
|
<p>Automatic theme detection with manual toggle. Your readers' eyes will thank you.</p>
|
|
434
|
-
<h3><i class="ph ph-chart-bar" aria-label="chart"></i> Mermaid Diagrams</h3>
|
|
438
|
+
<h3><i style="font-size: 1.2em" class="ph ph-chart-bar" aria-label="chart"></i> Mermaid Diagrams</h3>
|
|
435
439
|
<div class="mermaid-wrapper">
|
|
436
440
|
<div class="mermaid">graph TD
|
|
437
441
|
A[Write Markdown] --> B[Run Deploy]
|
|
438
442
|
B --> C[Live Documentation]</div>
|
|
439
443
|
</div>
|
|
440
|
-
<h3><i class="ph ph-lock-key" aria-label="secure"></i> Password Protection</h3>
|
|
444
|
+
<h3><i style="font-size: 1.2em" class="ph ph-lock-key" aria-label="secure"></i> Password Protection</h3>
|
|
441
445
|
<p>Need private docs? Enable authentication with one config line:</p>
|
|
442
446
|
<pre><code class="language-javascript">features: {
|
|
443
447
|
authentication: true
|
|
@@ -487,9 +491,9 @@ npx @knowcode/doc-builder@latest deploy
|
|
|
487
491
|
<p>If you're tired of spending more time on documentation setup than actual writing, give it a try. I'd love to hear your feedback!</p>
|
|
488
492
|
<p><strong>Links:</strong></p>
|
|
489
493
|
<ul>
|
|
490
|
-
<li><i class="ph ph-rocket-launch" aria-label="launch"></i> <a href="https://doc-builder-delta.vercel.app">Live Demo</a></li>
|
|
491
|
-
<li><i class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
|
|
492
|
-
<li><i class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/knowcode/doc-builder">GitHub Repo</a> (coming soon)</li>
|
|
494
|
+
<li><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> <a href="https://doc-builder-delta.vercel.app">Live Demo</a></li>
|
|
495
|
+
<li><i style="font-size: 1.2em" class="ph ph-package" aria-label="package"></i> <a href="https://www.npmjs.com/package/@knowcode/doc-builder">NPM Package</a></li>
|
|
496
|
+
<li><i style="font-size: 1.2em" class="ph ph-github-logo" aria-label="github"></i> <a href="https://github.com/knowcode/doc-builder">GitHub Repo</a> (coming soon)</li>
|
|
493
497
|
</ul>
|
|
494
498
|
<p>What's your biggest documentation pain point? Let me know in the comments!</p>
|
|
495
499
|
<h2>Reddit Posts</h2>
|
|
@@ -552,14 +556,14 @@ await build({
|
|
|
552
556
|
<p>Learned a lot building this, happy to answer technical questions!</p>
|
|
553
557
|
<h2>Email Newsletter</h2>
|
|
554
558
|
<h3>Subject</h3>
|
|
555
|
-
<p><i class="ph ph-rocket-launch" aria-label="launch"></i> Introducing Doc Builder: Beautiful Documentation in One Command</p>
|
|
559
|
+
<p><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> Introducing Doc Builder: Beautiful Documentation in One Command</p>
|
|
556
560
|
<h3>Body</h3>
|
|
557
561
|
<p>Hi {firstName},</p>
|
|
558
562
|
<p>Remember the last time you spent hours setting up documentation for a project?</p>
|
|
559
563
|
<p>The configuring, the styling, the deployment scripts... What if I told you all of that could be replaced with a single command?</p>
|
|
560
564
|
<p><strong>Introducing Doc Builder</strong></p>
|
|
561
565
|
<p>I built Doc Builder because I was tired of documentation taking longer to set up than to write. It's a simple tool that:</p>
|
|
562
|
-
<p><i class="ph ph-check-circle" aria-label="checked"></i> Converts your markdown to beautiful, searchable websites<br><i class="ph ph-check-circle" aria-label="checked"></i> Deploys to Vercel with zero configuration<br><i class="ph ph-check-circle" aria-label="checked"></i> Looks professional out of the box (Notion-inspired design)<br><i class="ph ph-check-circle" aria-label="checked"></i> Includes dark mode, search, and syntax highlighting</p>
|
|
566
|
+
<p><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Converts your markdown to beautiful, searchable websites<br><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Deploys to Vercel with zero configuration<br><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Looks professional out of the box (Notion-inspired design)<br><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Includes dark mode, search, and syntax highlighting</p>
|
|
563
567
|
<p><strong>See It In Action</strong></p>
|
|
564
568
|
<pre><code class="language-bash">npx @knowcode/doc-builder@latest deploy
|
|
565
569
|
</code></pre>
|
|
@@ -588,7 +592,7 @@ doc-builder deploy
|
|
|
588
592
|
<p>Questions? Just reply to this email. I personally read every message.</p>
|
|
589
593
|
<p>Happy documenting!</p>
|
|
590
594
|
<p>Best,<br>Lindsay Smith<br>Creator of Doc Builder</p>
|
|
591
|
-
<p>P.S. Doc Builder is open source and MIT licensed. If you find it useful, a GitHub star would mean the world to me! <i class="ph ph-star-four" aria-label="sparkle"></i></p>
|
|
595
|
+
<p>P.S. Doc Builder is open source and MIT licensed. If you find it useful, a GitHub star would mean the world to me! <i style="font-size: 1.2em" class="ph ph-star-four" aria-label="sparkle"></i></p>
|
|
592
596
|
<hr>
|
|
593
597
|
<h2>Press Release</h2>
|
|
594
598
|
<h3>FOR IMMEDIATE RELEASE</h3>
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
<meta name="description" content="Your test documentation site is now live at:">
|
|
7
7
|
<title>Vercel Deployment Authentication Setup Guide</title>
|
|
8
8
|
|
|
9
|
+
<meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
|
|
9
10
|
<meta name="author" content="Lindsay Smith">
|
|
10
11
|
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, supabase, authentication">
|
|
11
12
|
<meta name="robots" content="index, follow">
|
|
@@ -98,8 +99,8 @@
|
|
|
98
99
|
"name": "Knowcode Ltd",
|
|
99
100
|
"url": "https://knowcode.tech"
|
|
100
101
|
},
|
|
101
|
-
"datePublished": "2025-07-
|
|
102
|
-
"dateModified": "2025-07-
|
|
102
|
+
"datePublished": "2025-07-31T07:08:27.408Z",
|
|
103
|
+
"dateModified": "2025-07-31T07:08:27.408Z",
|
|
103
104
|
"mainEntityOfPage": {
|
|
104
105
|
"@type": "WebPage",
|
|
105
106
|
"@id": "https://doc-builder-delta.vercel.app/private/launch/vercel-deployment-auth-setup.html"
|
|
@@ -144,7 +145,7 @@
|
|
|
144
145
|
|
|
145
146
|
<div class="header-actions">
|
|
146
147
|
<div class="deployment-info">
|
|
147
|
-
<span class="deployment-date" title="Built with doc-builder v1.9.
|
|
148
|
+
<span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
|
|
148
149
|
</div>
|
|
149
150
|
|
|
150
151
|
|
|
@@ -210,6 +211,7 @@
|
|
|
210
211
|
<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="ph ph-file-text"></i> Authentication Default Change</a>
|
|
211
212
|
<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="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
|
|
212
213
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
|
|
214
|
+
<a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration Guide</a>
|
|
213
215
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
|
|
214
216
|
<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="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
|
|
215
217
|
<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="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
|
|
@@ -220,6 +222,7 @@
|
|
|
220
222
|
<a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
|
|
221
223
|
<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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
|
|
222
224
|
<a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
|
|
225
|
+
<a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete Guide</a>
|
|
223
226
|
<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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
|
|
224
227
|
<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="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
|
|
225
228
|
<div class="nav-section private-nav" data-level="1">
|
|
@@ -251,6 +254,7 @@
|
|
|
251
254
|
<i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
|
|
252
255
|
</a>
|
|
253
256
|
<div class="nav-content collapsed" id="nav-prompts-1">
|
|
257
|
+
<a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
|
|
254
258
|
<a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
|
|
255
259
|
</nav>
|
|
256
260
|
<div class="resize-handle"></div>
|
|
@@ -312,7 +316,7 @@ WHERE da.domain = 'doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app&#
|
|
|
312
316
|
<li>After successful login, you should see the test documentation content</li>
|
|
313
317
|
</ol>
|
|
314
318
|
<h2>Step 3: Verify Authentication Features</h2>
|
|
315
|
-
<h3><i class="ph ph-check-circle" aria-label="checked"></i> What Should Work:</h3>
|
|
319
|
+
<h3><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> What Should Work:</h3>
|
|
316
320
|
<ul>
|
|
317
321
|
<li>Automatic redirect to login for unauthenticated users</li>
|
|
318
322
|
<li>No content flash before redirect (fixed with CSS)</li>
|
|
@@ -321,7 +325,7 @@ WHERE da.domain = 'doc-builder-2znroyb5z-lindsay-1340s-projects.vercel.app&#
|
|
|
321
325
|
<li>Logout functionality</li>
|
|
322
326
|
<li>Session persistence across page refreshes</li>
|
|
323
327
|
</ul>
|
|
324
|
-
<h3><i class="ph ph-magnifying-glass" aria-label="search"></i> Things to Check:</h3>
|
|
328
|
+
<h3><i style="font-size: 1.2em" class="ph ph-magnifying-glass" aria-label="search"></i> Things to Check:</h3>
|
|
325
329
|
<ol>
|
|
326
330
|
<li><strong>Network Tab</strong>: Look for Supabase API calls to verify authentication</li>
|
|
327
331
|
<li><strong>Console</strong>: Check for any JavaScript errors</li>
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
<meta name="description" content="Now that we've implemented Supabase authentication, let's walk through testing the implementation and preparing for deployment. This guide provides detailed,...">
|
|
7
7
|
<title>Next Steps: Testing and Deployment Walkthrough</title>
|
|
8
8
|
|
|
9
|
+
<meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
|
|
9
10
|
<meta name="author" content="Lindsay Smith">
|
|
10
11
|
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, test, step">
|
|
11
12
|
<meta name="robots" content="index, follow">
|
|
@@ -98,8 +99,8 @@
|
|
|
98
99
|
"name": "Knowcode Ltd",
|
|
99
100
|
"url": "https://knowcode.tech"
|
|
100
101
|
},
|
|
101
|
-
"datePublished": "2025-07-
|
|
102
|
-
"dateModified": "2025-07-
|
|
102
|
+
"datePublished": "2025-07-31T07:08:27.410Z",
|
|
103
|
+
"dateModified": "2025-07-31T07:08:27.410Z",
|
|
103
104
|
"mainEntityOfPage": {
|
|
104
105
|
"@type": "WebPage",
|
|
105
106
|
"@id": "https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html"
|
|
@@ -138,7 +139,7 @@
|
|
|
138
139
|
|
|
139
140
|
<div class="header-actions">
|
|
140
141
|
<div class="deployment-info">
|
|
141
|
-
<span class="deployment-date" title="Built with doc-builder v1.9.
|
|
142
|
+
<span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
|
|
142
143
|
</div>
|
|
143
144
|
|
|
144
145
|
|
|
@@ -204,6 +205,7 @@
|
|
|
204
205
|
<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="ph ph-file-text"></i> Authentication Default Change</a>
|
|
205
206
|
<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="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
|
|
206
207
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
|
|
208
|
+
<a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration Guide</a>
|
|
207
209
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
|
|
208
210
|
<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="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
|
|
209
211
|
<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="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
|
|
@@ -214,6 +216,7 @@
|
|
|
214
216
|
<a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
|
|
215
217
|
<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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
|
|
216
218
|
<a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
|
|
219
|
+
<a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete Guide</a>
|
|
217
220
|
<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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
|
|
218
221
|
<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="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
|
|
219
222
|
<div class="nav-section private-nav" data-level="1">
|
|
@@ -245,6 +248,7 @@
|
|
|
245
248
|
<i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
|
|
246
249
|
</a>
|
|
247
250
|
<div class="nav-content collapsed" id="nav-prompts-1">
|
|
251
|
+
<a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
|
|
248
252
|
<a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
|
|
249
253
|
</nav>
|
|
250
254
|
<div class="resize-handle"></div>
|
|
@@ -256,7 +260,7 @@
|
|
|
256
260
|
<h1>Next Steps: Testing and Deployment Walkthrough</h1>
|
|
257
261
|
<h2>Overview</h2>
|
|
258
262
|
<p>Now that we've implemented Supabase authentication, let's walk through testing the implementation and preparing for deployment. This guide provides detailed, step-by-step instructions.</p>
|
|
259
|
-
<h2><i class="ph ph-test-tube" aria-label="test"></i> Phase 1: Local Testing</h2>
|
|
263
|
+
<h2><i style="font-size: 1.2em" class="ph ph-test-tube" aria-label="test"></i> Phase 1: Local Testing</h2>
|
|
260
264
|
<h3>Step 1: Install Dependencies</h3>
|
|
261
265
|
<p>First, install the new Supabase dependency:</p>
|
|
262
266
|
<pre><code class="language-bash">cd /Users/lindsaysmith/Documents/lambda1.nosync/doc-builder
|
|
@@ -422,7 +426,7 @@ VALUES ('USER_ID_FROM_STEP_10', 'localhost:3001');
|
|
|
422
426
|
<li><strong>Should see the test content</strong></li>
|
|
423
427
|
<li><strong>Logout should work</strong></li>
|
|
424
428
|
</ol>
|
|
425
|
-
<h2><i class="ph ph-rocket-launch" aria-label="launch"></i> Phase 2: Deployment Testing</h2>
|
|
429
|
+
<h2><i style="font-size: 1.2em" class="ph ph-rocket-launch" aria-label="launch"></i> Phase 2: Deployment Testing</h2>
|
|
426
430
|
<h3>Step 13: Test Vercel Deployment</h3>
|
|
427
431
|
<ol>
|
|
428
432
|
<li><strong>Update config for deployment</strong>:</li>
|
|
@@ -477,7 +481,7 @@ UPDATE docbuilder_sites
|
|
|
477
481
|
SET domain = 'your-vercel-url.vercel.app'
|
|
478
482
|
WHERE id = 'your-site-id';
|
|
479
483
|
</code></pre>
|
|
480
|
-
<h2><i class="ph ph-wrench" aria-label="settings"></i> Phase 3: Version Management</h2>
|
|
484
|
+
<h2><i style="font-size: 1.2em" class="ph ph-wrench" aria-label="settings"></i> Phase 3: Version Management</h2>
|
|
481
485
|
<h3>Step 15: Update Version Number</h3>
|
|
482
486
|
<ol>
|
|
483
487
|
<li><strong>Update package.json</strong>:</li>
|
|
@@ -537,7 +541,7 @@ npm install ../doc-builder/*.tgz
|
|
|
537
541
|
npx doc-builder --version
|
|
538
542
|
npx doc-builder --help
|
|
539
543
|
</code></pre>
|
|
540
|
-
<h2><i class="ph ph-clipboard-text" aria-label="clipboard"></i> Phase 4: Quality Assurance</h2>
|
|
544
|
+
<h2><i style="font-size: 1.2em" class="ph ph-clipboard-text" aria-label="clipboard"></i> Phase 4: Quality Assurance</h2>
|
|
541
545
|
<h3>Step 17: Test All CLI Commands</h3>
|
|
542
546
|
<pre><code class="language-bash"># Test help
|
|
543
547
|
node cli.js --help
|
|
@@ -575,7 +579,7 @@ grep -r "username.*:" test-html/ || echo "Good - no hardcoded use
|
|
|
575
579
|
<h3>Step 19: Cross-Platform Testing</h3>
|
|
576
580
|
<p>If possible, test on different systems:</p>
|
|
577
581
|
<ul>
|
|
578
|
-
<li><strong>macOS</strong>: Current system <i class="ph ph-check-circle" aria-label="checked"></i></li>
|
|
582
|
+
<li><strong>macOS</strong>: Current system <i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i></li>
|
|
579
583
|
<li><strong>Windows</strong>: Test in WSL or Windows machine</li>
|
|
580
584
|
<li><strong>Linux</strong>: Test in Docker or Linux VM</li>
|
|
581
585
|
</ul>
|
|
@@ -594,7 +598,7 @@ find docs/ -name "*.md" -exec grep -l "]\(" {} \;
|
|
|
594
598
|
</ul>
|
|
595
599
|
</li>
|
|
596
600
|
</ol>
|
|
597
|
-
<h2><i class="ph ph-target" aria-label="goal"></i> Success Criteria Checklist</h2>
|
|
601
|
+
<h2><i style="font-size: 1.2em" class="ph ph-target" aria-label="goal"></i> Success Criteria Checklist</h2>
|
|
598
602
|
<p>Before considering deployment ready:</p>
|
|
599
603
|
<h3>Functionality</h3>
|
|
600
604
|
<ul>
|
|
@@ -628,7 +632,7 @@ find docs/ -name "*.md" -exec grep -l "]\(" {} \;
|
|
|
628
632
|
<li><input disabled="" type="checkbox"> Environment variable support</li>
|
|
629
633
|
<li><input disabled="" type="checkbox"> Cross-platform functionality</li>
|
|
630
634
|
</ul>
|
|
631
|
-
<h2><i class="ph ph-siren" aria-label="alert"></i> Issues to Watch For</h2>
|
|
635
|
+
<h2><i style="font-size: 1.2em" class="ph ph-siren" aria-label="alert"></i> Issues to Watch For</h2>
|
|
632
636
|
<h3>Common Problems</h3>
|
|
633
637
|
<ol>
|
|
634
638
|
<li><strong>Supabase URL format errors</strong> - Must be <code>https://xxx.supabase.co</code></li>
|
|
@@ -6,6 +6,7 @@
|
|
|
6
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
7
|
<title>Supabase Authentication Implementation - COMPLE...</title>
|
|
8
8
|
|
|
9
|
+
<meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
|
|
9
10
|
<meta name="author" content="Lindsay Smith">
|
|
10
11
|
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, supabase, authentication">
|
|
11
12
|
<meta name="robots" content="index, follow">
|
|
@@ -98,8 +99,8 @@
|
|
|
98
99
|
"name": "Knowcode Ltd",
|
|
99
100
|
"url": "https://knowcode.tech"
|
|
100
101
|
},
|
|
101
|
-
"datePublished": "2025-07-
|
|
102
|
-
"dateModified": "2025-07-
|
|
102
|
+
"datePublished": "2025-07-31T07:08:27.412Z",
|
|
103
|
+
"dateModified": "2025-07-31T07:08:27.412Z",
|
|
103
104
|
"mainEntityOfPage": {
|
|
104
105
|
"@type": "WebPage",
|
|
105
106
|
"@id": "https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html"
|
|
@@ -138,7 +139,7 @@
|
|
|
138
139
|
|
|
139
140
|
<div class="header-actions">
|
|
140
141
|
<div class="deployment-info">
|
|
141
|
-
<span class="deployment-date" title="Built with doc-builder v1.9.
|
|
142
|
+
<span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
|
|
142
143
|
</div>
|
|
143
144
|
|
|
144
145
|
|
|
@@ -204,6 +205,7 @@
|
|
|
204
205
|
<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="ph ph-file-text"></i> Authentication Default Change</a>
|
|
205
206
|
<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="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
|
|
206
207
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
|
|
208
|
+
<a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration Guide</a>
|
|
207
209
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
|
|
208
210
|
<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="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
|
|
209
211
|
<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="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
|
|
@@ -214,6 +216,7 @@
|
|
|
214
216
|
<a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
|
|
215
217
|
<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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
|
|
216
218
|
<a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
|
|
219
|
+
<a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete Guide</a>
|
|
217
220
|
<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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
|
|
218
221
|
<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="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
|
|
219
222
|
<div class="nav-section private-nav" data-level="1">
|
|
@@ -245,6 +248,7 @@
|
|
|
245
248
|
<i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
|
|
246
249
|
</a>
|
|
247
250
|
<div class="nav-content collapsed" id="nav-prompts-1">
|
|
251
|
+
<a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
|
|
248
252
|
<a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
|
|
249
253
|
</nav>
|
|
250
254
|
<div class="resize-handle"></div>
|
|
@@ -253,30 +257,30 @@
|
|
|
253
257
|
<!-- Content Area -->
|
|
254
258
|
<main class="content">
|
|
255
259
|
<div class="content-inner">
|
|
256
|
-
<h1>Supabase Authentication Implementation - COMPLETED <i class="ph ph-check-circle" aria-label="checked"></i></h1>
|
|
260
|
+
<h1>Supabase Authentication Implementation - COMPLETED <i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i></h1>
|
|
257
261
|
<h2>Overview</h2>
|
|
258
262
|
<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>
|
|
259
263
|
<h2>What Was Achieved</h2>
|
|
260
264
|
<h3>1. Complete Removal of Old System</h3>
|
|
261
265
|
<ul>
|
|
262
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Removed all client-side credential checking</li>
|
|
263
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Deleted old auth.js files</li>
|
|
264
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Cleaned up configuration options</li>
|
|
265
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Updated all documentation</li>
|
|
266
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Removed all client-side credential checking</li>
|
|
267
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Deleted old auth.js files</li>
|
|
268
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Cleaned up configuration options</li>
|
|
269
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Updated all documentation</li>
|
|
266
270
|
</ul>
|
|
267
271
|
<h3>2. Supabase Integration</h3>
|
|
268
272
|
<ul>
|
|
269
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> JWT-based authentication</li>
|
|
270
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Row Level Security (RLS) </li>
|
|
271
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Multi-user support</li>
|
|
272
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Fine-grained access control</li>
|
|
273
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Session management</li>
|
|
273
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> JWT-based authentication</li>
|
|
274
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Row Level Security (RLS) </li>
|
|
275
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Multi-user support</li>
|
|
276
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Fine-grained access control</li>
|
|
277
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Session management</li>
|
|
274
278
|
</ul>
|
|
275
279
|
<h3>3. Default Behavior Change</h3>
|
|
276
280
|
<ul>
|
|
277
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Authentication now <strong>disabled by default</strong></li>
|
|
278
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Public documentation works out of the box</li>
|
|
279
|
-
<li><i class="ph ph-check-circle" aria-label="checked"></i> Authentication must be explicitly enabled</li>
|
|
281
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Authentication now <strong>disabled by default</strong></li>
|
|
282
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Public documentation works out of the box</li>
|
|
283
|
+
<li><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Authentication must be explicitly enabled</li>
|
|
280
284
|
</ul>
|
|
281
285
|
<h2>Current Architecture</h2>
|
|
282
286
|
<div class="mermaid-wrapper">
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
<meta name="description" content="This document outlines the complete plan for integrating Supabase authentication into @knowcode/doc-builder, providing a simple but secure authentication...">
|
|
7
7
|
<title>Supabase Auth Implementation Plan for @knowcode...</title>
|
|
8
8
|
|
|
9
|
+
<meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">
|
|
9
10
|
<meta name="author" content="Lindsay Smith">
|
|
10
11
|
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, auth, supabase">
|
|
11
12
|
<meta name="robots" content="index, follow">
|
|
@@ -98,8 +99,8 @@
|
|
|
98
99
|
"name": "Knowcode Ltd",
|
|
99
100
|
"url": "https://knowcode.tech"
|
|
100
101
|
},
|
|
101
|
-
"datePublished": "2025-07-
|
|
102
|
-
"dateModified": "2025-07-
|
|
102
|
+
"datePublished": "2025-07-31T07:08:27.415Z",
|
|
103
|
+
"dateModified": "2025-07-31T07:08:27.415Z",
|
|
103
104
|
"mainEntityOfPage": {
|
|
104
105
|
"@type": "WebPage",
|
|
105
106
|
"@id": "https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-plan.html"
|
|
@@ -138,7 +139,7 @@
|
|
|
138
139
|
|
|
139
140
|
<div class="header-actions">
|
|
140
141
|
<div class="deployment-info">
|
|
141
|
-
<span class="deployment-date" title="Built with doc-builder v1.9.
|
|
142
|
+
<span class="deployment-date" title="Built with doc-builder v1.9.11">Last updated: Jul 31, 2025, 07:08 AM UTC</span>
|
|
142
143
|
</div>
|
|
143
144
|
|
|
144
145
|
|
|
@@ -204,6 +205,7 @@
|
|
|
204
205
|
<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="ph ph-file-text"></i> Authentication Default Change</a>
|
|
205
206
|
<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="ph ph-check-circle" style="color: #059669;"></i> Authentication Guide</a>
|
|
206
207
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Claude Workflow Guide</a>
|
|
208
|
+
<a href="/guides/configuration-guide.html" class="nav-item" data-tooltip="This guide explains how @knowcode/doc-builder handles configuration files and settings."><i class="ph ph-check-circle" style="color: #059669;"></i> Configuration Guide</a>
|
|
207
209
|
<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="ph ph-pencil-simple" style="color: #d97706;"></i> Documentation Standards</a>
|
|
208
210
|
<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="ph ph-check-circle" style="color: #059669;"></i> Html Embedding Guide</a>
|
|
209
211
|
<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="ph ph-check-circle" style="color: #059669;"></i> Image Modal Guide</a>
|
|
@@ -214,6 +216,7 @@
|
|
|
214
216
|
<a href="/guides/search-engine-verification-guide.html" class="nav-item" data-tooltip="Search engine verification provides access to powerful webmaster tools:."><i class="ph ph-check-circle" style="color: #059669;"></i> Search Engine Verification Guide</a>
|
|
215
217
|
<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="ph ph-check-circle" style="color: #059669;"></i> Seo Guide</a>
|
|
216
218
|
<a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Comprehensive guide to optimizing documentation for search engines. Learn SEO best practices, use built-in features, and improve your rankings."><i class="ph ph-check-circle" style="color: #059669;"></i> Seo Optimization Guide</a>
|
|
219
|
+
<a href="/guides/supabase-authentication-complete-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes built-in Supabase authentication that provides enterprise-grade security with zero configuration."><i class="ph ph-check-circle" style="color: #059669;"></i> Supabase Authentication Complete Guide</a>
|
|
217
220
|
<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="ph ph-check-circle" style="color: #059669;"></i> Troubleshooting Guide</a>
|
|
218
221
|
<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="ph ph-check-circle" style="color: #059669;"></i> Windows Setup Guide</a></div></div>
|
|
219
222
|
<div class="nav-section private-nav" data-level="1">
|
|
@@ -245,6 +248,7 @@
|
|
|
245
248
|
<i class="ph ph-caret-right collapse-icon"></i><i class="ph ph-chat-circle-dots"></i> Prompts
|
|
246
249
|
</a>
|
|
247
250
|
<div class="nav-content collapsed" id="nav-prompts-1">
|
|
251
|
+
<a href="/prompts/beautiful-documentation-design.html" class="nav-item" data-tooltip="🎨 Beautiful Documentation Design Guide."><i class="ph ph-check-circle" style="color: #059669;"></i> Beautiful Documentation Design</a>
|
|
248
252
|
<a href="/prompts/markdown-document-standards.html" class="nav-item" data-tooltip="Detailed introduction to the topic..."><i class="ph ph-pencil-simple" style="color: #d97706;"></i> Markdown Document Standards</a></div></div>
|
|
249
253
|
</nav>
|
|
250
254
|
<div class="resize-handle"></div>
|
|
@@ -518,34 +522,34 @@ npx @knowcode/doc-builder auth:list-sites --email user@example.com
|
|
|
518
522
|
<li><strong>Security</strong>: Follow Supabase best practices</li>
|
|
519
523
|
<li><strong>Support</strong>: Provide clear documentation and migration guide</li>
|
|
520
524
|
</ol>
|
|
521
|
-
<h2><i class="ph ph-check-circle" aria-label="checked"></i> Implementation Status: COMPLETE</h2>
|
|
525
|
+
<h2><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Implementation Status: COMPLETE</h2>
|
|
522
526
|
<p>All planned phases have been successfully implemented:</p>
|
|
523
|
-
<h3><i class="ph ph-check-circle" aria-label="checked"></i> Phase 1: Core Infrastructure - COMPLETE</h3>
|
|
527
|
+
<h3><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Phase 1: Core Infrastructure - COMPLETE</h3>
|
|
524
528
|
<ul>
|
|
525
529
|
<li><input checked="" disabled="" type="checkbox"> Updated configuration system to remove basic auth</li>
|
|
526
530
|
<li><input checked="" disabled="" type="checkbox"> Added Supabase SDK dependency</li>
|
|
527
531
|
<li><input checked="" disabled="" type="checkbox"> Created Supabase auth module (<code>lib/supabase-auth.js</code>)</li>
|
|
528
532
|
<li><input checked="" disabled="" type="checkbox"> Updated core-builder.js integration</li>
|
|
529
533
|
</ul>
|
|
530
|
-
<h3><i class="ph ph-check-circle" aria-label="checked"></i> Phase 2: Client-Side Implementation - COMPLETE</h3>
|
|
534
|
+
<h3><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Phase 2: Client-Side Implementation - COMPLETE</h3>
|
|
531
535
|
<ul>
|
|
532
536
|
<li><input checked="" disabled="" type="checkbox"> Generated Supabase auth script replaces basic auth</li>
|
|
533
537
|
<li><input checked="" disabled="" type="checkbox"> Secure login page with Supabase integration</li>
|
|
534
538
|
<li><input checked="" disabled="" type="checkbox"> Logout functionality with proper session cleanup</li>
|
|
535
539
|
</ul>
|
|
536
|
-
<h3><i class="ph ph-check-circle" aria-label="checked"></i> Phase 3: Build Process Updates - COMPLETE</h3>
|
|
540
|
+
<h3><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Phase 3: Build Process Updates - COMPLETE</h3>
|
|
537
541
|
<ul>
|
|
538
542
|
<li><input checked="" disabled="" type="checkbox"> Supabase SDK integration in build output</li>
|
|
539
543
|
<li><input checked="" disabled="" type="checkbox"> Environment variable support</li>
|
|
540
544
|
<li><input checked="" disabled="" type="checkbox"> Build validation and error handling</li>
|
|
541
545
|
</ul>
|
|
542
|
-
<h3><i class="ph ph-check-circle" aria-label="checked"></i> Phase 4: User Management Tools - COMPLETE</h3>
|
|
546
|
+
<h3><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Phase 4: User Management Tools - COMPLETE</h3>
|
|
543
547
|
<ul>
|
|
544
548
|
<li><input checked="" disabled="" type="checkbox"> CLI commands: <code>auth:init</code>, <code>auth:add-site</code>, <code>auth:grant</code>, <code>auth:revoke</code>, <code>auth:list-users</code></li>
|
|
545
549
|
<li><input checked="" disabled="" type="checkbox"> Updated settings command to show Supabase config</li>
|
|
546
550
|
<li><input checked="" disabled="" type="checkbox"> Removed insecure <code>--no-auth</code> flag</li>
|
|
547
551
|
</ul>
|
|
548
|
-
<h3><i class="ph ph-check-circle" aria-label="checked"></i> Phase 5: Documentation and Migration - COMPLETE</h3>
|
|
552
|
+
<h3><i style="font-size: 1.2em" class="ph ph-check-circle" aria-label="checked"></i> Phase 5: Documentation and Migration - COMPLETE</h3>
|
|
549
553
|
<ul>
|
|
550
554
|
<li><input checked="" disabled="" type="checkbox"> Comprehensive Supabase setup guide created</li>
|
|
551
555
|
<li><input checked="" disabled="" type="checkbox"> Updated main README with new auth information</li>
|