@knowcode/doc-builder 1.8.0 → 1.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/.claude/settings.local.json +4 -1
  2. package/CHANGELOG.md +24 -0
  3. package/assets/js/main.js +10 -6
  4. package/html/README.html +43 -5
  5. package/html/auth.js +61 -12
  6. package/html/documentation-index.html +43 -5
  7. package/html/guides/authentication-default-change.html +43 -5
  8. package/html/guides/authentication-guide.html +50 -9
  9. package/html/guides/claude-workflow-guide.html +43 -5
  10. package/html/guides/documentation-standards.html +43 -5
  11. package/html/guides/phosphor-icons-guide.html +43 -5
  12. package/html/guides/private-directory-authentication.html +246 -119
  13. package/html/guides/public-site-deployment.html +43 -5
  14. package/html/guides/search-engine-verification-guide.html +43 -5
  15. package/html/guides/seo-guide.html +43 -5
  16. package/html/guides/seo-optimization-guide.html +43 -5
  17. package/html/guides/troubleshooting-guide.html +43 -5
  18. package/html/guides/windows-setup-guide.html +43 -5
  19. package/html/index.html +43 -5
  20. package/html/js/auth.js +118 -39
  21. package/html/js/main.js +10 -6
  22. package/html/login.html +3 -3
  23. package/html/logout.html +2 -2
  24. package/html/private/cache-control-anti-pattern.html +67 -5
  25. package/html/private/launch/README.html +67 -5
  26. package/html/private/launch/auth-cleanup-summary.html +67 -5
  27. package/html/private/launch/bubble-plugin-specification.html +67 -5
  28. package/html/private/launch/go-to-market-strategy.html +67 -5
  29. package/html/private/launch/launch-announcements.html +67 -5
  30. package/html/private/launch/vercel-deployment-auth-setup.html +67 -5
  31. package/html/private/next-steps-walkthrough.html +67 -5
  32. package/html/private/supabase-auth-implementation-completed.html +67 -5
  33. package/html/private/supabase-auth-implementation-plan.html +67 -5
  34. package/html/private/supabase-auth-integration-plan.html +67 -5
  35. package/html/private/supabase-auth-setup-guide.html +67 -5
  36. package/html/private/test-private-doc.html +67 -5
  37. package/html/private/user-management-tooling.html +587 -0
  38. package/html/robots.txt +4 -0
  39. package/html/sitemap.xml +49 -43
  40. package/html/vercel-cli-setup-guide.html +43 -5
  41. package/html/vercel-first-time-setup-guide.html +43 -5
  42. package/lib/config.js +20 -27
  43. package/lib/core-builder.js +9 -1
  44. package/lib/shared-auth-config.js +21 -0
  45. package/lib/supabase-auth.js +20 -14
  46. package/package.json +1 -1
  47. package/user-management/README.md +280 -51
  48. package/user-management/add-users.sh +661 -262
  49. package/user-management/create-user.js +65 -0
package/html/sitemap.xml CHANGED
@@ -2,259 +2,265 @@
2
2
  <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
3
3
  <url>
4
4
  <loc>https://doc-builder-delta.vercel.app/404.html</loc>
5
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
5
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
6
6
  <changefreq>monthly</changefreq>
7
7
  <priority>0.6</priority>
8
8
  </url>
9
9
  <url>
10
10
  <loc>https://doc-builder-delta.vercel.app/README.html</loc>
11
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
11
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
12
12
  <changefreq>monthly</changefreq>
13
13
  <priority>0.6</priority>
14
14
  </url>
15
15
  <url>
16
16
  <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
17
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
17
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
18
18
  <changefreq>monthly</changefreq>
19
19
  <priority>0.8</priority>
20
20
  </url>
21
21
  <url>
22
22
  <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
23
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
23
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
24
24
  <changefreq>monthly</changefreq>
25
25
  <priority>0.6</priority>
26
26
  </url>
27
27
  <url>
28
28
  <loc>https://doc-builder-delta.vercel.app/guides/authentication-default-change.html</loc>
29
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
29
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
30
30
  <changefreq>monthly</changefreq>
31
31
  <priority>0.8</priority>
32
32
  </url>
33
33
  <url>
34
34
  <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
35
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
35
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
36
36
  <changefreq>monthly</changefreq>
37
37
  <priority>0.8</priority>
38
38
  </url>
39
39
  <url>
40
40
  <loc>https://doc-builder-delta.vercel.app/guides/cache-control-anti-pattern.html</loc>
