@knowcode/doc-builder 1.4.23 → 1.4.25

package/.claude/settings.local.json

@@ -20,7 +20,9 @@
       "Bash(ls:*)",
       "Bash(npm run build:*)",
       "Bash(npm view:*)",
-      "Bash(npm:*)"
+      "Bash(npm:*)",
+      "Bash(vercel project:*)",
+      "Bash(vercel alias:*)"
     ],
     "deny": []
   }

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.25] - 2025-07-21
+
+### Fixed
+- Improved production URL detection with multiple fallback methods
+- Tries to extract project name and construct standard Vercel URL
+- Better handling of different Vercel URL formats
+
+### Background
+- Previous version didn't correctly parse Vercel's output
+- Now uses multiple methods to determine the production URL
+- Extracts project name from deployment URL as fallback
+
+## [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.24">Last updated: Jul 21, 2025, 07:50 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.24">Last updated: Jul 21, 2025, 07:50 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.24">Last updated: Jul 21, 2025, 07:50 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.24">Last updated: Jul 21, 2025, 07:50 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.24">Last updated: Jul 21, 2025, 07:50 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.24">Last updated: Jul 21, 2025, 07:50 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.24">Last updated: Jul 21, 2025, 07:50 PM UTC</span>
                 </div>
                 
                 

package/lib/deploy.js

@@ -280,9 +280,75 @@ 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
+          let productionUrl = null;
+          
+          try {
+            const { execSync } = require('child_process');
+            
+            // Method 1: Check for project domains
+            try {
+              const domainsOutput = execSync('vercel domains ls', {
+                cwd: outputPath,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'ignore']
+              });
+              
+              // Look for domains associated with this project
+              const domainLines = domainsOutput.split('\n');
+              for (const line of domainLines) {
+                if (line.includes('.vercel.app') && !line.includes('source')) {
+                  // Extract domain that looks like a custom project domain
+                  const match = line.match(/([a-z0-9-]+\.vercel\.app)/);
+                  if (match && !match[1].includes('lindsay-1340s-projects')) {
+                    productionUrl = `https://${match[1]}`;
+                    break;
+                  }
+                }
+              }
+            } catch (e) {
+              // domains command might not be available
+            }
+            
+            // Method 2: Get project info and construct standard production URL
+            if (!productionUrl) {
+              try {
+                // Get the project name from the deployment
+                const inspectOutput = execSync(`vercel inspect ${deployUrl}`, {
+                  cwd: outputPath,
+                  encoding: 'utf8',
+                  stdio: ['pipe', 'pipe', 'ignore']
+                });
+                
+                // Extract project name from inspect output
+                const projectMatch = inspectOutput.match(/Project Name:\s+([^\s]+)/);
+                if (projectMatch) {
+                  const projectName = projectMatch[1];
+                  // Construct the standard production URL
+                  productionUrl = `https://${projectName}.vercel.app`;
+                }
+              } catch (e) {
+                // inspect command failed
+              }
+            }
+            
+            // Method 3: Extract from deployment URL pattern
+            if (!productionUrl && deployUrl) {
+              // Try to extract project name from deployment URL
+              // Format: https://project-name-randomhash-team.vercel.app
+              const urlMatch = deployUrl.match(/https:\/\/([^-]+)-[a-z0-9]+-/);
+              if (urlMatch) {
+                const projectName = urlMatch[1];
+                productionUrl = `https://${projectName}.vercel.app`;
+              }
+            }
+          } catch (err) {
+            // All methods failed, use deployment URL
+          }
+          
+          resolve({ deployUrl, productionUrl });
         } 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.25",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {