@knowcode/doc-builder 1.0.9 → 1.0.10

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.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/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.10",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {