@knowcode/doc-builder 1.0.10 → 1.0.11

package/CHANGELOG.md

@@ -5,6 +5,19 @@ 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

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/package.json

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