@knowcode/doc-builder 1.0.9 → 1.0.11

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.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
+- Fixed persistent "buildCommand should be string,null" error
+- vercel.json now explicitly sets buildCommand to empty string
+- Added explicit build environment variables to deployment
+- Added specific error handling for buildCommand conflicts
+
+### Added
+- Better error messages for build settings conflicts
+- Instructions to clear Vercel project settings
+- Alternative reset instructions when settings conflict
+
+### Changed
+- Deploy command now includes build skip flags
+- All build-related fields explicitly set to empty strings
+
 ## [1.0.9] - 2025-01-19
 
 ### Fixed

package/cli.js

@@ -187,6 +187,17 @@ ${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.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
   • ${chalk.cyan('Not authenticated:')} Run ${chalk.gray('vercel login')}
@@ -209,6 +220,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();
@@ -307,6 +337,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 {

package/lib/deploy.js

@@ -58,10 +58,13 @@ async function setupVercelProject(config) {
     fs.mkdirSync(outputDir, { recursive: true });
   }
   
-  // Create minimal vercel.json for static site
-  // Only include required fields
+  // Create vercel.json that explicitly overrides build settings
   const vercelConfig = {
-    outputDirectory: "."
+    "buildCommand": "",
+    "outputDirectory": ".",
+    "devCommand": "",
+    "installCommand": "",
+    "framework": null
   };
   
   fs.writeJsonSync(vercelConfigPath, vercelConfig, { spaces: 2 });
@@ -194,21 +197,40 @@ async function deployToVercel(config, isProd = false) {
   // Create vercel.json in output directory for deployment
   const vercelConfigPath = path.join(outputPath, 'vercel.json');
   if (!fs.existsSync(vercelConfigPath)) {
-    // Create minimal vercel.json for static site
+    // Create vercel.json that explicitly overrides build settings
     const vercelConfig = {
-      outputDirectory: "."
+      "buildCommand": "",
+      "outputDirectory": ".",
+      "devCommand": "",
+      "installCommand": "",
+      "framework": null
     };
     fs.writeJsonSync(vercelConfigPath, vercelConfig, { spaces: 2 });
   }
   
-  // Deploy command
-  const deployCmd = isProd ? 'vercel --prod' : 'vercel';
+  // Deploy command with explicit build settings
+  // Override any project settings that might be causing issues
+  const deployArgs = [
+    '--build-env', 'VERCEL_BUILD_OUTPUT_DIRECTORY=.',
+    '--no-clipboard'
+  ];
+  
+  if (isProd) {
+    deployArgs.push('--prod');
+  }
+  
+  const deployCmd = `vercel ${deployArgs.join(' ')}`;
   
   try {
     // Run deployment from the output directory
     const output = execSync(deployCmd, { 
       cwd: outputPath,
-      encoding: 'utf8'
+      encoding: 'utf8',
+      env: {
+        ...process.env,
+        // Force Vercel to skip build
+        VERCEL_BUILD_SKIP: '1'
+      }
     });
     
     // Extract URL from output
@@ -234,6 +256,27 @@ async function deployToVercel(config, isProd = false) {
       
       throw new Error('Root Directory misconfiguration - see instructions above');
     }
+    
+    // Check if this is the buildCommand error
+    if (error.message && error.message.includes('buildCommand') && error.message.includes('should be string,null')) {
+      console.log(chalk.red.bold('\n❌ ERROR: Vercel has saved build settings that conflict!\n'));
+      console.log(chalk.yellow('Your Vercel project has build settings that need to be cleared.\n'));
+      
+      console.log(chalk.green.bold('🔧 TO FIX THIS:\n'));
+      console.log(chalk.white('Option 1 - Clear project settings:'));
+      console.log(chalk.cyan('1. Go to your project settings'));
+      console.log(chalk.cyan('2. Under "Build & Development Settings"'));
+      console.log(chalk.cyan('3. Clear ALL fields (Build Command, Output Directory, etc.)'));
+      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('3. Create a NEW project (don\'t link to existing)\n'));
+      
+      throw new Error('Build settings conflict - see instructions above');
+    }
+    
     throw new Error(`Vercel deployment failed: ${error.message}`);
   }
 }

package/package.json

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