@knowcode/doc-builder 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -5,6 +5,31 @@ 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.2] - 2025-01-19
+
+### Changed
+- Simplified deployment output - removed Root Directory warnings
+- Cleaner deployment experience with just essential information
+- Shows simple "Starting deployment" message instead of warnings
+
+### Removed
+- Pre-deployment Root Directory check and warnings
+- Project ID display during deployment
+- Verbose deployment preparation messages
+
+## [1.1.1] - 2025-01-19
+
+### Added
+- TL;DR section at the top of CLI help for quick understanding
+- Clear production deployment behavior explanation in help
+- Visual indicators for v1.1.0+ deployment changes
+- Examples showing production URLs vs preview URLs
+
+### Improved
+- Help text now prominently shows default production deployment
+- Added emoji and color highlights for important changes
+- Clearer deployment behavior section
+
 ## [1.1.0] - 2025-01-19
 
 ### Changed (BREAKING)

package/cli.js

@@ -27,11 +27,16 @@ program
   .addHelpText('before', `
 ${chalk.cyan('🚀 @knowcode/doc-builder')} - Transform your markdown into beautiful documentation sites
 
+${chalk.bgGreen.black(' TL;DR ')} ${chalk.green('Just run:')} ${chalk.cyan.bold('npx @knowcode/doc-builder')} ${chalk.green('→ Your docs are live on Vercel!')}
+
+${chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
+
 ${chalk.yellow('What it does:')}
   • Converts markdown files to static HTML with a beautiful Notion-inspired theme
   • Automatically generates navigation from your folder structure
   • Supports mermaid diagrams, syntax highlighting, and dark mode
   • Deploys to Vercel with one command (zero configuration)
+  • ${chalk.green.bold('NEW:')} Deploys directly to production by default (v1.1.0+)
   • Optional authentication to protect private documentation
 
 ${chalk.yellow('Requirements:')}
@@ -183,10 +188,12 @@ ${chalk.yellow('First-time Vercel Setup:')}
      • Under "Deployment Protection", set to ${chalk.yellow('Disabled')}
      • This allows public access to your docs
      
-${chalk.yellow('Subsequent Deployments:')}
-  ${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('Deployment Behavior (v1.1.0+):')}
+  ${chalk.green.bold('🎯 DEFAULT: All deployments go to PRODUCTION')}
+  
+  ${chalk.gray('$')} npx @knowcode/doc-builder          ${chalk.gray('# → yourdocs.vercel.app')}
+  ${chalk.gray('$')} npx @knowcode/doc-builder deploy   ${chalk.gray('# → yourdocs.vercel.app')}
+  ${chalk.gray('$')} npx @knowcode/doc-builder deploy --no-prod  ${chalk.gray('# → preview URL only')}
 
 ${chalk.yellow('When All Else Fails - Delete and Start Fresh:')}
   Sometimes the cleanest solution is to delete the Vercel project:

package/lib/deploy.js

@@ -164,35 +164,9 @@ 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 and warn about common issues
-  const vercelProjectPath = path.join(outputPath, '.vercel', 'project.json');
-  if (fs.existsSync(vercelProjectPath)) {
-    try {
-      const projectInfo = fs.readJsonSync(vercelProjectPath);
-      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
-    }
-  }
+  // Simple deployment message
+  console.log(chalk.blue('\n🚀 Starting deployment to Vercel...'));
+  console.log(chalk.gray('This will take a few seconds...\n'));
   
   // Create vercel.json in output directory for deployment
   const vercelConfigPath = path.join(outputPath, 'vercel.json');

package/package.json

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