@knowcode/doc-builder 1.7.4 → 1.7.5
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/.claude/settings.local.json +6 -1
- package/CHANGELOG.md +18 -0
- package/README.md +23 -6
- package/RELEASE-NOTES-1.7.5.md +64 -0
- package/cli.js +214 -7
- package/grant-access.sql +15 -0
- package/html/README.html +14 -4
- package/html/auth.js +97 -0
- package/html/documentation-index.html +14 -4
- package/html/guides/authentication-default-change.html +302 -0
- package/html/guides/authentication-guide.html +32 -14
- package/html/guides/cache-control-anti-pattern.html +361 -0
- package/html/guides/claude-workflow-guide.html +14 -4
- package/html/guides/documentation-standards.html +14 -4
- package/html/guides/next-steps-walkthrough.html +638 -0
- package/html/guides/phosphor-icons-guide.html +14 -4
- package/html/guides/public-site-deployment.html +363 -0
- package/html/guides/search-engine-verification-guide.html +14 -4
- package/html/guides/seo-guide.html +14 -4
- package/html/guides/seo-optimization-guide.html +14 -4
- package/html/guides/supabase-auth-implementation-plan.html +543 -0
- package/html/guides/supabase-auth-integration-plan.html +671 -0
- package/html/guides/supabase-auth-setup-guide.html +498 -0
- package/html/guides/troubleshooting-guide.html +14 -4
- package/html/guides/vercel-deployment-auth-setup.html +337 -0
- package/html/guides/windows-setup-guide.html +14 -4
- package/html/index.html +14 -4
- package/html/launch/README.html +14 -4
- package/html/launch/bubble-plugin-specification.html +14 -4
- package/html/launch/go-to-market-strategy.html +14 -4
- package/html/launch/launch-announcements.html +14 -4
- package/html/login.html +102 -0
- package/html/logout.html +18 -0
- package/html/sitemap.xml +69 -21
- package/html/vercel-cli-setup-guide.html +14 -4
- package/html/vercel-first-time-setup-guide.html +14 -4
- package/lib/config.js +11 -26
- package/lib/core-builder.js +51 -87
- package/lib/supabase-auth.js +295 -0
- package/package.json +2 -1
- package/public-config.js +22 -0
- package/public-html/404.html +115 -0
- package/public-html/README.html +149 -0
- package/public-html/css/notion-style.css +2036 -0
- package/public-html/index.html +149 -0
- package/public-html/js/auth.js +67 -0
- package/public-html/js/main.js +1485 -0
- package/quick-test-commands.md +40 -0
- package/recordings/Screenshot 2025-07-24 at 18.22.01.png +0 -0
- package/setup-database.sql +41 -0
- package/test-auth-config.js +17 -0
- package/test-docs/README.md +39 -0
- package/test-html/404.html +115 -0
- package/test-html/README.html +172 -0
- package/test-html/auth.js +97 -0
- package/test-html/css/notion-style.css +2036 -0
- package/test-html/index.html +172 -0
- package/test-html/js/auth.js +97 -0
- package/test-html/js/main.js +1485 -0
- package/test-html/login.html +102 -0
- package/test-html/logout.html +18 -0
- package/update-domain.sql +9 -0
|
@@ -45,6 +45,8 @@
|
|
|
45
45
|
<!-- Styles -->
|
|
46
46
|
<link rel="stylesheet" href="/css/notion-style.css">
|
|
47
47
|
|
|
48
|
+
|
|
49
|
+
|
|
48
50
|
<!-- Favicon -->
|
|
49
51
|
<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>">
|
|
50
52
|
|
|
@@ -63,8 +65,8 @@
|
|
|
63
65
|
"name": "Knowcode Ltd",
|
|
64
66
|
"url": "https://knowcode.tech"
|
|
65
67
|
},
|
|
66
|
-
"datePublished": "2025-07-
|
|
67
|
-
"dateModified": "2025-07-
|
|
68
|
+
"datePublished": "2025-07-25T13:01:14.166Z",
|
|
69
|
+
"dateModified": "2025-07-25T13:01:14.166Z",
|
|
68
70
|
"mainEntityOfPage": {
|
|
69
71
|
"@type": "WebPage",
|
|
70
72
|
"@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
|
|
@@ -97,7 +99,7 @@
|
|
|
97
99
|
|
|
98
100
|
<div class="header-actions">
|
|
99
101
|
<div class="deployment-info">
|
|
100
|
-
<span class="deployment-date" title="Built with doc-builder v1.7.
|
|
102
|
+
<span class="deployment-date" title="Built with doc-builder v1.7.5">Last updated: Jul 25, 2025, 01:01 PM UTC</span>
|
|
101
103
|
</div>
|
|
102
104
|
|
|
103
105
|
|
|
@@ -155,14 +157,22 @@
|
|
|
155
157
|
<i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
|
|
156
158
|
</a>
|
|
157
159
|
<div class="nav-content collapsed" id="nav-guides-1">
|
|
158
|
-
<a href="/guides/authentication-
|
|
160
|
+
<a href="/guides/authentication-default-change.html" class="nav-item" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="fas fa-file-alt"></i> Authentication Default Change</a>
|
|
161
|
+
<a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="🚨 This authentication method has been REMOVED in version 2.0.0 due to serious security flaws."><i class="fas fa-file-alt"></i> Authentication Guide</a>
|
|
162
|
+
<a href="/guides/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
|
|
159
163
|
<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>
|
|
160
164
|
<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>
|
|
165
|
+
<a href="/guides/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we've implemented Supabase authentication, let's walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
|
|
161
166
|
<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>
|
|
167
|
+
<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>
|
|
162
168
|
<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>
|
|
163
169
|
<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>
|
|
164
170
|
<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>
|
|
171
|
+
<a href="/guides/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
|
|
172
|
+
<a href="/guides/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
|
|
173
|
+
<a href="/guides/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder now supports enterprise-grade authentication through Supabase, replacing the previous insecure basic authentication."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
|
|
165
174
|
<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>
|
|
175
|
+
<a href="/guides/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a>
|
|
166
176
|
<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>
|
|
167
177
|
<div class="nav-section" data-level="1">
|
|
168
178
|
<a class="nav-title collapsible" href="/launch/README.html" data-target="nav-launch-1" >
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<meta name="description" content="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites. This change makes it easier to deploy...">
|
|
7
|
+
<title>Authentication Default Change | @knowcode/doc-builder</title>
|
|
8
|
+
|
|
9
|
+
<meta name="author" content="Lindsay Smith">
|
|
10
|
+
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, authentication, public">
|
|
11
|
+
<meta name="robots" content="index, follow">
|
|
12
|
+
<link rel="canonical" href="https://doc-builder-delta.vercel.app/guides/authentication-default-change.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/guides/authentication-default-change.html">
|
|
17
|
+
<meta property="og:title" content="Authentication Default Change | @knowcode/doc-builder">
|
|
18
|
+
<meta property="og:description" content="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites. This change makes it easier to deploy...">
|
|
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="Authentication Default Change | @knowcode/doc-builder">
|
|
28
|
+
<meta name="twitter:description" content="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites. This change makes it easier to deploy...">
|
|
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">
|
|
34
|
+
|
|
35
|
+
<!-- Fonts -->
|
|
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">
|
|
37
|
+
|
|
38
|
+
<!-- Icons -->
|
|
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">
|
|
41
|
+
|
|
42
|
+
<!-- Mermaid -->
|
|
43
|
+
<script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
|
|
44
|
+
|
|
45
|
+
<!-- Styles -->
|
|
46
|
+
<link rel="stylesheet" href="/css/notion-style.css">
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
<!-- Favicon -->
|
|
51
|
+
<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>">
|
|
52
|
+
|
|
53
|
+
<script type="application/ld+json">
|
|
54
|
+
{
|
|
55
|
+
"@context": "https://schema.org",
|
|
56
|
+
"@type": "TechArticle",
|
|
57
|
+
"headline": "Authentication Default Change",
|
|
58
|
+
"description": "Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites. This change makes it easier to deploy...",
|
|
59
|
+
"author": {
|
|
60
|
+
"@type": "Person",
|
|
61
|
+
"name": "Lindsay Smith"
|
|
62
|
+
},
|
|
63
|
+
"publisher": {
|
|
64
|
+
"@type": "Organization",
|
|
65
|
+
"name": "Knowcode Ltd",
|
|
66
|
+
"url": "https://knowcode.tech"
|
|
67
|
+
},
|
|
68
|
+
"datePublished": "2025-07-25T13:01:14.170Z",
|
|
69
|
+
"dateModified": "2025-07-25T13:01:14.170Z",
|
|
70
|
+
"mainEntityOfPage": {
|
|
71
|
+
"@type": "WebPage",
|
|
72
|
+
"@id": "https://doc-builder-delta.vercel.app/guides/authentication-default-change.html"
|
|
73
|
+
},
|
|
74
|
+
"breadcrumb": {
|
|
75
|
+
"@type": "BreadcrumbList",
|
|
76
|
+
"itemListElement": [
|
|
77
|
+
{
|
|
78
|
+
"@type": "ListItem",
|
|
79
|
+
"position": 1,
|
|
80
|
+
"name": "@knowcode/doc-builder",
|
|
81
|
+
"item": "https://doc-builder-delta.vercel.app"
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"@type": "ListItem",
|
|
85
|
+
"position": 2,
|
|
86
|
+
"name": "Guides",
|
|
87
|
+
"item": "https://doc-builder-delta.vercel.app/guides/"
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"@type": "ListItem",
|
|
91
|
+
"position": 3,
|
|
92
|
+
"name": "Authentication Default Change",
|
|
93
|
+
"item": "https://doc-builder-delta.vercel.app/guides/authentication-default-change.html"
|
|
94
|
+
}
|
|
95
|
+
]
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
</script>
|
|
99
|
+
</head>
|
|
100
|
+
<body>
|
|
101
|
+
<!-- Header -->
|
|
102
|
+
<header class="header">
|
|
103
|
+
<div class="header-content">
|
|
104
|
+
<a href="/index.html" class="logo">@knowcode/doc-builder</a>
|
|
105
|
+
|
|
106
|
+
<div class="header-actions">
|
|
107
|
+
<div class="deployment-info">
|
|
108
|
+
<span class="deployment-date" title="Built with doc-builder v1.7.5">Last updated: Jul 25, 2025, 01:01 PM UTC</span>
|
|
109
|
+
</div>
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
<button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
|
|
114
|
+
<i class="fas fa-moon"></i>
|
|
115
|
+
</button>
|
|
116
|
+
|
|
117
|
+
<button id="menu-toggle" class="menu-toggle" aria-label="Toggle menu">
|
|
118
|
+
<i class="fas fa-bars"></i>
|
|
119
|
+
</button>
|
|
120
|
+
</div>
|
|
121
|
+
</div>
|
|
122
|
+
</header>
|
|
123
|
+
|
|
124
|
+
<!-- Preview Banner -->
|
|
125
|
+
<div id="preview-banner" class="preview-banner">
|
|
126
|
+
<div class="banner-content">
|
|
127
|
+
<i class="fas fa-exclamation-triangle banner-icon"></i>
|
|
128
|
+
<span class="banner-text">This documentation is a preview version - some content may be incomplete</span>
|
|
129
|
+
<button id="dismiss-banner" class="banner-dismiss" aria-label="Dismiss banner">
|
|
130
|
+
<i class="fas fa-times"></i>
|
|
131
|
+
</button>
|
|
132
|
+
</div>
|
|
133
|
+
</div>
|
|
134
|
+
|
|
135
|
+
<!-- Breadcrumbs -->
|
|
136
|
+
<nav class="breadcrumbs" id="breadcrumbs">
|
|
137
|
+
<!-- Breadcrumbs will be generated by JavaScript -->
|
|
138
|
+
</nav>
|
|
139
|
+
|
|
140
|
+
<!-- Main Content -->
|
|
141
|
+
<div class="main-wrapper">
|
|
142
|
+
<!-- Sidebar -->
|
|
143
|
+
<aside class="sidebar">
|
|
144
|
+
<div class="sidebar-header">
|
|
145
|
+
<div class="filter-box">
|
|
146
|
+
<input type="text" placeholder="Filter items..." class="filter-input" id="nav-filter">
|
|
147
|
+
<i class="fas fa-search filter-icon"></i>
|
|
148
|
+
</div>
|
|
149
|
+
</div>
|
|
150
|
+
<nav class="navigation">
|
|
151
|
+
|
|
152
|
+
<div class="nav-section" data-level="0">
|
|
153
|
+
<a class="nav-title" href="/README.html" >
|
|
154
|
+
<i class="fas fa-home"></i> Documentation
|
|
155
|
+
</a>
|
|
156
|
+
<div class="nav-content" >
|
|
157
|
+
<a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
|
|
158
|
+
<a href="/documentation-index.html" class="nav-item" data-tooltip="This directory contains additional documentation for the @knowcode/doc-builder project, organized by topic and purpose."><i class="fas fa-file-alt"></i> Documentation Index</a>
|
|
159
|
+
<a href="/vercel-cli-setup-guide.html" class="nav-item" data-tooltip="This guide provides comprehensive instructions for installing the Vercel CLI across different operating systems."><i class="fas fa-file-alt"></i> Vercel Cli Setup Guide</a>
|
|
160
|
+
<a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the Vercel deployment process when using ."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
|
|
161
|
+
<div class="nav-section" data-level="1">
|
|
162
|
+
<a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
|
|
163
|
+
<i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
|
|
164
|
+
</a>
|
|
165
|
+
<div class="nav-content" id="nav-guides-1">
|
|
166
|
+
<a href="/guides/authentication-default-change.html" class="nav-item active" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="fas fa-file-alt"></i> Authentication Default Change</a>
|
|
167
|
+
<a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="🚨 This authentication method has been REMOVED in version 2.0.0 due to serious security flaws."><i class="fas fa-file-alt"></i> Authentication Guide</a>
|
|
168
|
+
<a href="/guides/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
|
|
169
|
+
<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>
|
|
170
|
+
<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>
|
|
171
|
+
<a href="/guides/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we've implemented Supabase authentication, let's walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
|
|
172
|
+
<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>
|
|
173
|
+
<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>
|
|
174
|
+
<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>
|
|
175
|
+
<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>
|
|
176
|
+
<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>
|
|
177
|
+
<a href="/guides/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
|
|
178
|
+
<a href="/guides/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
|
|
179
|
+
<a href="/guides/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder now supports enterprise-grade authentication through Supabase, replacing the previous insecure basic authentication."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
|
|
180
|
+
<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>
|
|
181
|
+
<a href="/guides/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a>
|
|
182
|
+
<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>
|
|
183
|
+
<div class="nav-section" data-level="1">
|
|
184
|
+
<a class="nav-title collapsible" href="/launch/README.html" data-target="nav-launch-1" >
|
|
185
|
+
<i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Launch
|
|
186
|
+
</a>
|
|
187
|
+
<div class="nav-content collapsed" id="nav-launch-1">
|
|
188
|
+
<a href="/launch/README.html" class="nav-item" data-tooltip="This directory contains all documentation related to the commercial launch of @knowcode/doc-builder, including go-to-market strategy, platform..."><i class="fas fa-file-alt"></i> Launch Overview</a>
|
|
189
|
+
<a href="/launch/bubble-plugin-specification.html" class="nav-item" data-tooltip="This document outlines the technical specification for creating a Bubble.io plugin that integrates @knowcode/doc-builder, enabling Bubble developers..."><i class="fas fa-file-alt"></i> Bubble Plugin Specification</a>
|
|
190
|
+
<a href="/launch/go-to-market-strategy.html" class="nav-item" data-tooltip="Go-to-Market Strategy & Product Launch Plan."><i class="fas fa-file-alt"></i> Go To Market Strategy</a>
|
|
191
|
+
<a href="/launch/launch-announcements.html" class="nav-item" data-tooltip="This document contains ready-to-use announcement templates for launching @knowcode/doc-builder across various platforms and channels."><i class="fas fa-file-alt"></i> Launch Announcements</a></div></div>
|
|
192
|
+
</nav>
|
|
193
|
+
<div class="resize-handle"></div>
|
|
194
|
+
</aside>
|
|
195
|
+
|
|
196
|
+
<!-- Content Area -->
|
|
197
|
+
<main class="content">
|
|
198
|
+
<div class="content-inner">
|
|
199
|
+
<h1>Authentication Default Change</h1>
|
|
200
|
+
<h2>Overview</h2>
|
|
201
|
+
<p>Starting from version 1.7.4, @knowcode/doc-builder now defaults to <strong>no authentication</strong> for all documentation sites. This change makes it easier to deploy public documentation without additional configuration.</p>
|
|
202
|
+
<h2>What Changed</h2>
|
|
203
|
+
<h3>Before (v1.7.3 and earlier)</h3>
|
|
204
|
+
<ul>
|
|
205
|
+
<li>Authentication was enabled by default in some presets</li>
|
|
206
|
+
<li>Users had to explicitly disable it for public sites</li>
|
|
207
|
+
<li>Could cause confusion when deploying public documentation</li>
|
|
208
|
+
</ul>
|
|
209
|
+
<h3>Now (v1.7.4+)</h3>
|
|
210
|
+
<ul>
|
|
211
|
+
<li><strong>No authentication by default</strong> in all configurations</li>
|
|
212
|
+
<li>Authentication must be explicitly enabled when needed</li>
|
|
213
|
+
<li>Public documentation works out of the box</li>
|
|
214
|
+
</ul>
|
|
215
|
+
<h2>Default Configuration</h2>
|
|
216
|
+
<pre><code class="language-javascript">// Default config now has authentication disabled
|
|
217
|
+
features: {
|
|
218
|
+
authentication: false, // No auth by default
|
|
219
|
+
// ... other features
|
|
220
|
+
}
|
|
221
|
+
</code></pre>
|
|
222
|
+
<h2>Enabling Authentication</h2>
|
|
223
|
+
<p>To enable Supabase authentication, explicitly set it in your config:</p>
|
|
224
|
+
<pre><code class="language-javascript">// doc-builder.config.js
|
|
225
|
+
module.exports = {
|
|
226
|
+
features: {
|
|
227
|
+
authentication: 'supabase' // Enable Supabase auth
|
|
228
|
+
},
|
|
229
|
+
auth: {
|
|
230
|
+
supabaseUrl: 'https://xxx.supabase.co',
|
|
231
|
+
supabaseAnonKey: 'your-anon-key',
|
|
232
|
+
siteId: 'your-site-id'
|
|
233
|
+
}
|
|
234
|
+
};
|
|
235
|
+
</code></pre>
|
|
236
|
+
<h2>CLI Behavior</h2>
|
|
237
|
+
<h3>Building/Deploying Public Sites (Default)</h3>
|
|
238
|
+
<pre><code class="language-bash"># These now build/deploy public sites by default
|
|
239
|
+
npx @knowcode/doc-builder build
|
|
240
|
+
npx @knowcode/doc-builder deploy
|
|
241
|
+
</code></pre>
|
|
242
|
+
<h3>Building/Deploying Private Sites</h3>
|
|
243
|
+
<pre><code class="language-bash"># Use a config file with authentication enabled
|
|
244
|
+
npx @knowcode/doc-builder build -c private-config.js
|
|
245
|
+
npx @knowcode/doc-builder deploy -c private-config.js
|
|
246
|
+
</code></pre>
|
|
247
|
+
<h3>Forcing Public Build (Override Config)</h3>
|
|
248
|
+
<pre><code class="language-bash"># Use --no-auth to force public build even if config has auth
|
|
249
|
+
npx @knowcode/doc-builder build --no-auth
|
|
250
|
+
npx @knowcode/doc-builder deploy --no-auth
|
|
251
|
+
</code></pre>
|
|
252
|
+
<h2>Migration Guide</h2>
|
|
253
|
+
<h3>If You Want Public Documentation</h3>
|
|
254
|
+
<p>No changes needed! Your sites will now be public by default.</p>
|
|
255
|
+
<h3>If You Want Private Documentation</h3>
|
|
256
|
+
<p>Add authentication to your config file:</p>
|
|
257
|
+
<pre><code class="language-javascript">// doc-builder.config.js
|
|
258
|
+
module.exports = {
|
|
259
|
+
siteName: 'Private Documentation',
|
|
260
|
+
features: {
|
|
261
|
+
authentication: 'supabase'
|
|
262
|
+
},
|
|
263
|
+
auth: {
|
|
264
|
+
supabaseUrl: process.env.SUPABASE_URL,
|
|
265
|
+
supabaseAnonKey: process.env.SUPABASE_ANON_KEY,
|
|
266
|
+
siteId: process.env.DOC_SITE_ID
|
|
267
|
+
}
|
|
268
|
+
};
|
|
269
|
+
</code></pre>
|
|
270
|
+
<h2>Best Practices</h2>
|
|
271
|
+
<ol>
|
|
272
|
+
<li><strong>Public by Default</strong>: Most documentation should be public</li>
|
|
273
|
+
<li><strong>Explicit Auth</strong>: Only enable authentication when truly needed</li>
|
|
274
|
+
<li><strong>Environment Variables</strong>: Use env vars for auth credentials</li>
|
|
275
|
+
<li><strong>Separate Configs</strong>: Use different config files for public/private versions</li>
|
|
276
|
+
</ol>
|
|
277
|
+
<h2>Summary</h2>
|
|
278
|
+
<ul>
|
|
279
|
+
<li>Authentication is now <strong>disabled by default</strong></li>
|
|
280
|
+
<li>Public documentation works without any auth configuration</li>
|
|
281
|
+
<li>Enable authentication explicitly when needed with <code>authentication: 'supabase'</code></li>
|
|
282
|
+
<li>Use <code>--no-auth</code> flag to override authentication in configs</li>
|
|
283
|
+
</ul>
|
|
284
|
+
|
|
285
|
+
</div>
|
|
286
|
+
</main>
|
|
287
|
+
</div>
|
|
288
|
+
|
|
289
|
+
<!-- Scripts -->
|
|
290
|
+
<script>
|
|
291
|
+
// Pass configuration to frontend
|
|
292
|
+
window.docBuilderConfig = {
|
|
293
|
+
features: {
|
|
294
|
+
showPdfDownload: true,
|
|
295
|
+
menuDefaultOpen: false
|
|
296
|
+
}
|
|
297
|
+
};
|
|
298
|
+
</script>
|
|
299
|
+
<script src="/js/main.js"></script>
|
|
300
|
+
|
|
301
|
+
</body>
|
|
302
|
+
</html>
|
|
@@ -3,8 +3,8 @@
|
|
|
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="
|
|
7
|
-
<title
|
|
6
|
+
<meta name="description" content="> SECURITY WARNING: This basic authentication method has been deprecated and removed due to security vulnerabilities.">
|
|
7
|
+
<title>⚠️ DEPRECATED: Basic Authentication Guide</title>
|
|
8
8
|
|
|
9
9
|
<meta name="author" content="Lindsay Smith">
|
|
10
10
|
<meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, authentication, login">
|
|
@@ -14,8 +14,8 @@
|
|
|
14
14
|
<!-- Open Graph / Facebook -->
|
|
15
15
|
<meta property="og:type" content="article">
|
|
16
16
|
<meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/authentication-guide.html">
|
|
17
|
-
<meta property="og:title" content="Authentication Guide
|
|
18
|
-
<meta property="og:description" content="
|
|
17
|
+
<meta property="og:title" content="⚠️ DEPRECATED: Basic Authentication Guide">
|
|
18
|
+
<meta property="og:description" content="> SECURITY WARNING: This basic authentication method has been deprecated and removed due to security vulnerabilities.">
|
|
19
19
|
<meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
|
|
20
20
|
<meta property="og:site_name" content="@knowcode/doc-builder">
|
|
21
21
|
<meta property="og:locale" content="en_US">
|
|
@@ -24,8 +24,8 @@
|
|
|
24
24
|
<meta name="twitter:card" content="summary_large_image">
|
|
25
25
|
<meta name="twitter:site" content="@planbbackups">
|
|
26
26
|
<meta name="twitter:creator" content="@planbbackups">
|
|
27
|
-
<meta name="twitter:title" content="Authentication Guide
|
|
28
|
-
<meta name="twitter:description" content="
|
|
27
|
+
<meta name="twitter:title" content="⚠️ DEPRECATED: Basic Authentication Guide">
|
|
28
|
+
<meta name="twitter:description" content="> SECURITY WARNING: This basic authentication method has been deprecated and removed due to security vulnerabilities.">
|
|
29
29
|
<meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
|
|
30
30
|
|
|
31
31
|
<!-- Custom Meta Tags -->
|
|
@@ -45,6 +45,8 @@
|
|
|
45
45
|
<!-- Styles -->
|
|
46
46
|
<link rel="stylesheet" href="/css/notion-style.css">
|
|
47
47
|
|
|
48
|
+
|
|
49
|
+
|
|
48
50
|
<!-- Favicon -->
|
|
49
51
|
<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>">
|
|
50
52
|
|
|
@@ -52,8 +54,8 @@
|
|
|
52
54
|
{
|
|
53
55
|
"@context": "https://schema.org",
|
|
54
56
|
"@type": "TechArticle",
|
|
55
|
-
"headline": "Authentication Guide
|
|
56
|
-
"description": "
|
|
57
|
+
"headline": "⚠️ DEPRECATED: Basic Authentication Guide",
|
|
58
|
+
"description": "> SECURITY WARNING: This basic authentication method has been deprecated and removed due to security vulnerabilities.",
|
|
57
59
|
"author": {
|
|
58
60
|
"@type": "Person",
|
|
59
61
|
"name": "Lindsay Smith"
|
|
@@ -63,8 +65,8 @@
|
|
|
63
65
|
"name": "Knowcode Ltd",
|
|
64
66
|
"url": "https://knowcode.tech"
|
|
65
67
|
},
|
|
66
|
-
"datePublished": "2025-07-
|
|
67
|
-
"dateModified": "2025-07-
|
|
68
|
+
"datePublished": "2025-07-25T13:01:14.175Z",
|
|
69
|
+
"dateModified": "2025-07-25T13:01:14.175Z",
|
|
68
70
|
"mainEntityOfPage": {
|
|
69
71
|
"@type": "WebPage",
|
|
70
72
|
"@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
|
|
@@ -103,7 +105,7 @@
|
|
|
103
105
|
|
|
104
106
|
<div class="header-actions">
|
|
105
107
|
<div class="deployment-info">
|
|
106
|
-
<span class="deployment-date" title="Built with doc-builder v1.7.
|
|
108
|
+
<span class="deployment-date" title="Built with doc-builder v1.7.5">Last updated: Jul 25, 2025, 01:01 PM UTC</span>
|
|
107
109
|
</div>
|
|
108
110
|
|
|
109
111
|
|
|
@@ -161,14 +163,22 @@
|
|
|
161
163
|
<i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
|
|
162
164
|
</a>
|
|
163
165
|
<div class="nav-content" id="nav-guides-1">
|
|
164
|
-
<a href="/guides/authentication-
|
|
166
|
+
<a href="/guides/authentication-default-change.html" class="nav-item" data-tooltip="Starting from version 1.7.4, @knowcode/doc-builder now defaults to no authentication for all documentation sites."><i class="fas fa-file-alt"></i> Authentication Default Change</a>
|
|
167
|
+
<a href="/guides/authentication-guide.html" class="nav-item active" data-tooltip="🚨 This authentication method has been REMOVED in version 2.0.0 due to serious security flaws."><i class="fas fa-file-alt"></i> Authentication Guide</a>
|
|
168
|
+
<a href="/guides/cache-control-anti-pattern.html" class="nav-item" data-tooltip="Cache Control Anti-Pattern: Why Aggressive Cache-Busting is Bad for Documentation Sites."><i class="fas fa-file-alt"></i> Cache Control Anti Pattern</a>
|
|
165
169
|
<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>
|
|
166
170
|
<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>
|
|
171
|
+
<a href="/guides/next-steps-walkthrough.html" class="nav-item" data-tooltip="Now that we've implemented Supabase authentication, let's walk through testing the implementation and preparing for deployment."><i class="fas fa-file-alt"></i> Next Steps Walkthrough</a>
|
|
167
172
|
<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>
|
|
173
|
+
<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>
|
|
168
174
|
<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>
|
|
169
175
|
<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>
|
|
170
176
|
<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>
|
|
177
|
+
<a href="/guides/supabase-auth-implementation-plan.html" class="nav-item" data-tooltip="Supabase Auth Implementation Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Implementation Plan</a>
|
|
178
|
+
<a href="/guides/supabase-auth-integration-plan.html" class="nav-item" data-tooltip="Supabase Authentication Integration Plan for @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Supabase Auth Integration Plan</a>
|
|
179
|
+
<a href="/guides/supabase-auth-setup-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder now supports enterprise-grade authentication through Supabase, replacing the previous insecure basic authentication."><i class="fas fa-file-alt"></i> Supabase Auth Setup Guide</a>
|
|
171
180
|
<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>
|
|
181
|
+
<a href="/guides/vercel-deployment-auth-setup.html" class="nav-item" data-tooltip="Vercel Deployment Authentication Setup Guide."><i class="fas fa-file-alt"></i> Vercel Deployment Auth Setup</a>
|
|
172
182
|
<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>
|
|
173
183
|
<div class="nav-section" data-level="1">
|
|
174
184
|
<a class="nav-title collapsible" href="/launch/README.html" data-target="nav-launch-1" >
|
|
@@ -186,9 +196,17 @@
|
|
|
186
196
|
<!-- Content Area -->
|
|
187
197
|
<main class="content">
|
|
188
198
|
<div class="content-inner">
|
|
189
|
-
<h1>Authentication Guide
|
|
199
|
+
<h1><i class="ph ph-warning-circle" aria-label="warning"></i> DEPRECATED: Basic Authentication Guide</h1>
|
|
200
|
+
<blockquote>
|
|
201
|
+
<p><strong>SECURITY WARNING</strong>: This basic authentication method has been deprecated and removed due to security vulnerabilities. </p>
|
|
202
|
+
<p><strong>Use <a href="supabase-auth-setup-guide.md">Supabase Authentication</a> instead</strong> for secure, enterprise-grade authentication.</p>
|
|
203
|
+
</blockquote>
|
|
204
|
+
<h1>Authentication Guide for @knowcode/doc-builder (DEPRECATED)</h1>
|
|
190
205
|
<h2>Overview</h2>
|
|
191
|
-
<
|
|
206
|
+
<blockquote>
|
|
207
|
+
<p><i class="ph ph-siren" aria-label="alert"></i> <strong>This authentication method has been REMOVED in version 2.0.0</strong> due to serious security flaws. Please migrate to <a href="supabase-auth-setup-guide.md">Supabase Authentication</a>.</p>
|
|
208
|
+
</blockquote>
|
|
209
|
+
<p>This guide explains the old, insecure authentication method that was available in @knowcode/doc-builder v1.x. It has been completely removed for security reasons.</p>
|
|
192
210
|
<h2>What is Authentication?</h2>
|
|
193
211
|
<p>The authentication feature in doc-builder provides a simple way to protect your documentation from unauthorized access. When enabled, users must log in with a username and password before viewing any documentation pages.</p>
|
|
194
212
|
<h3>Features</h3>
|