@knowcode/doc-builder 1.1.4 → 1.1.5

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.1.5] - 2025-01-19
+
+### Added
+- Clear explanation of Vercel URLs after deployment
+- Shows permanent production URL (e.g., gasworld.vercel.app)
+- Explains the difference between production and preview URLs
+- Better post-deployment messaging
+
+### Improved
+- Deployment success message now shows both URLs clearly
+- Production URL is highlighted as the one to share
+- Preview URL is explained as deployment-specific
+
 ## [1.1.4] - 2025-01-19
 
 ### Fixed

package/cli.js

@@ -319,7 +319,28 @@ ${chalk.yellow('Troubleshooting:')}
       // Default to production deployment
       const isProduction = options.prod !== false;  // Default true unless explicitly --no-prod
       const url = await deployToVercel(config, isProduction);
-      spinner.succeed(`Deployed successfully! ${chalk.cyan(url)}`);
+      spinner.succeed(`Deployed successfully!`);
+      
+      // Extract project name from URL
+      const projectName = url.match(/https:\/\/([^-]+)/)?.[1] || 'your-project';
+      
+      console.log(chalk.green('\n✅ Deployment Complete!\n'));
+      
+      if (isProduction) {
+        console.log(chalk.yellow('🌐 Your documentation is live at:'));
+        console.log(chalk.cyan.bold(`   ${projectName}.vercel.app`) + chalk.gray(' (Production URL - share this!)'));
+        console.log();
+        console.log(chalk.gray('This deployment also created a unique preview URL:'));
+        console.log(chalk.gray(`   ${url}`));
+        console.log(chalk.gray('   (This URL is specific to this deployment)'));
+      } else {
+        console.log(chalk.yellow('🔍 Preview deployment created at:'));
+        console.log(chalk.cyan(`   ${url}`));
+        console.log();
+        console.log(chalk.gray('To deploy to production, run:'));
+        console.log(chalk.gray('   npx @knowcode/doc-builder deploy'));
+      }
+      console.log();
       
     } catch (error) {
       spinner.fail('Deployment failed');
@@ -510,7 +531,19 @@ program
       
       // Default to production deployment
       const url = await deployToVercel(config, true);
-      deploySpinner.succeed(`Deployed successfully! ${chalk.cyan(url)}`);
+      deploySpinner.succeed(`Deployed successfully!`);
+      
+      // Extract project name from URL
+      const projectName = url.match(/https:\/\/([^-]+)/)?.[1] || 'your-project';
+      
+      console.log(chalk.green('\n✅ Deployment Complete!\n'));
+      console.log(chalk.yellow('🌐 Your documentation is live at:'));
+      console.log(chalk.cyan.bold(`   ${projectName}.vercel.app`) + chalk.gray(' (Production URL - share this!)'));
+      console.log();
+      console.log(chalk.gray('This deployment also created a unique preview URL:'));
+      console.log(chalk.gray(`   ${url}`));
+      console.log(chalk.gray('   (This URL is specific to this deployment)'));
+      console.log();
       
     } catch (error) {
       console.error(chalk.red('\nError: ' + error.message));

package/package.json

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