41
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
41
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
42
42
  <changefreq>monthly</changefreq>
43
43
  <priority>0.8</priority>
44
44
  </url>
45
45
  <url>
46
46
  <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
47
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
47
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
48
48
  <changefreq>monthly</changefreq>
49
49
  <priority>0.8</priority>
50
50
  </url>
51
51
  <url>
52
52
  <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
53
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
53
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
54
54
  <changefreq>monthly</changefreq>
55
55
  <priority>0.8</priority>
56
56
  </url>
57
57
  <url>
58
58
  <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
59
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
59
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
60
60
  <changefreq>monthly</changefreq>
61
61
  <priority>0.8</priority>
62
62
  </url>
63
63
  <url>
64
64
  <loc>https://doc-builder-delta.vercel.app/guides/next-steps-walkthrough.html</loc>
65
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
65
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
66
66
  <changefreq>monthly</changefreq>
67
67
  <priority>0.8</priority>
68
68
  </url>
69
69
  <url>
70
70
  <loc>https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html</loc>
71
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
71
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
72
72
  <changefreq>monthly</changefreq>
73
73
  <priority>0.8</priority>
74
74
  </url>
75
75
  <url>
76
76
  <loc>https://doc-builder-delta.vercel.app/guides/private-directory-authentication.html</loc>
77
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
77
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
78
78
  <changefreq>monthly</changefreq>
79
79
  <priority>0.8</priority>
80
80
  </url>
81
81
  <url>
82
82
  <loc>https://doc-builder-delta.vercel.app/guides/public-site-deployment.html</loc>
83
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
83
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
84
84
  <changefreq>monthly</changefreq>
85
85
  <priority>0.8</priority>
86
86
  </url>
87
87
  <url>
88
88
  <loc>https://doc-builder-delta.vercel.app/guides/search-engine-verification-guide.html</loc>
89
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
89
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
90
90
  <changefreq>monthly</changefreq>
91
91
  <priority>0.8</priority>
92
92
  </url>
93
93
  <url>
94
94
  <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
95
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
95
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
96
96
  <changefreq>monthly</changefreq>
97
97
  <priority>0.8</priority>
98
98
  </url>
99
99
  <url>
100
100
  <loc>https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html</loc>
101
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
101
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
102
102
  <changefreq>monthly</changefreq>
103
103
  <priority>0.8</priority>
104
104
  </url>
105
105
  <url>
106
106
  <loc>https://doc-builder-delta.vercel.app/guides/supabase-auth-implementation-plan.html</loc>
107
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
107
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
108
108
  <changefreq>monthly</changefreq>
109
109
  <priority>0.8</priority>
110
110
  </url>
111
111
  <url>
112
112
  <loc>https://doc-builder-delta.vercel.app/guides/supabase-auth-integration-plan.html</loc>
113
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
113
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
114
114
  <changefreq>monthly</changefreq>
115
115
  <priority>0.8</priority>
116
116
  </url>
117
117
  <url>
118
118
  <loc>https://doc-builder-delta.vercel.app/guides/supabase-auth-setup-guide.html</loc>
119
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
119
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
120
120
  <changefreq>monthly</changefreq>
121
121
  <priority>0.8</priority>
122
122
  </url>
123
123
  <url>
124
124
  <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
125
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
125
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
126
126
  <changefreq>monthly</changefreq>
127
127
  <priority>0.8</priority>
128
128
  </url>
129
129
  <url>
130
130
  <loc>https://doc-builder-delta.vercel.app/guides/vercel-deployment-auth-setup.html</loc>
131
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
131
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
132
132
  <changefreq>monthly</changefreq>
133
133
  <priority>0.8</priority>
134
134
  </url>
135
135
  <url>
136
136
  <loc>https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html</loc>
137
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
137
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
138
138
  <changefreq>monthly</changefreq>
139
139
  <priority>0.8</priority>
140
140
  </url>
141
141
  <url>
142
142
  <loc>https://doc-builder-delta.vercel.app/index.html</loc>
143
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
143
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
144
144
  <changefreq>weekly</changefreq>
145
145
  <priority>1.0</priority>
146
146
  </url>
147
147
  <url>
148
148
  <loc>https://doc-builder-delta.vercel.app/launch/README.html</loc>
149
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
149
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
150
150
  <changefreq>monthly</changefreq>
151
151
  <priority>0.6</priority>
152
152
  </url>
153
153
  <url>
154
154
  <loc>https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html</loc>
155
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
155
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
156
156
  <changefreq>monthly</changefreq>
157
157
  <priority>0.6</priority>
158
158
  </url>
159
159
  <url>
160
160
  <loc>https://doc-builder-delta.vercel.app/launch/go-to-market-strategy.html</loc>
161
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
161
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
162
162
  <changefreq>monthly</changefreq>
163
163
  <priority>0.6</priority>
164
164
  </url>
165
165
  <url>
166
166
  <loc>https://doc-builder-delta.vercel.app/launch/launch-announcements.html</loc>
167
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
167
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
168
168
  <changefreq>monthly</changefreq>
169
169
  <priority>0.6</priority>
170
170
  </url>
171
171
  <url>
172
172
  <loc>https://doc-builder-delta.vercel.app/private/cache-control-anti-pattern.html</loc>
173
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
173
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
174
174
  <changefreq>monthly</changefreq>
175
175
  <priority>0.6</priority>
176
176
  </url>
177
177
  <url>
178
178
  <loc>https://doc-builder-delta.vercel.app/private/launch/README.html</loc>
179
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
179
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
180
180
  <changefreq>monthly</changefreq>
181
181
  <priority>0.6</priority>
182
182
  </url>
183
183
  <url>
184
184
  <loc>https://doc-builder-delta.vercel.app/private/launch/auth-cleanup-summary.html</loc>
185
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
185
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
186
186
  <changefreq>monthly</changefreq>
187
187
  <priority>0.6</priority>
188
188
  </url>
189
189
  <url>
190
190
  <loc>https://doc-builder-delta.vercel.app/private/launch/bubble-plugin-specification.html</loc>
191
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
191
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
192
192
  <changefreq>monthly</changefreq>
193
193
  <priority>0.6</priority>
194
194
  </url>
195
195
  <url>
196
196
  <loc>https://doc-builder-delta.vercel.app/private/launch/go-to-market-strategy.html</loc>
197
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
197
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
198
198
  <changefreq>monthly</changefreq>
199
199
  <priority>0.6</priority>
200
200
  </url>
201
201
  <url>
202
202
  <loc>https://doc-builder-delta.vercel.app/private/launch/launch-announcements.html</loc>
203
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
203
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
204
204
  <changefreq>monthly</changefreq>
205
205
  <priority>0.6</priority>
206
206
  </url>
207
207
  <url>
208
208
  <loc>https://doc-builder-delta.vercel.app/private/launch/vercel-deployment-auth-setup.html</loc>
209
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
209
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
210
210
  <changefreq>monthly</changefreq>
211
211
  <priority>0.6</priority>
212
212
  </url>
213
213
  <url>
214
214
  <loc>https://doc-builder-delta.vercel.app/private/next-steps-walkthrough.html</loc>
215
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
215
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
216
216
  <changefreq>monthly</changefreq>
217
217
  <priority>0.6</priority>
218
218
  </url>
219
219
  <url>
220
220
  <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-completed.html</loc>
221
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
221
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
222
222
  <changefreq>monthly</changefreq>
223
223
  <priority>0.6</priority>
224
224
  </url>
225
225
  <url>
226
226
  <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-implementation-plan.html</loc>
227
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
227
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
228
228
  <changefreq>monthly</changefreq>
229
229
  <priority>0.6</priority>
230
230
  </url>
231
231
  <url>
232
232
  <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-integration-plan.html</loc>
233
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
233
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
234
234
  <changefreq>monthly</changefreq>
235
235
  <priority>0.6</priority>
236
236
  </url>
237
237
  <url>
238
238
  <loc>https://doc-builder-delta.vercel.app/private/supabase-auth-setup-guide.html</loc>
239
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
239
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
240
240
  <changefreq>monthly</changefreq>
241
241
  <priority>0.8</priority>
242
242
  </url>
243
243
  <url>
244
244
  <loc>https://doc-builder-delta.vercel.app/private/test-private-doc.html</loc>
245
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
245
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
246
+ <changefreq>monthly</changefreq>
247
+ <priority>0.6</priority>
248
+ </url>
249
+ <url>
250
+ <loc>https://doc-builder-delta.vercel.app/private/user-management-tooling.html</loc>
251
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
246
252
  <changefreq>monthly</changefreq>
247
253
  <priority>0.6</priority>
248
254
  </url>
249
255
  <url>
250
256
  <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
