@knowcode/doc-builder 1.0.6 → 1.0.7

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.7] - 2025-01-19
+
+### Added
+- New `reset-vercel` command to fix deployment issues
+- Pre-deployment warning about Root Directory settings
+- Automatic detection of "html/html does not exist" error with clear fix instructions
+- Visual deployment status with project information
+- Better error messages that extract and show the settings URL
+
+### Improved
+- Enhanced error handling with specific instructions for Root Directory issues
+- Clear visual separation for deployment warnings
+- More prominent pre-deployment checks
+- Direct links to Vercel project settings
+
+### Fixed
+- Better handling of the common "html/html" path error
+- Clearer recovery instructions when deployment fails
+
 ## [1.0.6] - 2025-01-19
 
 ### Added

package/cli.js

@@ -272,6 +272,48 @@ ${chalk.yellow('Troubleshooting:')}
     }
   });
 
+// Reset command for Vercel issues
+program
+  .command('reset-vercel')
+  .description('Reset Vercel configuration (fixes common deployment issues)')
+  .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
+  .addHelpText('after', `
+${chalk.yellow('What this does:')}
+  • Removes .vercel folder from your output directory
+  • Lets you set up a fresh Vercel project
+  • Fixes "html/html does not exist" errors
+  • Fixes wrong project linking issues
+
+${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
+`)
+  .action(async (options) => {
+    try {
+      const config = await loadConfig(options.config || 'doc-builder.config.js', options);
+      const outputPath = path.join(process.cwd(), config.outputDir || 'html');
+      const vercelPath = path.join(outputPath, '.vercel');
+      
+      if (fs.existsSync(vercelPath)) {
+        console.log(chalk.yellow('🗑️  Removing .vercel folder from ' + config.outputDir + '...'));
+        fs.removeSync(vercelPath);
+        console.log(chalk.green('✅ Vercel configuration reset!'));
+        console.log(chalk.gray('\nNow run deployment again:'));
+        console.log(chalk.cyan('  npx @knowcode/doc-builder deploy'));
+        console.log(chalk.gray('\nThis time:'));
+        console.log(chalk.gray('• Create a NEW project (not username/html)'));
+        console.log(chalk.gray('• Use a descriptive name like "my-docs"'));
+        console.log(chalk.gray('• Leave Root Directory EMPTY'));
+      } else {
+        console.log(chalk.gray('No .vercel folder found. Ready for fresh deployment!'));
+      }
+    } catch (error) {
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
+  });
+
 // Init command
 program
   .command('init')

package/lib/deploy.js

@@ -145,14 +145,31 @@ async function deployToVercel(config, isProd = false) {
     throw new Error(`Output directory ${outputPath} does not exist. Run 'doc-builder build' first.`);
   }
   
-  // Check for existing project link
+  // Check for existing project link and warn about common issues
   const vercelProjectPath = path.join(outputPath, '.vercel', 'project.json');
   if (fs.existsSync(vercelProjectPath)) {
     try {
       const projectInfo = fs.readJsonSync(vercelProjectPath);
-      console.log(chalk.yellow('\n⚠️  Deploying to existing project: ') + chalk.cyan(projectInfo.projectId || 'unknown'));
-      console.log(chalk.yellow('If deployment fails with path errors, check your Root Directory setting:'));
-      console.log(chalk.cyan(`https://vercel.com/dashboard/project/${projectInfo.projectId || 'settings'}\n`));
+      const projectId = projectInfo.projectId || 'unknown';
+      
+      console.log(chalk.blue('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+      console.log(chalk.yellow('📦 Deploying to existing Vercel project'));
+      console.log(chalk.blue('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+      
+      console.log(chalk.white('Project ID: ') + chalk.cyan(projectId));
+      
+      // Check if .vercel/project.json has rootDirectory set
+      if (projectInfo.settings && projectInfo.settings.rootDirectory) {
+        console.log(chalk.red.bold('\n⚠️  WARNING: Root Directory is set to: ') + chalk.yellow(projectInfo.settings.rootDirectory));
+        console.log(chalk.red('This may cause deployment to fail!\n'));
+      }
+      
+      console.log(chalk.yellow.bold('\n⚡ BEFORE CONTINUING:'));
+      console.log(chalk.white('1. Check your Root Directory setting at:'));
+      console.log(chalk.cyan(`   https://vercel.com/dashboard/project/${projectId}`));
+      console.log(chalk.white('2. Root Directory should be ') + chalk.green.bold('EMPTY (blank)'));
+      console.log(chalk.white('3. If it says "html", ') + chalk.red.bold('DELETE IT NOW!\n'));
+      
     } catch (e) {
       // Ignore read errors
     }
@@ -186,6 +203,23 @@ async function deployToVercel(config, isProd = false) {
     
     return deployUrl;
   } catch (error) {
+    // Check if this is the common "html/html" path error
+    if (error.message && error.message.includes('html/html') && error.message.includes('does not exist')) {
+      console.log(chalk.red.bold('\n❌ ERROR: Vercel has incorrect Root Directory settings!\n'));
+      console.log(chalk.yellow('The project is configured with Root Directory = "html"'));
+      console.log(chalk.yellow('But we are already deploying FROM the html directory.\n'));
+      
+      console.log(chalk.green.bold('🔧 TO FIX THIS:\n'));
+      console.log(chalk.white('1. Go to: ') + chalk.cyan(error.message.match(/https:\/\/vercel\.com\/[^\s]+/)?.[0] || 'https://vercel.com/dashboard'));
+      console.log(chalk.white('2. Find "Root Directory" under "Build & Development Settings"'));
+      console.log(chalk.white('3. ') + chalk.yellow.bold('DELETE the "html" value (leave it EMPTY)'));
+      console.log(chalk.white('4. Click "Save"'));
+      console.log(chalk.white('5. Run this command again\n'));
+      
+      console.log(chalk.gray('Alternative: Delete html/.vercel folder and set up fresh'));
+      
+      throw new Error('Root Directory misconfiguration - 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.6",
+  "version": "1.0.7",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {