@knowcode/doc-builder 1.5.15 → 1.5.17

package/html/vercel-first-time-setup-guide.html

@@ -62,8 +62,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T11:15:59.605Z",
-  "dateModified": "2025-07-22T11:15:59.605Z",
+  "datePublished": "2025-07-22T15:31:48.183Z",
+  "dateModified": "2025-07-22T15:31:48.183Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -96,7 +96,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.16">Last updated: Jul 22, 2025, 03:31 PM UTC</span>
                 </div>
                 
                 
@@ -161,7 +161,8 @@
         <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>
         <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>
         <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>
-        <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>
+        <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>
+        <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>
             </nav>
             <div class="resize-handle"></div>
         </aside>
@@ -175,7 +176,7 @@
 <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>
 <h2>The Simplified Process</h2>
 <h3>Step 1: Run the Deploy Command</h3>
-<pre><code class="language-bash">npx @knowcode/doc-builder deploy
+<pre><code class="language-bash">npx @knowcode/doc-builder@latest deploy
 </code></pre>
 <h3>Step 2: doc-builder Configuration</h3>
 <p>The tool will ask a few simple questions:</p>
@@ -299,7 +300,7 @@
 <li>You have internet connection</li>
 </ol>
 <h2>Quick Checklist</h2>
-<pre><code><i class="ph ph-check-circle" aria-label="checked"></i> 1. Run: npx @knowcode/doc-builder deploy
+<pre><code><i class="ph ph-check-circle" aria-label="checked"></i> 1. Run: npx @knowcode/doc-builder@latest deploy
 <i class="ph ph-check-circle" aria-label="checked"></i> 2. Enter project name (e.g., my-docs)
 <i class="ph ph-check-circle" aria-label="checked"></i> 3. Skip custom URL (press Enter)
 <i class="ph ph-check-circle" aria-label="checked"></i> 4. Confirm deployment when Vercel asks

package/lib/core-builder.js

@@ -172,7 +172,6 @@ function processMarkdownContent(content, config = {}) {
     // Store the mermaid block and return a placeholder
     const placeholder = `MERMAID_BLOCK_${mermaidBlocks.length}`;
     mermaidBlocks.push(`<div class="mermaid-wrapper">
-      <div class="mermaid-title">${escapeHtml(title)}</div>
       <div class="mermaid">${mermaidContent.trim()}</div>
     </div>`);
     return placeholder;
@@ -918,7 +917,7 @@ This documentation site was built with @knowcode/doc-builder. This is an auto-ge
 1. **Replace this file**: Edit \`docs/README.md\` with your project's actual documentation
 2. **Add content**: Create additional markdown files in the \`docs/\` directory
 3. **Organize with folders**: Use subfolders to structure your documentation
-4. **Rebuild**: Run \`npx @knowcode/doc-builder build\` to regenerate the site
+4. **Rebuild**: Run \`npx @knowcode/doc-builder@latest build\` to regenerate the site
 
 ## Documentation Structure
 
@@ -936,7 +935,7 @@ Your documentation can include:
 2. Create additional markdown files for your content
 3. Organize files into logical folders
 4. Use Mermaid diagrams for visual explanations
-5. Deploy with \`npx @knowcode/doc-builder deploy\`
+5. Deploy with \`npx @knowcode/doc-builder@latest deploy\`
 
 ## Documentation Standards
 
@@ -970,7 +969,7 @@ graph TD
 
 For help with @knowcode/doc-builder:
 - Check the documentation at your package source
-- Use \`npx @knowcode/doc-builder --help\` for CLI options
+- Use \`npx @knowcode/doc-builder@latest --help\` for CLI options
 - Review the generated configuration guide if available
 `;
 
@@ -1208,8 +1207,8 @@ This is the homepage for my documentation.
       <ol>
         <li>Create <code>docs/index.md</code> or <code>docs/README.md</code></li>
         <li>Add more markdown files for additional pages</li>
-        <li>Rebuild: <code>npx @knowcode/doc-builder build</code></li>
-        <li>Deploy: <code>npx @knowcode/doc-builder deploy</code></li>
+        <li>Rebuild: <code>npx @knowcode/doc-builder@latest build</code></li>
+        <li>Deploy: <code>npx @knowcode/doc-builder@latest deploy</code></li>
       </ol>
       
       ${fileListHtml}

package/lib/deploy.js

@@ -26,7 +26,7 @@ async function setupVercelProject(config) {
       name: 'projectName',
       message: 'What is your project name?',
       initial: config.siteName.toLowerCase().replace(/[^a-z0-9-]/g, '-') || 'my-docs',
-      hint: 'This will be your URL: project-name.vercel.app'
+      hint: 'Lowercase only, letters/numbers/hyphens. This becomes: project-name.vercel.app'
     },
     {
       type: 'text',
@@ -190,8 +190,8 @@ async function deployToVercel(config, isProd = false) {
     console.log(chalk.yellow('   Your documentation may appear without styling.'));
     console.log(chalk.cyan('\n💡 To fix this:'));
     console.log(chalk.white('   1. Update to latest version: ') + chalk.gray('npm update @knowcode/doc-builder'));
-    console.log(chalk.white('   2. Rebuild your docs: ') + chalk.gray('npx @knowcode/doc-builder build'));
-    console.log(chalk.white('   3. Then deploy again: ') + chalk.gray('npx @knowcode/doc-builder deploy\n'));
+    console.log(chalk.white('   2. Rebuild your docs: ') + chalk.gray('npx @knowcode/doc-builder@latest build'));
+    console.log(chalk.white('   3. Then deploy again: ') + chalk.gray('npx @knowcode/doc-builder@latest deploy\n'));
   }
   
   // Simple deployment message
@@ -399,8 +399,8 @@ async function deployToVercel(config, isProd = false) {
       console.log(chalk.cyan('4. Save and try again\n'));
       
       console.log(chalk.white('Option 2 - Reset and start fresh:'));
-      console.log(chalk.cyan('1. Run: npx @knowcode/doc-builder reset-vercel'));
-      console.log(chalk.cyan('2. Run: npx @knowcode/doc-builder deploy'));
+      console.log(chalk.cyan('1. Run: npx @knowcode/doc-builder@latest reset-vercel'));
+      console.log(chalk.cyan('2. Run: npx @knowcode/doc-builder@latest deploy'));
       console.log(chalk.cyan('3. Create a NEW project (don\'t link to existing)\n'));
       
       throw new Error('Build settings conflict - see instructions above');
@@ -481,7 +481,7 @@ async function prepareDeployment(config) {
         // Created redirect
       } else {
         // No HTML files at all - this should never happen after build
-        console.error(chalk.red('No HTML files found. Run: npx @knowcode/doc-builder build'));
+        console.error(chalk.red('No HTML files found. Run: npx @knowcode/doc-builder@latest build'));
         
         // Create emergency fallback page
         const { createDefaultIndexPage } = require('./core-builder');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.5.15",
+  "version": "1.5.17",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {