@knowcode/doc-builder 1.0.10 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,37 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-01-19
+
+### Changed (BREAKING)
+- **Deploy command now defaults to production deployment**
+- Use `--no-prod` flag for preview deployments
+- Default action (no command) deploys to production
+- This ensures documentation is always published to main URL
+
+### Updated
+- All help text and examples reflect production default
+- CLI description clarifies production deployment
+- Example files use simplified deploy command
+
+### Migration
+- Previous: `npx @knowcode/doc-builder deploy --prod`
+- Now: `npx @knowcode/doc-builder deploy`
+- For preview: `npx @knowcode/doc-builder deploy --no-prod`
+
+## [1.0.11] - 2025-01-19
+
+### Added
+- Comprehensive troubleshooting for "buildCommand" errors in help
+- Troubleshooting for "Project was deleted" errors
+- "Delete and Start Fresh" section in deployment help
+- Enhanced reset-vercel command documentation
+
+### Improved
+- Clearer instructions for handling deleted projects
+- Better organization of troubleshooting scenarios
+- Added specific commands for each error type
+
 ## [1.0.10] - 2025-01-19
 
 ### Fixed

package/cli.js

@@ -45,7 +45,7 @@ ${chalk.yellow('Quick Start:')}
      ${chalk.gray('$')} echo "# My Documentation" > docs/README.md
   
   ${chalk.cyan('2. Build and deploy:')}
-     ${chalk.gray('$')} npx @knowcode/doc-builder              ${chalk.gray('# Build and deploy to Vercel')}
+     ${chalk.gray('$')} npx @knowcode/doc-builder              ${chalk.gray('# Build and deploy to production')}
      ${chalk.gray('   or')}
      ${chalk.gray('$')} npx @knowcode/doc-builder build        ${chalk.gray('# Build HTML files only')}
      ${chalk.gray('$')} npx @knowcode/doc-builder dev          ${chalk.gray('# Start development server')}
@@ -116,15 +116,15 @@ ${chalk.yellow('Examples:')}
 // Deploy command
 program
   .command('deploy')
-  .description('Deploy documentation to Vercel (requires Vercel CLI)')
+  .description('Deploy documentation to Vercel production (requires Vercel CLI)')
   .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
-  .option('--prod', 'deploy to production (default: preview deployment)')
+  .option('--no-prod', 'deploy as preview instead of production')
   .option('--no-build', 'skip building before deployment')
   .option('--force', 'force deployment without confirmation')
   .addHelpText('after', `
 ${chalk.yellow('Examples:')}
-  ${chalk.gray('$')} doc-builder deploy                 ${chalk.gray('# Deploy preview to Vercel')}
-  ${chalk.gray('$')} doc-builder deploy --prod          ${chalk.gray('# Deploy to production')}
+  ${chalk.gray('$')} doc-builder deploy                 ${chalk.gray('# Deploy to production')}
+  ${chalk.gray('$')} doc-builder deploy --no-prod       ${chalk.gray('# Deploy preview only')}
   ${chalk.gray('$')} doc-builder deploy --no-build      ${chalk.gray('# Deploy existing build')}
 
 ${chalk.yellow('First-time Vercel Setup:')}
@@ -184,8 +184,20 @@ ${chalk.yellow('First-time Vercel Setup:')}
      • This allows public access to your docs
      
 ${chalk.yellow('Subsequent Deployments:')}
-  ${chalk.gray('$')} npx @knowcode/doc-builder          ${chalk.gray('# Deploy preview')}
-  ${chalk.gray('$')} npx @knowcode/doc-builder deploy --prod  ${chalk.gray('# Deploy to production')}
+  ${chalk.gray('$')} npx @knowcode/doc-builder          ${chalk.gray('# Build and deploy to production')}
+  ${chalk.gray('$')} npx @knowcode/doc-builder deploy   ${chalk.gray('# Deploy to production')}
+  ${chalk.gray('$')} npx @knowcode/doc-builder deploy --no-prod  ${chalk.gray('# Deploy preview only')}
+
+${chalk.yellow('When All Else Fails - Delete and Start Fresh:')}
+  Sometimes the cleanest solution is to delete the Vercel project:
+  
+  1. Go to your project settings on Vercel
+  2. Scroll to bottom and click ${chalk.red('"Delete Project"')}
+  3. Run: ${chalk.gray('npx @knowcode/doc-builder reset-vercel')}
+  4. Run: ${chalk.gray('npx @knowcode/doc-builder deploy')}
+  5. Create a NEW project with correct settings
+  
+  This removes all conflicting configurations!
 
 ${chalk.yellow('Troubleshooting:')}
   • ${chalk.cyan('Command not found:')} Install Vercel CLI globally
@@ -209,6 +221,25 @@ ${chalk.yellow('Troubleshooting:')}
     2. Run deployment again
     3. When asked "Link to existing project?" say ${chalk.red.bold('NO')}
     4. Create a new project with your actual name
+    
+  ${chalk.red.bold('• "buildCommand should be string,null" error:')}
+    ${chalk.yellow('Your Vercel project has conflicting build settings.')}
+    
+    ${chalk.green('Fix:')}
+    1. Go to project settings > Build & Development Settings
+    2. Clear ALL fields (Build Command, Output Directory, etc.)
+    3. Save and try again
+    ${chalk.gray('OR')}
+    Delete the project and start fresh (see below)
+    
+  ${chalk.red.bold('• "Project was deleted or you don\'t have access" error:')}
+    ${chalk.yellow('The Vercel project was deleted but local config remains.')}
+    
+    ${chalk.green('Fix:')}
+    ${chalk.gray('$')} npx @knowcode/doc-builder reset-vercel
+    ${chalk.gray('$')} npx @knowcode/doc-builder deploy
+    
+    This removes old project references and starts fresh
 `)
   .action(async (options) => {
     const spinner = ora('Deploying to Vercel...').start();
@@ -278,7 +309,9 @@ ${chalk.yellow('Troubleshooting:')}
       }
       
       spinner.start('Deploying to Vercel...');
-      const url = await deployToVercel(config, options.prod);
+      // Default to production deployment
+      const isProduction = options.prod !== false;  // Default true unless explicitly --no-prod
+      const url = await deployToVercel(config, isProduction);
       spinner.succeed(`Deployed successfully! ${chalk.cyan(url)}`);
       
     } catch (error) {
@@ -307,6 +340,9 @@ ${chalk.yellow('When to use:')}
   • After "html/html does not exist" error
   • When linked to wrong project (e.g., username/html)
   • When Root Directory settings are incorrect
+  • After deleting a Vercel project
+  • When you get "Project was deleted" errors
+  • Any time you want to start fresh with deployment
 `)
   .action(async (options) => {
     try {
@@ -389,7 +425,7 @@ ${chalk.yellow('What gets created:')}
         // Create example files
         const exampleFiles = {
           'README.md': `# Welcome to Your Documentation\n\nThis is an example documentation site created with @knowcode/doc-builder.\n\n## Features\n\n- 📝 Write in Markdown\n- 🎨 Beautiful Notion-inspired design\n- 📊 Mermaid diagram support\n- 🌙 Dark mode\n- 🚀 Deploy to Vercel\n\n## Getting Started\n\n1. Edit this file and add your content\n2. Create new markdown files\n3. Run \`npx @knowcode/doc-builder\` to build and deploy\n\n## Example Diagram\n\n\`\`\`mermaid\ngraph TD\n    A[Write Docs] --> B[Build]\n    B --> C[Deploy]\n    C --> D[Share]\n\`\`\`\n`,
-          'getting-started.md': `# Getting Started\n\n**Generated**: ${new Date().toISOString().split('T')[0]}\n**Status**: Draft\n**Verified**: ❓\n\n## Overview\n\nThis guide will help you get started with your documentation.\n\n## Installation\n\nNo installation required! Just use:\n\n\`\`\`bash\nnpx @knowcode/doc-builder\n\`\`\`\n\n## Writing Documentation\n\n1. Create markdown files in the \`docs\` folder\n2. Use folders to organize your content\n3. Add front matter for metadata\n\n## Building\n\nTo build your documentation:\n\n\`\`\`bash\nnpx @knowcode/doc-builder build\n\`\`\`\n\n## Deployment\n\nDeploy to Vercel:\n\n\`\`\`bash\nnpx @knowcode/doc-builder deploy --prod\n\`\`\`\n`,
+          'getting-started.md': `# Getting Started\n\n**Generated**: ${new Date().toISOString().split('T')[0]}\n**Status**: Draft\n**Verified**: ❓\n\n## Overview\n\nThis guide will help you get started with your documentation.\n\n## Installation\n\nNo installation required! Just use:\n\n\`\`\`bash\nnpx @knowcode/doc-builder\n\`\`\`\n\n## Writing Documentation\n\n1. Create markdown files in the \`docs\` folder\n2. Use folders to organize your content\n3. Add front matter for metadata\n\n## Building\n\nTo build your documentation:\n\n\`\`\`bash\nnpx @knowcode/doc-builder build\n\`\`\`\n\n## Deployment\n\nDeploy to Vercel:\n\n\`\`\`bash\nnpx @knowcode/doc-builder deploy\n\`\`\`\n`,
           'guides/configuration.md': `# Configuration Guide\n\n**Generated**: ${new Date().toISOString().split('T')[0]}\n**Status**: Draft\n**Verified**: ❓\n\n## Overview\n\n@knowcode/doc-builder works with zero configuration, but you can customize it.\n\n## Configuration File\n\nCreate \`doc-builder.config.js\`:\n\n\`\`\`javascript\nmodule.exports = {\n  siteName: 'My Documentation',\n  siteDescription: 'Documentation for my project',\n  \n  features: {\n    authentication: false,\n    changelog: true,\n    mermaid: true,\n    darkMode: true\n  }\n};\n\`\`\`\n\n## Options\n\n### Site Information\n\n- \`siteName\`: Your documentation site name\n- \`siteDescription\`: Brief description\n\n### Directories\n\n- \`docsDir\`: Input directory (default: 'docs')\n- \`outputDir\`: Output directory (default: 'html')\n\n### Features\n\n- \`authentication\`: Enable password protection\n- \`changelog\`: Generate changelog automatically\n- \`mermaid\`: Support for diagrams\n- \`darkMode\`: Dark theme support\n`
         };
         
@@ -419,8 +455,8 @@ ${chalk.yellow('What gets created:')}
 // Add a default command handler for when doc-builder is run without arguments
 program
   .action(async () => {
-    // Default action is build + deploy
-    console.log(chalk.cyan('\n🚀 Building and deploying your documentation...\n'));
+    // Default action is build + deploy to production
+    console.log(chalk.cyan('\n🚀 Building and deploying your documentation to production...\n'));
     
     try {
       // Build first
@@ -465,7 +501,8 @@ program
         deploySpinner.start('Deploying to Vercel...');
       }
       
-      const url = await deployToVercel(config, false);
+      // Default to production deployment
+      const url = await deployToVercel(config, true);
       deploySpinner.succeed(`Deployed successfully! ${chalk.cyan(url)}`);
       
     } catch (error) {

package/package.json

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