251
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
257
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
252
258
  <changefreq>monthly</changefreq>
253
259
  <priority>0.8</priority>
254
260
  </url>
255
261
  <url>
256
262
  <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
257
- <lastmod>2025-07-26T09:59:23.023Z</lastmod>
263
+ <lastmod>2025-07-26T10:38:42.055Z</lastmod>
258
264
  <changefreq>monthly</changefreq>
259
265
  <priority>0.8</priority>
260
266
  </url>
@@ -46,6 +46,39 @@
46
46
  <link rel="stylesheet" href="/css/notion-style.css">
47
47
 
48
48
 
49
+ <!-- Hide content until auth check -->
50
+ <style>
51
+ body {
52
+ visibility: hidden;
53
+ opacity: 0;
54
+ transition: opacity 0.3s ease;
55
+ }
56
+ body.authenticated {
57
+ visibility: visible;
58
+ opacity: 1;
59
+ }
60
+ /* Show login/logout pages immediately */
61
+ body.auth-page {
62
+ visibility: visible;
63
+ opacity: 1;
64
+ }
65
+ /* Style auth button consistently */
66
+ .auth-btn {
67
+ background: none;
68
+ border: none;
69
+ color: var(--text-secondary);
70
+ cursor: pointer;
71
+ padding: 0.5rem;
72
+ border-radius: 0.5rem;
73
+ transition: all 0.2s;
74
+ font-size: 1.1rem;
75
+ }
76
+ .auth-btn:hover {
77
+ background: var(--bg-secondary);
78
+ color: var(--text-primary);
79
+ }
80
+ </style>
81
+
49
82
 
50
83
  <!-- Favicon -->
51
84
  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>✨</text></svg>">
@@ -65,8 +98,8 @@
65
98
  "name": "Knowcode Ltd",
66
99
  "url": "https://knowcode.tech"
67
100
  },
68
- "datePublished": "2025-07-26T09:59:23.014Z",
69
- "dateModified": "2025-07-26T09:59:23.014Z",
101
+ "datePublished": "2025-07-26T10:38:42.041Z",
102
+ "dateModified": "2025-07-26T10:38:42.041Z",
70
103
  "mainEntityOfPage": {
71
104
  "@type": "WebPage",
72
105
  "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -99,10 +132,14 @@
99
132
 
100
133
  <div class="header-actions">
101
134
  <div class="deployment-info">
102
- <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 09:59 AM UTC</span>
135
+ <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
103
136
  </div>
104
137
 
105
138
 
139
+ <a href="../login.html" class="auth-btn" title="Login/Logout">
140
+ <i class="fas fa-sign-in-alt"></i>
141
+ </a>
142
+
106
143
 
107
144
  <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
108
145
  <i class="fas fa-moon"></i>
@@ -162,7 +199,7 @@
162
199
  <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>
163
200
  <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>
164
201
  <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>
165
- <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder now includes automatic authentication for documents placed in a directory."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
202
+ <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder provides flexible authentication options to protect your documentation."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
166
203
  <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>
167
204
  <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>
168
205
  <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>
@@ -408,6 +445,7 @@ vercel --scope team-name
408
445
  };
409
446
  </script>
410
447
  <script src="/js/main.js"></script>
411
-
448
+ <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
449
+ <script src="/js/auth.js"></script>
412
450
  </body>
413
451
  </html>
@@ -46,6 +46,39 @@
46
46
  <link rel="stylesheet" href="/css/notion-style.css">
47
47
 
48
48
 
49
+ <!-- Hide content until auth check -->
50
+ <style>
51
+ body {
52
+ visibility: hidden;
53
+ opacity: 0;
54
+ transition: opacity 0.3s ease;
55
+ }
56
+ body.authenticated {
57
+ visibility: visible;
58
+ opacity: 1;
59
+ }
60
+ /* Show login/logout pages immediately */
61
+ body.auth-page {
62
+ visibility: visible;
63
+ opacity: 1;
64
+ }
65
+ /* Style auth button consistently */
66
+ .auth-btn {
67
+ background: none;
68
+ border: none;
69
+ color: var(--text-secondary);
70
+ cursor: pointer;
71
+ padding: 0.5rem;
72
+ border-radius: 0.5rem;
73
+ transition: all 0.2s;
74
+ font-size: 1.1rem;
75
+ }
76
+ .auth-btn:hover {
77
+ background: var(--bg-secondary);
78
+ color: var(--text-primary);
79
+ }
80
+ </style>
81
+
49
82
 
50
83
  <!-- Favicon -->
51
84
  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>✨</text></svg>">
@@ -65,8 +98,8 @@
65
98
  "name": "Knowcode Ltd",
66
99
  "url": "https://knowcode.tech"
67
100
  },
68
- "datePublished": "2025-07-26T09:59:23.016Z",
69
- "dateModified": "2025-07-26T09:59:23.016Z",
101
+ "datePublished": "2025-07-26T10:38:42.043Z",
102
+ "dateModified": "2025-07-26T10:38:42.043Z",
70
103
  "mainEntityOfPage": {
71
104
  "@type": "WebPage",
72
105
  "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -99,10 +132,14 @@
99
132
 
100
133
  <div class="header-actions">
101
134
  <div class="deployment-info">
102
- <span class="deployment-date" title="Built with doc-builder v1.8.0">Last updated: Jul 26, 2025, 09:59 AM UTC</span>
135
+ <span class="deployment-date" title="Built with doc-builder v1.8.1">Last updated: Jul 26, 2025, 10:38 AM UTC</span>
103
136
  </div>
104
137
 
105
138
 
139
+ <a href="../login.html" class="auth-btn" title="Login/Logout">
140
+ <i class="fas fa-sign-in-alt"></i>
141
+ </a>
142
+
106
143
 
107
144
  <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
108
145
  <i class="fas fa-moon"></i>
@@ -162,7 +199,7 @@
162
199
  <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>
163
200
  <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>
164
201
  <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>
165
- <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder now includes automatic authentication for documents placed in a directory."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
202
+ <a href="/guides/private-directory-authentication.html" class="nav-item" data-tooltip="The @knowcode/doc-builder provides flexible authentication options to protect your documentation."><i class="fas fa-file-alt"></i> Private Directory Authentication</a>
166
203
  <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>
167
204
  <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>
168
205
  <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>
@@ -367,6 +404,7 @@
367
404
  };
368
405
  </script>
369
406
  <script src="/js/main.js"></script>
370
-
407
+ <script src="https://unpkg.com/@supabase/supabase-js@2"></script>
408
+ <script src="/js/auth.js"></script>
371
409
  </body>
372
410
  </html>
package/lib/config.js CHANGED
@@ -1,6 +1,7 @@
1
1
  const fs = require('fs-extra');
2
2
  const path = require('path');
3
3
  const chalk = require('chalk');
4
+ const sharedAuth = require('./shared-auth-config');
4
5
 
5
6
  /**
6
7
  * Default configuration
@@ -36,9 +37,9 @@ const defaultConfig = {
36
37
 
37
38
  // Authentication - Supabase only (basic auth removed for security)
38
39
  auth: {
39
- supabaseUrl: '',
40
- supabaseAnonKey: '',
41
- siteId: ''
40
+ supabaseUrl: sharedAuth.supabaseUrl,
41
+ supabaseAnonKey: sharedAuth.supabaseAnonKey,
42
+ siteId: '' // Will be auto-generated if not provided
42
43
  },
43
44
 
44
45
  // Changelog settings
@@ -122,9 +123,9 @@ const notionInspiredPreset = {
122
123
  },
123
124
 
124
125
  auth: {
125
- supabaseUrl: process.env.SUPABASE_URL || '',
126
- supabaseAnonKey: process.env.SUPABASE_ANON_KEY || '',
127
- siteId: process.env.DOC_SITE_ID || ''
126
+ supabaseUrl: process.env.SUPABASE_URL || sharedAuth.supabaseUrl,
127
+ supabaseAnonKey: process.env.SUPABASE_ANON_KEY || sharedAuth.supabaseAnonKey,
128
+ siteId: process.env.DOC_SITE_ID || '' // Will be auto-generated if not provided
128
129
  },
129
130
 
130
131
  changelog: {
@@ -264,9 +265,8 @@ async function loadConfig(configPath, options = {}) {
264
265
  if (options.output) {
265
266
  config.outputDir = options.output;
266
267
  }
267
- if (options.auth === false) {
268
- config.features.authentication = false;
269
- }
268
+ // Note: We don't apply auth=false here anymore because private directory detection
269
+ // should always override to ensure security
270
270
  if (options.changelog === false) {
271
271
  config.features.changelog = false;
272
272
  config.changelog.enabled = false;
@@ -307,24 +307,17 @@ async function loadConfig(configPath, options = {}) {
307
307
  // Check for private directory and auto-enable authentication if found
308
308
  const privatePath = path.join(docsPath, 'private');
309
309
  if (fs.existsSync(privatePath) && fs.statSync(privatePath).isDirectory()) {
310
- // Only auto-enable if not already configured
311
- if (!config.features.authentication) {
312
- console.log(chalk.blue('🔐 Found private directory - automatically enabling Supabase authentication'));
313
- config.features.authentication = 'supabase';
314
- config.features.autoAuthEnabled = true; // Track that this was auto-enabled
315
-
316
- // Check if Supabase credentials are configured
317
- if (!config.auth.supabaseUrl || !config.auth.supabaseAnonKey || !config.auth.siteId) {
318
- console.warn(chalk.yellow('⚠️ Supabase credentials not configured. Private directory found but authentication will not work.'));
319
- console.warn(chalk.yellow(' To enable authentication, set the following in your config:'));
320
- console.warn(chalk.yellow(' - auth.supabaseUrl'));
321
- console.warn(chalk.yellow(' - auth.supabaseAnonKey'));
322
- console.warn(chalk.yellow(' - auth.siteId'));
323
- console.warn(chalk.yellow(''));
324
- console.warn(chalk.yellow(' Or disable authentication by removing the private directory.'));
325
- // Disable authentication if credentials are missing
326
- config.features.authentication = false;
327
- }
310
+ // Auto-enable authentication when private directory exists
311
+ // This overrides any config setting to ensure private directories are always protected
312
+ console.log(chalk.blue('🔐 Found private directory - automatically enabling Supabase authentication'));
313
+ config.features.authentication = 'supabase';
314
+ config.features.autoAuthEnabled = true; // Track that this was auto-enabled
315
+
316
+ // Auto-generate site ID if not provided
317
+ if (!config.auth.siteId) {
318
+ config.auth.siteId = sharedAuth.generateSiteId(config.siteName);
319
+ console.log(chalk.blue(`📋 Generated site ID: ${config.auth.siteId}`));
320
+ console.log(chalk.yellow(' Note: Add this site ID to your Supabase database to enable user access'));
328
321
  }
329
322
  }
330
323
  }
@@ -1192,8 +1192,15 @@ async function generateSupabaseAuthFiles(outputDir, config) {
1192
1192
  throw new Error(`Supabase authentication configuration errors:\n${validationErrors.join('\n')}`);
1193
1193
  }
1194
1194
 
1195
+ // Use configured credentials (now with defaults from shared-auth-config)
1196
+ const authConfig = {
1197
+ supabaseUrl: config.auth.supabaseUrl,
1198
+ supabaseAnonKey: config.auth.supabaseAnonKey,
1199
+ siteId: config.auth.siteId
1200
+ };
1201
+
1195
1202
  // Create Supabase auth instance
1196
- const supabaseAuth = new SupabaseAuth(config.auth);
1203
+ const supabaseAuth = new SupabaseAuth(authConfig);
1197
1204
 
1198
1205
  // Generate auth script and save to js/auth.js
1199
1206
  const authScript = supabaseAuth.generateAuthScript();
@@ -1213,6 +1220,7 @@ async function generateSupabaseAuthFiles(outputDir, config) {
1213
1220
  console.log(chalk.green('✓ Generated Supabase authentication files'));
1214
1221
  }
1215
1222
 
1223
+
1216
1224
  // Create default index page when no documentation exists
1217
1225
  async function createDefaultIndexPage(outputDir, config, version) {
1218
1226
  const siteName = config.siteName || 'Documentation';
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Shared Supabase Authentication Configuration
3
+ *
4
+ * These are the default Supabase credentials used by all doc-builder sites.
5
+ * The same Supabase database is shared across all documentation sites,
6
+ * with access control managed via the docbuilder_access table.
7
+ */
8
+
9
+ module.exports = {
10
+ // Shared Supabase project credentials
11
+ supabaseUrl: 'https://xcihhnfcitjrwbynxmka.supabase.co',
12
+ supabaseAnonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY',
13
+
14
+ // Function to generate a unique site ID
15
+ generateSiteId: function(siteName) {
16
+ const timestamp = Date.now();
17
+ const random = Math.random().toString(36).substring(2, 8);
18
+ const cleanName = siteName.toLowerCase().replace(/[^a-z0-9]/g, '-');
19
+ return `${cleanName}-${timestamp}-${random}`;
20
+ }
21
+ };