@knowcode/doc-builder 1.4.23 → 1.4.24

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.4.24] - 2025-07-21
+
+### Fixed
+- Deployment now shows the correct production URL from Vercel
+- Uses Vercel CLI to fetch the actual production alias
+- Shows clean URL like `doc-builder-delta.vercel.app` instead of deployment URL
+
+### Background
+- Previously showed deployment URLs like `doc-builder-i02vs7dur-lindsay-1340s-projects.vercel.app`
+- Now queries `vercel project ls` to get the actual production URL
+- Falls back to deployment URL if production URL cannot be determined
+
 ## [1.4.23] - 2025-07-21
 
 ### Added

package/cli.js

@@ -314,41 +314,38 @@ ${chalk.yellow('Troubleshooting:')}
       spinner.start('Deploying to Vercel...');
       // Default to production deployment
       const isProduction = options.prod !== false;  // Default true unless explicitly --no-prod
-      const url = await deployToVercel(config, isProduction);
+      const result = await deployToVercel(config, isProduction);
       spinner.succeed(`Deployed successfully!`);
       
-      // Extract project name from URL
-      // For production deployments, show the actual URL returned by Vercel
-      // For preview deployments, extract the base project name
-      let projectUrl = url;
-      let displayUrl = url;
-      
-      // If this is a preview URL (has random suffix), try to extract base project name
-      const urlMatch = url.match(/https:\/\/([^.]+)\.vercel\.app/);
-      if (urlMatch && urlMatch[1]) {
-        const fullDomain = urlMatch[1];
-        // Check if this looks like a preview URL with random suffix
-        if (fullDomain.match(/-[a-z0-9]{9}$/)) {
-          // It's a preview URL, extract base project name
-          const projectName = fullDomain.replace(/-[a-z0-9]{9}$/, '');
-          projectUrl = `https://${projectName}.vercel.app`;
-        }
+      // Handle both old and new return formats
+      let deployUrl, productionUrl;
+      if (typeof result === 'string') {
+        // Old format - just a URL string
+        deployUrl = result;
+        productionUrl = null;
+      } else {
+        // New format - object with deployUrl and productionUrl
+        deployUrl = result.deployUrl;
+        productionUrl = result.productionUrl;
       }
       
+      // Use the production URL if available, otherwise show the deployment URL
+      const displayUrl = productionUrl || deployUrl;
+      
       console.log(chalk.green('\n✅ Deployment Complete!\n'));
       
       if (isProduction) {
         console.log(chalk.yellow('🌐 Your documentation is live at:'));
-        console.log(chalk.cyan.bold(`   ${projectUrl}`) + chalk.gray(' (Production URL - share this!)'));
+        console.log(chalk.cyan.bold(`   ${displayUrl}`) + chalk.gray(' (Production URL - share this!)'));
         console.log();
-        if (projectUrl !== url) {
+        if (productionUrl && deployUrl && productionUrl !== deployUrl) {
           console.log(chalk.gray('This deployment also created a unique preview URL:'));
-          console.log(chalk.gray(`   ${url}`));
+          console.log(chalk.gray(`   ${deployUrl}`));
           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(chalk.cyan(`   ${deployUrl}`));
         console.log();
         console.log(chalk.gray('To deploy to production, run:'));
         console.log(chalk.gray('   npx @knowcode/doc-builder deploy'));

package/html/README.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/html/claude-workflow-guide.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/html/css/notion-style.css

@@ -974,7 +974,7 @@ tr:hover {
   
   .content {
     margin-left: 0;
-    padding: var(--space-6) var(--space-4);
+    padding: var(--space-3) var(--space-4); /* Reduced top/bottom padding on mobile */
   }
   
   .menu-toggle {
@@ -1596,7 +1596,7 @@ tr:hover {
   /* Sidebar positioning handled in earlier media query */
   
   .content {
-    padding: var(--space-4);
+    padding: var(--space-3) var(--space-4); /* Consistent reduced padding on mobile */
   }
   
   .content-inner {
@@ -1609,10 +1609,7 @@ tr:hover {
     padding: 0 var(--space-4);
   }
   
-  .preview-banner {
-    position: relative;
-    top: 0;
-  }
+  /* Keep preview banner fixed on mobile */
   
   /* Keep breadcrumbs fixed on mobile to prevent double spacing */
 }

package/html/documentation-index.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/html/guides/authentication-guide.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/html/guides/documentation-standards.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/html/guides/troubleshooting-guide.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/html/index.html

@@ -29,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.21">Last updated: Jul 21, 2025, 07:39 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.23">Last updated: Jul 21, 2025, 07:42 PM UTC</span>
                 </div>
                 
                 

package/lib/deploy.js

@@ -280,9 +280,57 @@ async function deployToVercel(config, isProd = false) {
         process.stderr.write(data.toString());
       });
       
-      vercelProcess.on('close', (code) => {
+      vercelProcess.on('close', async (code) => {
         if (code === 0) {
-          resolve(deployUrl || 'Check Vercel dashboard');
+          // Try to get the production URL from Vercel CLI
+          try {
+            const { execSync } = require('child_process');
+            const projectInfo = execSync('vercel project ls', { 
+              cwd: outputPath, 
+              encoding: 'utf8',
+              stdio: ['pipe', 'pipe', 'ignore']
+            });
+            
+            // Try to determine the project name from the deployment URL or .vercel/project.json
+            let projectName = null;
+            
+            // First try to get from .vercel/project.json
+            try {
+              const projectJsonPath = path.join(outputPath, '.vercel', 'project.json');
+              if (fs.existsSync(projectJsonPath)) {
+                const projectData = fs.readJsonSync(projectJsonPath);
+                // Get project name from Vercel API if needed
+                const projectId = projectData.projectId;
+                if (projectId) {
+                  // For now, try to extract from deployment URL
+                  const deployMatch = deployUrl.match(/https:\/\/([^-]+)/);
+                  if (deployMatch) {
+                    projectName = deployMatch[1];
+                  }
+                }
+              }
+            } catch (e) {
+              // Ignore errors reading project.json
+            }
+            
+            // Extract the production URL for the current project
+            const lines = projectInfo.split('\n');
+            for (const line of lines) {
+              // Look for project by checking if the line contains the deployment URL domain
+              const urlMatch = line.match(/https:\/\/[^\s]+\.vercel\.app/);
+              if (urlMatch && (
+                (projectName && line.toLowerCase().includes(projectName)) ||
+                line.includes(deployUrl.split('.')[0].split('//')[1])
+              )) {
+                resolve({ deployUrl, productionUrl: urlMatch[0] });
+                return;
+              }
+            }
+          } catch (err) {
+            // Fallback if we can't get project info
+          }
+          
+          resolve({ deployUrl, productionUrl: null });
         } else {
           reject(new Error(`Vercel deployment failed with code ${code}`));
         }

package/package.json

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