@knowcode/doc-builder 1.5.16 → 1.5.17

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 (26) hide show
  1. package/.claude/settings.local.json +2 -1
  2. package/CHANGELOG.md +15 -0
  3. package/README.md +69 -11
  4. package/assets/css/notion-style.css +2 -0
  5. package/cli.js +22 -22
  6. package/html/README.html +8 -8
  7. package/html/documentation-index.html +5 -4
  8. package/html/guides/authentication-guide.html +10 -10
  9. package/html/guides/claude-workflow-guide.html +5 -10
  10. package/html/guides/documentation-standards.html +5 -5
  11. package/html/guides/google-site-verification-guide.html +5 -4
  12. package/html/guides/phosphor-icons-guide.html +5 -4
  13. package/html/guides/seo-guide.html +9 -8
  14. package/html/guides/seo-optimization-guide.html +5 -4
  15. package/html/guides/troubleshooting-guide.html +15 -15
  16. package/html/guides/windows-setup-guide.html +667 -0
  17. package/html/index.html +8 -8
  18. package/html/js/main.js +0 -18
  19. package/html/sitemap.xml +22 -16
  20. package/html/vercel-cli-setup-guide.html +7 -6
  21. package/html/vercel-first-time-setup-guide.html +7 -6
  22. package/lib/core-builder.js +5 -5
  23. package/lib/deploy.js +6 -6
  24. package/package.json +1 -1
  25. package/recordings/mh-ls-22jul.txt +2305 -0
  26. package/scripts/setup.js +3 -3
package/html/index.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:52:26.119Z",
66
- "dateModified": "2025-07-22T11:52:26.119Z",
65
+ "datePublished": "2025-07-22T15:31:48.134Z",
66
+ "dateModified": "2025-07-22T15:31:48.134Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.15">Last updated: Jul 22, 2025, 11:52 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.16">Last updated: Jul 22, 2025, 03:31 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
@@ -161,7 +161,8 @@
161
161
  <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>
162
162
  <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>
163
163
  <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>
164
- <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></div></div>
164
+ <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>
165
+ <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>
165
166
  </nav>
166
167
  <div class="resize-handle"></div>
167
168
  </aside>
@@ -255,7 +256,7 @@
255
256
  <td width="25%">
256
257
 
257
258
  <h3>1️⃣ Initialize</h3>
258
- <pre><code class="language-bash">npx @knowcode/doc-builder init
259
+ <pre><code class="language-bash">npx @knowcode/doc-builder@latest init
259
260
  </code></pre>
260
261
  <p><em>Create project structure</em></p>
261
262
  </td>
@@ -274,14 +275,14 @@ Welcome to our docs!
274
275
  <td width="25%">
275
276
 
276
277
  <h3>3️⃣ Preview</h3>
277
- <pre><code class="language-bash">npx doc-builder dev
278
+ <pre><code class="language-bash">npx @knowcode/doc-builder@latest dev
278
279
  </code></pre>
279
280
  <p><em>Live development server</em></p>
280
281
  </td>
281
282
  <td width="25%">
282
283
 
283
284
  <h3>4️⃣ Deploy</h3>
284
- <pre><code class="language-bash">npx doc-builder deploy
285
+ <pre><code class="language-bash">npx @knowcode/doc-builder@latest deploy
285
286
  </code></pre>
286
287
  <p><em>Push to production</em></p>
287
288
  </td>
@@ -323,7 +324,6 @@ Welcome to our docs!
323
324
 
324
325
  <h3>Mermaid Diagrams</h3>
325
326
  <div class="mermaid-wrapper">
326
- <div class="mermaid-title">Diagram</div>
327
327
  <div class="mermaid">graph LR
328
328
  A[Write] --> B[Build]
329
329
  B --> C[Deploy]
package/html/js/main.js CHANGED
@@ -79,9 +79,6 @@ function initializeMermaidFullScreen() {
79
79
  const toolbar = document.createElement('div');
80
80
  toolbar.className = 'mermaid-toolbar';
81
81
 
82
- const title = document.createElement('div');
83
- title.textContent = 'Mermaid Diagram';
84
-
85
82
  const actions = document.createElement('div');
86
83
  actions.className = 'mermaid-actions';
87
84
 
@@ -91,23 +88,8 @@ function initializeMermaidFullScreen() {
91
88
  fullScreenBtn.innerHTML = '<i class="fas fa-expand"></i> Full Screen';
92
89
  fullScreenBtn.addEventListener('click', () => openMermaidFullScreen(mermaidDiv, index));
93
90
 
94
- // Copy SVG button
95
- const copyBtn = document.createElement('button');
96
- copyBtn.className = 'mermaid-btn';
97
- copyBtn.innerHTML = '<i class="fas fa-copy"></i> Copy SVG';
98
- copyBtn.addEventListener('click', () => copyMermaidSVG(mermaidDiv));
99
-
100
- // Copy Mermaid source button
101
- const copyMermaidBtn = document.createElement('button');
102
- copyMermaidBtn.className = 'mermaid-btn';
103
- copyMermaidBtn.innerHTML = '<i class="fas fa-code"></i> Copy Mermaid';
104
- copyMermaidBtn.addEventListener('click', () => copyMermaidSource(mermaidDiv));
105
-
106
91
  actions.appendChild(fullScreenBtn);
107
- actions.appendChild(copyBtn);
108
- actions.appendChild(copyMermaidBtn);
109
92
 
110
- toolbar.appendChild(title);
111
93
  toolbar.appendChild(actions);
112
94
 
113
95
  // Create wrapper for the diagram
package/html/sitemap.xml CHANGED
@@ -2,97 +2,103 @@
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-22T11:52:26.178Z</lastmod>
5
+ <lastmod>2025-07-22T15:31:48.192Z</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-22T11:52:26.178Z</lastmod>
11
+ <lastmod>2025-07-22T15:31:48.192Z</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-22T11:52:26.178Z</lastmod>
17
+ <lastmod>2025-07-22T15:31:48.192Z</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-22T11:52:26.178Z</lastmod>
23
+ <lastmod>2025-07-22T15:31:48.192Z</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-guide.html</loc>
29
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
29
+ <lastmod>2025-07-22T15:31:48.192Z</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/claude-workflow-guide.html</loc>
35
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
35
+ <lastmod>2025-07-22T15:31:48.192Z</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/document-standards.html</loc>
41
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
41
+ <lastmod>2025-07-22T15:31:48.192Z</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/documentation-standards.html</loc>
47
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
47
+ <lastmod>2025-07-22T15:31:48.192Z</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/google-site-verification-guide.html</loc>
53
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
53
+ <lastmod>2025-07-22T15:31:48.192Z</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/phosphor-icons-guide.html</loc>
59
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
59
+ <lastmod>2025-07-22T15:31:48.192Z</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/seo-guide.html</loc>
65
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
65
+ <lastmod>2025-07-22T15:31:48.192Z</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/seo-optimization-guide.html</loc>
71
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
71
+ <lastmod>2025-07-22T15:31:48.192Z</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/troubleshooting-guide.html</loc>
77
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
77
+ <lastmod>2025-07-22T15:31:48.192Z</lastmod>
78
+ <changefreq>monthly</changefreq>
79
+ <priority>0.8</priority>
80
+ </url>
81
+ <url>
82
+ <loc>https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html</loc>
83
+ <lastmod>2025-07-22T15:31:48.192Z</lastmod>
78
84
  <changefreq>monthly</changefreq>
79
85
  <priority>0.8</priority>
80
86
  </url>
81
87
  <url>
82
88
  <loc>https://doc-builder-delta.vercel.app/index.html</loc>
83
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
89
+ <lastmod>2025-07-22T15:31:48.192Z</lastmod>
84
90
  <changefreq>weekly</changefreq>
85
91
  <priority>1.0</priority>
86
92
  </url>
87
93
  <url>
88
94
  <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
89
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
95
+ <lastmod>2025-07-22T15:31:48.192Z</lastmod>
90
96
  <changefreq>monthly</changefreq>
91
97
  <priority>0.8</priority>
92
98
  </url>
93
99
  <url>
94
100
  <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
95
- <lastmod>2025-07-22T11:52:26.178Z</lastmod>
101
+ <lastmod>2025-07-22T15:31:48.192Z</lastmod>
96
102
  <changefreq>monthly</changefreq>
97
103
  <priority>0.8</priority>
98
104
  </url>
package/html/vercel-cli-setup-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:52:26.165Z",
66
- "dateModified": "2025-07-22T11:52:26.165Z",
65
+ "datePublished": "2025-07-22T15:31:48.181Z",
66
+ "dateModified": "2025-07-22T15:31:48.181Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.15">Last updated: Jul 22, 2025, 11:52 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.16">Last updated: Jul 22, 2025, 03:31 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
@@ -161,7 +161,8 @@
161
161
  <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>
162
162
  <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>
163
163
  <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>
164
- <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></div></div>
164
+ <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>
165
+ <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>
165
166
  </nav>
166
167
  <div class="resize-handle"></div>
167
168
  </aside>
@@ -208,7 +209,7 @@
208
209
  </code></pre>
209
210
  </li>
210
211
  <li><p><strong>Deploy with doc-builder</strong>:</p>
211
- <pre><code class="language-bash">npx @knowcode/doc-builder deploy
212
+ <pre><code class="language-bash">npx @knowcode/doc-builder@latest deploy
212
213
  </code></pre>
213
214
  </li>
214
215
  </ol>
@@ -367,7 +368,7 @@ vercel --scope team-name
367
368
  <pre><code class="language-yaml"># GitHub Actions example
368
369
  - name: Deploy Documentation
369
370
  run: |
370
- npm install -g @knowcode/doc-builder vercel
371
+ npm install -g @knowcode/doc-builder@latest vercel
371
372
  doc-builder build
372
373
  vercel --prod --token=${{ secrets.VERCEL_TOKEN }}
373
374
  </code></pre>
package/html/vercel-first-time-setup-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:52:26.168Z",
66
- "dateModified": "2025-07-22T11:52:26.168Z",
65
+ "datePublished": "2025-07-22T15:31:48.183Z",
66
+ "dateModified": "2025-07-22T15:31:48.183Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.15">Last updated: Jul 22, 2025, 11:52 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.16">Last updated: Jul 22, 2025, 03:31 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
@@ -161,7 +161,8 @@
161
161
  <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>
162
162
  <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>
163
163
  <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>
164
- <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></div></div>
164
+ <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>
165
+ <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>
165
166
  </nav>
166
167
  <div class="resize-handle"></div>
167
168
  </aside>
@@ -175,7 +176,7 @@
175
176
  <p>This guide walks you through the streamlined Vercel deployment process when using <code>@knowcode/doc-builder deploy</code>. The new Vercel CLI experience has fewer prompts and clearer instructions, making deployment much simpler than before.</p>
176
177
  <h2>The Simplified Process</h2>
177
178
  <h3>Step 1: Run the Deploy Command</h3>
178
- <pre><code class="language-bash">npx @knowcode/doc-builder deploy
179
+ <pre><code class="language-bash">npx @knowcode/doc-builder@latest deploy
179
180
  </code></pre>
180
181
  <h3>Step 2: doc-builder Configuration</h3>
181
182
  <p>The tool will ask a few simple questions:</p>
@@ -299,7 +300,7 @@
299
300
  <li>You have internet connection</li>
300
301
  </ol>
301
302
  <h2>Quick Checklist</h2>
302
- <pre><code><i class="ph ph-check-circle" aria-label="checked"></i> 1. Run: npx @knowcode/doc-builder deploy
303
+ <pre><code><i class="ph ph-check-circle" aria-label="checked"></i> 1. Run: npx @knowcode/doc-builder@latest deploy
303
304
  <i class="ph ph-check-circle" aria-label="checked"></i> 2. Enter project name (e.g., my-docs)
304
305
  <i class="ph ph-check-circle" aria-label="checked"></i> 3. Skip custom URL (press Enter)
305
306
  <i class="ph ph-check-circle" aria-label="checked"></i> 4. Confirm deployment when Vercel asks
package/lib/core-builder.js CHANGED
@@ -917,7 +917,7 @@ This documentation site was built with @knowcode/doc-builder. This is an auto-ge
917
917
  1. **Replace this file**: Edit \`docs/README.md\` with your project's actual documentation
918
918
  2. **Add content**: Create additional markdown files in the \`docs/\` directory
919
919
  3. **Organize with folders**: Use subfolders to structure your documentation
920
- 4. **Rebuild**: Run \`npx @knowcode/doc-builder build\` to regenerate the site
920
+ 4. **Rebuild**: Run \`npx @knowcode/doc-builder@latest build\` to regenerate the site
921
921
 
922
922
  ## Documentation Structure
923
923
 
@@ -935,7 +935,7 @@ Your documentation can include:
935
935
  2. Create additional markdown files for your content
936
936
  3. Organize files into logical folders
937
937
  4. Use Mermaid diagrams for visual explanations
938
- 5. Deploy with \`npx @knowcode/doc-builder deploy\`
938
+ 5. Deploy with \`npx @knowcode/doc-builder@latest deploy\`
939
939
 
940
940
  ## Documentation Standards
941
941
 
@@ -969,7 +969,7 @@ graph TD
969
969
 
970
970
  For help with @knowcode/doc-builder:
971
971
  - Check the documentation at your package source
972
- - Use \`npx @knowcode/doc-builder --help\` for CLI options
972
+ - Use \`npx @knowcode/doc-builder@latest --help\` for CLI options
973
973
  - Review the generated configuration guide if available
974
974
  `;
975
975
 
@@ -1207,8 +1207,8 @@ This is the homepage for my documentation.
1207
1207
  <ol>
1208
1208
  <li>Create <code>docs/index.md</code> or <code>docs/README.md</code></li>
1209
1209
  <li>Add more markdown files for additional pages</li>
1210
- <li>Rebuild: <code>npx @knowcode/doc-builder build</code></li>
1211
- <li>Deploy: <code>npx @knowcode/doc-builder deploy</code></li>
1210
+ <li>Rebuild: <code>npx @knowcode/doc-builder@latest build</code></li>
1211
+ <li>Deploy: <code>npx @knowcode/doc-builder@latest deploy</code></li>
1212
1212
  </ol>
1213
1213
 
1214
1214
  ${fileListHtml}
package/lib/deploy.js CHANGED
@@ -26,7 +26,7 @@ async function setupVercelProject(config) {
26
26
  name: 'projectName',
27
27
  message: 'What is your project name?',
28
28
  initial: config.siteName.toLowerCase().replace(/[^a-z0-9-]/g, '-') || 'my-docs',
29
- hint: 'This will be your URL: project-name.vercel.app'
29
+ hint: 'Lowercase only, letters/numbers/hyphens. This becomes: project-name.vercel.app'
30
30
  },
31
31
  {
32
32
  type: 'text',
@@ -190,8 +190,8 @@ async function deployToVercel(config, isProd = false) {
190
190
  console.log(chalk.yellow(' Your documentation may appear without styling.'));
191
191
  console.log(chalk.cyan('\n💡 To fix this:'));
192
192
  console.log(chalk.white(' 1. Update to latest version: ') + chalk.gray('npm update @knowcode/doc-builder'));
193
- console.log(chalk.white(' 2. Rebuild your docs: ') + chalk.gray('npx @knowcode/doc-builder build'));
194
- console.log(chalk.white(' 3. Then deploy again: ') + chalk.gray('npx @knowcode/doc-builder deploy\n'));
193
+ console.log(chalk.white(' 2. Rebuild your docs: ') + chalk.gray('npx @knowcode/doc-builder@latest build'));
194
+ console.log(chalk.white(' 3. Then deploy again: ') + chalk.gray('npx @knowcode/doc-builder@latest deploy\n'));
195
195
  }
196
196
 
197
197
  // Simple deployment message
@@ -399,8 +399,8 @@ async function deployToVercel(config, isProd = false) {
399
399
  console.log(chalk.cyan('4. Save and try again\n'));
400
400
 
401
401
  console.log(chalk.white('Option 2 - Reset and start fresh:'));
402
- console.log(chalk.cyan('1. Run: npx @knowcode/doc-builder reset-vercel'));
403
- console.log(chalk.cyan('2. Run: npx @knowcode/doc-builder deploy'));
402
+ console.log(chalk.cyan('1. Run: npx @knowcode/doc-builder@latest reset-vercel'));
403
+ console.log(chalk.cyan('2. Run: npx @knowcode/doc-builder@latest deploy'));
404
404
  console.log(chalk.cyan('3. Create a NEW project (don\'t link to existing)\n'));
405
405
 
406
406
  throw new Error('Build settings conflict - see instructions above');
@@ -481,7 +481,7 @@ async function prepareDeployment(config) {
481
481
  // Created redirect
482
482
  } else {
483
483
  // No HTML files at all - this should never happen after build
484
- console.error(chalk.red('No HTML files found. Run: npx @knowcode/doc-builder build'));
484
+ console.error(chalk.red('No HTML files found. Run: npx @knowcode/doc-builder@latest build'));
485
485
 
486
486
  // Create emergency fallback page
487
487
  const { createDefaultIndexPage } = require('./core-builder');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@knowcode/doc-builder",
3
- "version": "1.5.16",
3
+ "version": "1.5.17",
4
4
  "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
5
5
  "main": "index.js",
6
6
  "bin": {