npm - @knowcode/doc-builder - Versions diffs - 1.5.15 → 1.5.17 - Mend

@knowcode/doc-builder 1.5.15 → 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 (33) hide show

package/.claude/settings.local.json +2 -1
package/CHANGELOG.md +28 -0
package/README.md +103 -35
package/assets/css/notion-style.css +2 -0
package/assets/js/main.js +0 -18
package/cli.js +22 -22
package/html/README.html +209 -95
package/html/css/notion-style.css +21 -13
package/html/documentation-index.html +5 -4
package/html/guides/authentication-guide.html +10 -10
package/html/guides/claude-workflow-guide.html +5 -10
package/html/guides/documentation-standards.html +5 -5
package/html/guides/google-site-verification-guide.html +5 -4
package/html/guides/phosphor-icons-guide.html +5 -4
package/html/guides/seo-guide.html +9 -8
package/html/guides/seo-optimization-guide.html +5 -4
package/html/guides/troubleshooting-guide.html +15 -15
package/html/guides/windows-setup-guide.html +667 -0
package/html/index.html +209 -95
package/html/js/main.js +0 -18
package/html/sitemap.xml +22 -16
package/html/vercel-cli-setup-guide.html +7 -6
package/html/vercel-first-time-setup-guide.html +7 -6
package/lib/core-builder.js +5 -6
package/lib/deploy.js +6 -6
package/package.json +1 -1
package/recordings/mh-ls-22jul.txt +2305 -0
package/scripts/setup.js +3 -3
package/Screenshot 2025-07-21 at 11.52.33.png +0 -0
package/Screenshot 2025-07-21 at 12.14.39.png +0 -0
package/Screenshot 2025-07-21 at 17.13.17.png +0 -0
package/Screenshot 2025-07-21 at 17.16.15.png +0 -0
package/Screenshot 2025-07-22 at 12.14.13.png +0 -0

package/html/guides/windows-setup-guide.html ADDED Viewed

@@ -0,0 +1,667 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="description" content="Generated: 2025-01-22 UTC">
+    <title>Windows Setup Guide for Claude Code &amp; @knowcode/do...</title>
+    <meta name="author" content="Lindsay Smith">
+    <meta name="keywords" content="documentation, markdown, static site generator, vercel, notion-style, claude, code">
+    <meta name="robots" content="index, follow">
+    <link rel="canonical" href="https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html">
+    <!-- Open Graph / Facebook -->
+    <meta property="og:type" content="article">
+    <meta property="og:url" content="https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html">
+    <meta property="og:title" content="Windows Setup Guide for Claude Code &amp; @knowcode/do...">
+    <meta property="og:description" content="Generated: 2025-01-22 UTC">
+    <meta property="og:image" content="https://doc-builder-delta.vercel.app/og-default.png">
+    <meta property="og:site_name" content="Doc Builder">
+    <meta property="og:locale" content="en_US">
+    <!-- Twitter Card -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:site" content="@planbbackups">
+    <meta name="twitter:creator" content="@planbbackups">
+    <meta name="twitter:title" content="Windows Setup Guide for Claude Code &amp; @knowcode/do...">
+    <meta name="twitter:description" content="Generated: 2025-01-22 UTC">
+    <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
+    <!-- Custom Meta Tags -->
+    <meta name="google-site-verification" content="FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ">
+    <!-- Fonts -->
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+    <!-- Icons -->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@phosphor-icons/web@2.1.1/src/regular/style.css">
+    <!-- Mermaid -->
+    <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
+    <!-- Styles -->
+    <link rel="stylesheet" href="/css/notion-style.css">
+    <!-- Favicon -->
+    <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>">
+    <script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "TechArticle",
+  "headline": "Windows Setup Guide for Claude Code & @knowcode/doc-builder",
+  "description": "Generated: 2025-01-22 UTC",
+  "author": {
+    "@type": "Person",
+    "name": "Lindsay Smith"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
+  },
+  "datePublished": "2025-07-22T15:31:48.178Z",
+  "dateModified": "2025-07-22T15:31:48.178Z",
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html"
+  },
+  "breadcrumb": {
+    "@type": "BreadcrumbList",
+    "itemListElement": [
+      {
+        "@type": "ListItem",
+        "position": 1,
+        "name": "Doc Builder",
+        "item": "https://doc-builder-delta.vercel.app"
+      },
+      {
+        "@type": "ListItem",
+        "position": 2,
+        "name": "Guides",
+        "item": "https://doc-builder-delta.vercel.app/guides/"
+      },
+      {
+        "@type": "ListItem",
+        "position": 3,
+        "name": "Windows Setup Guide",
+        "item": "https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html"
+      }
+    ]
+  }
+}
+</script>
+</head>
+<body>
+    <!-- Header -->
+    <header class="header">
+        <div class="header-content">
+            <a href="/index.html" class="logo">Doc Builder</a>
+            <div class="header-actions">
+                <div class="deployment-info">
+                    <span class="deployment-date" title="Built with doc-builder v1.5.16">Last updated: Jul 22, 2025, 03:31 PM UTC</span>
+                </div>
+                <button id="theme-toggle" class="theme-toggle" aria-label="Toggle theme">
+                    <i class="fas fa-moon"></i>
+                </button>
+                <button id="menu-toggle" class="menu-toggle" aria-label="Toggle menu">
+                    <i class="fas fa-bars"></i>
+                </button>
+            </div>
+        </div>
+    </header>
+    <!-- Preview Banner -->
+    <div id="preview-banner" class="preview-banner">
+        <div class="banner-content">
+            <i class="fas fa-exclamation-triangle banner-icon"></i>
+            <span class="banner-text">This documentation is a preview version - some content may be incomplete</span>
+            <button id="dismiss-banner" class="banner-dismiss" aria-label="Dismiss banner">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+    </div>
+    <!-- Breadcrumbs -->
+    <nav class="breadcrumbs" id="breadcrumbs">
+        <!-- Breadcrumbs will be generated by JavaScript -->
+    </nav>
+    <!-- Main Content -->
+    <div class="main-wrapper">
+        <!-- Sidebar -->
+        <aside class="sidebar">
+            <div class="sidebar-header">
+                <div class="filter-box">
+                    <input type="text" placeholder="Filter items..." class="filter-input" id="nav-filter">
+                    <i class="fas fa-search filter-icon"></i>
+                </div>
+            </div>
+            <nav class="navigation">
+      <div class="nav-section" data-level="0">
+        <a class="nav-title" href="/README.html"  >
+          <i class="fas fa-home"></i> Documentation
+        </a>
+        <div class="nav-content" >
+        <a href="/README.html" class="nav-item" data-tooltip="@knowcode/doc-builder."><i class="fas fa-file-alt"></i> Overview</a>
+        <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>
+        <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>
+        <a href="/vercel-first-time-setup-guide.html" class="nav-item" data-tooltip="This guide walks you through the streamlined Vercel deployment process when using."><i class="fas fa-file-alt"></i> Vercel First Time Setup Guide</a></div></div>
+      <div class="nav-section" data-level="1">
+        <a class="nav-title collapsible expanded" href="#" data-target="nav-guides-1" >
+          <i class="fas fa-chevron-right collapse-icon"></i><i class="fas fa-folder"></i> Guides
+        </a>
+        <div class="nav-content" id="nav-guides-1">
+        <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="This guide explains how to configure and use the built-in authentication feature in @knowcode/doc-builder to protect your documentation with basic..."><i class="fas fa-file-alt"></i> Authentication Guide</a>
+        <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>
+        <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>
+        <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
+        <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>
+        <a href="/guides/windows-setup-guide.html" class="nav-item active" 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>
+        <!-- Content Area -->
+        <main class="content">
+            <div class="content-inner">
+                <h1>Windows Setup Guide for Claude Code &amp; @knowcode/doc-builder</h1>
+<p><strong>Generated</strong>: 2025-01-22 UTC<br><strong>Status</strong>: Complete<br><strong>Verified</strong>: <i class="ph ph-check-circle" aria-label="checked"></i></p>
+<h2>Overview</h2>
+<p>This guide helps Windows users set up the complete AI-powered documentation workflow using Claude Code, @knowcode/doc-builder, and Vercel. Based on real troubleshooting experience, this guide addresses common Windows-specific challenges and provides clear solutions.</p>
+<h2>Quick Prerequisites Overview</h2>
+<p><strong>Required Accounts:</strong></p>
+<ul>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Claude Pro or Max</strong> subscription ($20-200/month) - <a href="https://claude.ai">claude.ai</a></li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>Vercel</strong> account (free Hobby plan) - <a href="https://vercel.com">vercel.com</a></li>
+<li><i class="ph ph-star" aria-label="star"></i> <strong>GitHub</strong> account (optional but recommended) - <a href="https://github.com">github.com</a></li>
+</ul>
+<p><strong>Required Software:</strong></p>
+<ul>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Windows 10/11 with Administrator access</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Node.js 14+ and npm - <a href="https://nodejs.org">nodejs.org</a></li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Git for Windows - <a href="https://gitforwindows.org">gitforwindows.org</a></li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> PowerShell 5.1+ (included with Windows)</li>
+<li><i class="ph ph-star" aria-label="star"></i> Visual Studio Code (recommended) - <a href="https://code.visualstudio.com">code.visualstudio.com</a></li>
+</ul>
+<h2>The Three-Part System</h2>
+<p>Understanding the conceptual separation is crucial:</p>
+<table>
+<tr>
+<td width="33%">
+<h3>1. Claude Code</h3>
+<p><strong>Purpose</strong>: Create markdown content<br><strong>What it does</strong>: AI-powered content generation<br><strong>Output</strong>: <code>.md</code> files with documentation</p>
+</td>
+<td width="33%">
+<h3>2. doc-builder</h3>
+<p><strong>Purpose</strong>: Convert MD to HTML<br><strong>What it does</strong>: Beautiful static site generation<br><strong>Output</strong>: Styled HTML website</p>
+</td>
+<td width="33%">
+<h3>3. Vercel</h3>
+<p><strong>Purpose</strong>: Host the website<br><strong>What it does</strong>: Free web hosting<br><strong>Output</strong>: Live URL for your docs</p>
+</td>
+</tr>
+</table>
+<h2>Complete Prerequisites Summary</h2>
+<h3>Required Accounts</h3>
+<table>
+<thead>
+<tr>
+<th>Service</th>
+<th>Purpose</th>
+<th>Requirements</th>
+<th>Sign Up Link</th>
+</tr>
+</thead>
+<tbody><tr>
+<td><strong>Claude</strong></td>
+<td>AI content generation</td>
+<td>Pro ($20/mo) or Team ($30/mo) plan</td>
+<td><a href="https://claude.ai">claude.ai</a></td>
+</tr>
+<tr>
+<td><strong>Vercel</strong></td>
+<td>Free web hosting</td>
+<td>Free Hobby account sufficient</td>
+<td><a href="https://vercel.com">vercel.com</a></td>
+</tr>
+<tr>
+<td><strong>GitHub</strong></td>
+<td>Version control (optional)</td>
+<td>Free account for Vercel integration</td>
+<td><a href="https://github.com">github.com</a></td>
+</tr>
+</tbody></table>
+<h3>Software Requirements</h3>
+<table>
+<thead>
+<tr>
+<th>Software</th>
+<th>Version</th>
+<th>Purpose</th>
+<th>Required?</th>
+</tr>
+</thead>
+<tbody><tr>
+<td><strong>Windows</strong></td>
+<td>10 or 11</td>
+<td>Operating system</td>
+<td><i class="ph ph-check-circle" aria-label="checked"></i> Required</td>
+</tr>
+<tr>
+<td><strong>Node.js</strong></td>
+<td>14.0+</td>
+<td>JavaScript runtime</td>
+<td><i class="ph ph-check-circle" aria-label="checked"></i> Required</td>
+</tr>
+<tr>
+<td><strong>npm</strong></td>
+<td>(included)</td>
+<td>Package manager</td>
+<td><i class="ph ph-check-circle" aria-label="checked"></i> Required</td>
+</tr>
+<tr>
+<td><strong>Git</strong></td>
+<td>Latest</td>
+<td>Version control</td>
+<td><i class="ph ph-check-circle" aria-label="checked"></i> Required</td>
+</tr>
+<tr>
+<td><strong>PowerShell</strong></td>
+<td>5.1+</td>
+<td>Command line</td>
+<td><i class="ph ph-check-circle" aria-label="checked"></i> Required</td>
+</tr>
+<tr>
+<td><strong>VS Code</strong></td>
+<td>Latest</td>
+<td>Code editor</td>
+<td><i class="ph ph-star" aria-label="star"></i> Recommended</td>
+</tr>
+</tbody></table>
+<h3>Administrative Requirements</h3>
+<ul>
+<li><strong>Administrator access</strong> on Windows (for PowerShell execution policy)</li>
+<li><strong>Internet connection</strong> for downloading tools and deploying</li>
+<li><strong>Email address</strong> for account creation</li>
+</ul>
+<h3>Installation Order</h3>
+<table>
+<thead>
+<tr>
+<th>Step</th>
+<th>Component</th>
+<th>Required For</th>
+<th>Download Link</th>
+</tr>
+</thead>
+<tbody><tr>
+<td>1</td>
+<td>Node.js &amp; npm</td>
+<td>doc-builder</td>
+<td><a href="https://nodejs.org/en/download/">Download Node.js</a></td>
+</tr>
+<tr>
+<td>2</td>
+<td>Git for Windows</td>
+<td>Claude Code</td>
+<td><a href="https://gitforwindows.org/">Download Git</a></td>
+</tr>
+<tr>
+<td>3</td>
+<td>Visual Studio Code</td>
+<td>Development</td>
+<td><a href="https://code.visualstudio.com/">Download VS Code</a></td>
+</tr>
+<tr>
+<td>4</td>
+<td>Claude Code CLI</td>
+<td>AI content</td>
+<td>Via npm (see below)</td>
+</tr>
+<tr>
+<td>5</td>
+<td>Vercel CLI</td>
+<td>Deployment</td>
+<td>Via npm (see below)</td>
+</tr>
+</tbody></table>
+<h3>Account Setup Checklist</h3>
+<ul>
+<li><p><input disabled="" type="checkbox">
+<strong>Claude Account</strong></p>
+<ul>
+<li><input disabled="" type="checkbox"> Sign up at <a href="https://claude.ai">claude.ai</a></li>
+<li><input disabled="" type="checkbox"> Subscribe to Pro ($20/mo) or Team ($30/mo) plan</li>
+<li><input disabled="" type="checkbox"> Verify email</li>
+</ul>
+</li>
+<li><p><input disabled="" type="checkbox">
+<strong>Vercel Account</strong></p>
+<ul>
+<li><input disabled="" type="checkbox"> Sign up at <a href="https://vercel.com">vercel.com</a></li>
+<li><input disabled="" type="checkbox"> Choose Hobby (free) plan</li>
+<li><input disabled="" type="checkbox"> Verify email</li>
+</ul>
+</li>
+<li><p><input disabled="" type="checkbox">
+<strong>GitHub Account</strong> (Optional but recommended)</p>
+<ul>
+<li><input disabled="" type="checkbox"> Sign up at <a href="https://github.com">github.com</a></li>
+<li><input disabled="" type="checkbox"> Configure username and email</li>
+<li><input disabled="" type="checkbox"> Enable 2FA (recommended)</li>
+</ul>
+</li>
+</ul>
+<h2>Step 1: Enable PowerShell Script Execution</h2>
+<p><strong><i class="ph ph-warning-circle" aria-label="warning"></i> IMPORTANT</strong>: This must be done FIRST as Administrator</p>
+<h3>Open PowerShell as Administrator</h3>
+<ol>
+<li>Press <code>Windows + X</code></li>
+<li>Select <strong>Terminal (Admin)</strong> or <strong>Windows PowerShell (Admin)</strong></li>
+<li>Click <strong>Yes</strong> when prompted by User Account Control</li>
+</ol>
+<h3>Enable Script Execution</h3>
+<p>Run this command in the Administrator PowerShell:</p>
+<pre><code class="language-powershell">Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+</code></pre>
+<p>When prompted, type <code>Y</code> and press Enter.</p>
+<h3>Verify the Change</h3>
+<pre><code class="language-powershell">Get-ExecutionPolicy
+</code></pre>
+<p>Should return: <code>RemoteSigned</code></p>
+<h2>Step 2: Install Node.js and npm</h2>
+<h3>Download and Install</h3>
+<ol>
+<li>Go to <a href="https://nodejs.org/en/download/">Node.js Downloads</a></li>
+<li>Download the <strong>Windows Installer (.msi)</strong> for your system (64-bit recommended)</li>
+<li>Run the installer with these settings:<ul>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Accept the license agreement</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Default installation location</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> <strong>IMPORTANT</strong>: Ensure &quot;npm package manager&quot; is checked</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Add to PATH (should be checked by default)</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Automatically install necessary tools (optional but recommended)</li>
+</ul>
+</li>
+</ol>
+<h3>Verify Installation</h3>
+<p>Open a <strong>new</strong> PowerShell window (not as admin) and run:</p>
+<pre><code class="language-powershell">node -v
+npm -v
+</code></pre>
+<p>You should see version numbers for both commands.</p>
+<h3>Troubleshooting npm Issues</h3>
+<p>If you get &quot;running scripts is disabled&quot; error:</p>
+<ol>
+<li>You didn&#39;t enable PowerShell execution policy (go back to Step 1)</li>
+<li>You need to close and reopen PowerShell after installing Node.js</li>
+<li>Try running PowerShell as Administrator</li>
+</ol>
+<h2>Step 3: Install Git for Windows</h2>
+<h3>Download and Install</h3>
+<ol>
+<li>Go to <a href="https://gitforwindows.org/">Git for Windows</a></li>
+<li>Download the installer</li>
+<li>Run with these recommended settings:<ul>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Use Visual Studio Code as default editor</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Git from the command line and also from 3rd-party software</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Use bundled OpenSSH</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Checkout Windows-style, commit Unix-style line endings</li>
+<li><i class="ph ph-check-circle" aria-label="checked"></i> Use Windows&#39; default console window</li>
+</ul>
+</li>
+</ol>
+<h3>Verify Installation</h3>
+<pre><code class="language-powershell">git --version
+</code></pre>
+<h2>Step 4: Set Up Claude Code</h2>
+<h3>Understanding Claude Plans</h3>
+<p>Claude Code requires a Claude Pro or Team plan subscription:</p>
+<table>
+<thead>
+<tr>
+<th>Plan</th>
+<th>Price</th>
+<th>Best For</th>
+<th>Details</th>
+</tr>
+</thead>
+<tbody><tr>
+<td><strong>Claude Pro</strong></td>
+<td>$20/month</td>
+<td>Individual developers</td>
+<td>Personal use, full Claude Code access</td>
+</tr>
+<tr>
+<td><strong>Claude Team</strong></td>
+<td>$30/month/user</td>
+<td>Teams &amp; businesses</td>
+<td>Shared workspace, higher limits</td>
+</tr>
+</tbody></table>
+<p><strong>Note</strong>: Your Pro/Max plan subscription enables Claude Code usage. See <a href="https://support.anthropic.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan">Using Claude Code with Pro/Max Plans</a></p>
+<h3>Install Claude Code CLI</h3>
+<pre><code class="language-powershell">npm install -g @anthropic/claude-code
+</code></pre>
+<h3>Initialize Claude Code</h3>
+<pre><code class="language-powershell">claude
+</code></pre>
+<p>Follow the prompts:</p>
+<ol>
+<li>Choose <strong>Dark mode</strong> or <strong>Light mode</strong></li>
+<li>Select <strong>Login with Claude account</strong></li>
+<li>Authorize in your browser</li>
+<li>Return to terminal when complete</li>
+</ol>
+<h3>Verify Setup</h3>
+<pre><code class="language-powershell">claude --version
+</code></pre>
+<h2>Step 5: Install @knowcode/doc-builder</h2>
+<h3>Global Installation (Recommended)</h3>
+<pre><code class="language-powershell">npm install -g @knowcode/doc-builder@latest
+</code></pre>
+<h3>Verify Installation</h3>
+<pre><code class="language-powershell">doc-builder --version
+</code></pre>
+<h3>Create Project Folder</h3>
+<pre><code class="language-powershell">cd Documents
+mkdir my-docs-project
+cd my-docs-project
+</code></pre>
+<h2>Step 6: Set Up Vercel</h2>
+<h3>Understanding Vercel Plans</h3>
+<table>
+<thead>
+<tr>
+<th>Plan</th>
+<th>Price</th>
+<th>Features</th>
+<th>Best For</th>
+</tr>
+</thead>
+<tbody><tr>
+<td><strong>Hobby</strong></td>
+<td>Free</td>
+<td>Unlimited static sites, HTTPS, Global CDN</td>
+<td>Personal projects, documentation</td>
+</tr>
+<tr>
+<td><strong>Pro</strong></td>
+<td>$20/month</td>
+<td>Team features, analytics, support</td>
+<td>Professional use</td>
+</tr>
+</tbody></table>
+<p>The free Hobby plan is perfect for documentation sites!</p>
+<h3>Create Vercel Account</h3>
+<ol>
+<li>Go to <a href="https://vercel.com">Vercel</a></li>
+<li>Click <strong>Sign Up</strong></li>
+<li>Choose <strong>Continue with Google</strong> or email</li>
+<li>Select <strong>Hobby</strong> plan (free)</li>
+</ol>
+<h3>Install Vercel CLI</h3>
+<pre><code class="language-powershell">npm install -g vercel@latest
+</code></pre>
+<h3>Login to Vercel</h3>
+<pre><code class="language-powershell">vercel login
+</code></pre>
+<p>This will open your browser for authentication.</p>
+<h2>Step 7: Complete Workflow Example</h2>
+<h3>1. Create Documentation with Claude Code</h3>
+<p>In Visual Studio Code terminal:</p>
+<pre><code class="language-powershell">claude
+</code></pre>
+<p>Then ask Claude to create documentation:</p>
+<pre><code>Create a comprehensive technical documentation for my API including authentication, endpoints, and examples
+</code></pre>
+<h3>2. Build HTML with doc-builder</h3>
+<pre><code class="language-powershell">doc-builder build
+</code></pre>
+<h3>3. Deploy to Vercel</h3>
+<pre><code class="language-powershell">doc-builder deploy
+</code></pre>
+<p>First deployment prompts:</p>
+<ul>
+<li><strong>Set up and deploy?</strong> → Yes (Y)</li>
+<li><strong>Project name?</strong> → my-api-docs (use lowercase, hyphens)</li>
+<li><strong>Link to existing project?</strong> → No (N)</li>
+<li><strong>Modify settings?</strong> → No (N)</li>
+</ul>
+<h3>4. Make Site Public</h3>
+<p>After deployment:</p>
+<ol>
+<li>Go to <a href="https://vercel.com/dashboard">Vercel Dashboard</a></li>
+<li>Click your project</li>
+<li>Go to <strong>Settings</strong> → <strong>Deployment Protection</strong></li>
+<li>Set <strong>Vercel Authentication</strong> to <strong>Disabled</strong></li>
+<li>Click <strong>Save</strong></li>
+</ol>
+<p>Your documentation is now live at <code>https://your-project.vercel.app</code>!</p>
+<h2>Common Windows Issues &amp; Solutions</h2>
+<h3>PowerShell Execution Policy Error</h3>
+<p><strong>Error</strong>: &quot;running scripts is disabled on this system&quot;</p>
+<p><strong>Solution</strong>:</p>
+<pre><code class="language-powershell"># Run PowerShell as Administrator
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
+</code></pre>
+<p>See detailed guide: <a href="https://dev.to/jackfd120/resolving-npm-execution-policy-error-in-powershell-a-step-by-step-guide-for-developers-32ip">Resolving npm Execution Policy Error</a></p>
+<h3>npm Command Not Found</h3>
+<p><strong>Causes</strong>:</p>
+<ol>
+<li>Node.js not installed properly</li>
+<li>PATH not updated</li>
+<li>Need to restart PowerShell</li>
+</ol>
+<p><strong>Solution</strong>:</p>
+<ol>
+<li>Reinstall Node.js using the official installer</li>
+<li>Ensure &quot;Add to PATH&quot; is checked during installation</li>
+<li>Close all PowerShell windows and open new ones</li>
+</ol>
+<h3>Git Bash Required Error</h3>
+<p><strong>Error</strong>: &quot;Claude Code requires Git bash&quot;</p>
+<p><strong>Solution</strong>:<br>Install Git for Windows from <a href="https://gitforwindows.org/">gitforwindows.org</a></p>
+<h3>Vercel CLI Authentication Issues</h3>
+<p><strong>Error</strong>: &quot;Please login to Vercel&quot;</p>
+<p><strong>Solution</strong>:</p>
+<pre><code class="language-powershell">vercel logout
+vercel login
+</code></pre>
+<h2>Best Practices</h2>
+<h3>Folder Structure</h3>
+<pre><code>Documents/
+├── my-projects/
+│   ├── project1-docs/
+│   │   ├── docs/           # Markdown files
+│   │   ├── html/           # Generated HTML
+│   │   └── doc-builder.config.js
+│   └── project2-docs/
+</code></pre>
+<h3>Workflow Tips</h3>
+<ol>
+<li><strong>Use Visual Studio Code</strong> - Better terminal integration</li>
+<li><strong>Create separate folders</strong> for each documentation project</li>
+<li><strong>Use @latest</strong> - Always use <code>@latest</code> to avoid npm cache issues</li>
+<li><strong>Regular commits</strong> - Use Git to track changes</li>
+</ol>
+<h3>Security Notes</h3>
+<ol>
+<li><strong>Run as Admin only when required</strong> - Only for PowerShell policy changes</li>
+<li><strong>Keep credentials secure</strong> - Don&#39;t share Claude or Vercel tokens</li>
+<li><strong>Use .gitignore</strong> - Exclude sensitive files from Git</li>
+</ol>
+<h2>Quick Reference Commands</h2>
+<h3>Daily Workflow</h3>
+<pre><code class="language-powershell"># 1. Create/edit content
+claude
+# 2. Build HTML
+doc-builder build
+# 3. Deploy updates
+doc-builder deploy --prod
+</code></pre>
+<h3>Troubleshooting Commands</h3>
+<pre><code class="language-powershell"># Check installations
+node -v
+npm -v
+git --version
+claude --version
+vercel --version
+# Update tools
+npm update -g @knowcode/doc-builder@latest
+npm update -g vercel@latest
+# Clear npm cache
+npm cache clean --force
+</code></pre>
+<h2>Additional Resources</h2>
+<h3>Official Documentation</h3>
+<ul>
+<li><a href="https://learn.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows">Node.js on Windows Guide</a></li>
+<li><a href="https://vercel.com/docs/cli">Vercel CLI Documentation</a></li>
+<li><a href="https://support.anthropic.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan">Claude Code with Pro/Max Plans</a></li>
+<li><a href="https://www.npmjs.com/package/@knowcode/doc-builder">@knowcode/doc-builder on npm</a></li>
+</ul>
+<h3>Troubleshooting Guides</h3>
+<ul>
+<li><a href="https://dev.to/jackfd120/resolving-npm-execution-policy-error-in-powershell-a-step-by-step-guide-for-developers-32ip">PowerShell Execution Policy</a></li>
+<li><a href="https://gitforwindows.org/">Git for Windows Setup</a></li>
+</ul>
+<h2>Conclusion</h2>
+<p>With this setup, you can create professional documentation in minutes:</p>
+<ol>
+<li><strong>Claude Code</strong> generates the content</li>
+<li><strong>doc-builder</strong> makes it beautiful</li>
+<li><strong>Vercel</strong> shares it with the world</li>
+</ol>
+<p>The initial setup takes about 30 minutes, but once configured, you can create and deploy documentation sites in under 5 minutes!</p>
+<hr>
+<p><strong>Need help?</strong> File issues at the respective project repositories or check the troubleshooting sections above.</p>
+            </div>
+        </main>
+    </div>
+    <!-- Scripts -->
+    <script src="/js/main.js"></script>
+</body>
+</html>