npm - @knowcode/doc-builder - Versions diffs - 1.5.0 → 1.5.1 - Mend

@knowcode/doc-builder 1.5.0 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/CHANGELOG.md +37 -0
package/assets/404.html +115 -0
package/assets/js/main.js +23 -0
package/doc-builder.config.js +31 -35
package/html/404.html +115 -0
package/html/README.html +5 -5
package/html/claude-workflow-guide.html +5 -5
package/html/documentation-index.html +5 -5
package/html/guides/authentication-guide.html +5 -5
package/html/guides/documentation-standards.html +5 -5
package/html/guides/seo-guide.html +5 -5
package/html/guides/troubleshooting-guide.html +5 -5
package/html/index.html +5 -5
package/html/js/main.js +23 -0
package/html/sitemap.xml +17 -11
package/html/vercel-cli-setup-guide.html +5 -5
package/html/vercel-first-time-setup-guide.html +5 -5
package/lib/core-builder.js +7 -0
package/lib/deploy.js +20 -0
package/package.json +1 -1

package/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,43 @@ 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.5.1] - 2025-07-21
+### Added
+- Automatic redirect from .md URLs to their corresponding .html files
+- Client-side JavaScript to intercept clicks on .md links and redirect to .html
+- Custom 404.html page with automatic redirect logic for direct .md URL navigation
+- Enhanced vercel.json generation to include 404 page routing
+### Fixed
+- Fixed 404 errors when clicking or navigating to .md links
+- Links like `claude-workflow-guide.md` now automatically redirect to `claude-workflow-guide.html`
+### Background
+- Users reported that links to .md files resulted in 404 errors
+- Implemented client-side solution to handle both link clicks and direct navigation
+- Works seamlessly with Vercel's cleanUrls configuration
+## [1.5.0] - 2025-07-21
+### Added
+- Comprehensive SEO features including meta tags, Open Graph, Twitter Cards
+- JSON-LD structured data for better search engine understanding
+- Automatic sitemap.xml and robots.txt generation
+- Interactive `setup-seo` CLI command to configure SEO settings
+- SEO configuration options in doc-builder.config.js
+- Production URL configuration with `set-production-url` command
+- Support for custom production URLs via config file, CLI command, or deployment flag
+### Improved
+- Better deployment URL detection with multiple fallback methods
+- Enhanced meta tag generation with author, keywords, and canonical URLs
+- Social media preview support with customizable images and descriptions
+### Documentation
+- Added comprehensive SEO guide explaining all features and configuration
+- Updated troubleshooting guide with npx cache clearing instructions
 ## [1.4.26] - 2025-07-21
 ### Improved

package/assets/404.html ADDED Viewed

@@ -0,0 +1,115 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Page Not Found - Redirecting...</title>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+            margin: 0;
+            padding: 0;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            min-height: 100vh;
+            background-color: #f7f7f5;
+            color: #37352f;
+        }
+        .container {
+            text-align: center;
+            padding: 2rem;
+            max-width: 600px;
+        }
+        h1 {
+            font-size: 3rem;
+            margin: 0 0 1rem 0;
+            color: #37352f;
+        }
+        p {
+            font-size: 1.125rem;
+            line-height: 1.6;
+            color: #6b6b6b;
+            margin: 0 0 2rem 0;
+        }
+        a {
+            color: #0366d6;
+            text-decoration: none;
+        }
+        a:hover {
+            text-decoration: underline;
+        }
+        .emoji {
+            font-size: 4rem;
+            margin-bottom: 1rem;
+        }
+        .loading {
+            display: none;
+            color: #0366d6;
+            margin-top: 1rem;
+        }
+        .redirect-message {
+            display: none;
+            background-color: #e8f4fd;
+            border: 1px solid #c3e0f7;
+            padding: 1rem;
+            border-radius: 8px;
+            margin-top: 1rem;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="emoji">🔍</div>
+        <h1>404</h1>
+        <p id="message">The page you're looking for doesn't exist.</p>
+        <div id="redirect-message" class="redirect-message">
+            Redirecting to the correct page...
+        </div>
+        <p id="loading" class="loading">Redirecting...</p>
+        <p>
+            <a href="/" id="home-link">Go to Home</a>
+        </p>
+    </div>
+    <script>
+        // Check if the URL ends with .md
+        const pathname = window.location.pathname;
+        if (pathname.endsWith('.md')) {
+            // Convert .md to .html
+            const htmlPath = pathname.replace(/\.md$/, '.html');
+            // Show redirect message
+            document.getElementById('message').textContent = 'Found a markdown link. Redirecting to the HTML version...';
+            document.getElementById('redirect-message').style.display = 'block';
+            document.getElementById('loading').style.display = 'block';
+            // Redirect after a brief delay to show the message
+            setTimeout(() => {
+                window.location.replace(htmlPath);
+            }, 500);
+        } else {
+            // For true 404s, show the standard message
+            document.getElementById('message').textContent = "The page you're looking for doesn't exist.";
+            // Also check if we can suggest a similar page
+            // Remove common suffixes and try to find a match
+            const basePath = pathname
+                .replace(/\.(html|htm|php|asp|aspx)$/, '')
+                .replace(/\/$/, '');
+            if (basePath && basePath !== pathname) {
+                document.getElementById('message').innerHTML =
+                    `The page you're looking for doesn't exist.<br>
+                     <small>Did you mean <a href="${basePath}.html">${basePath}.html</a>?</small>`;
+            }
+        }
+        // Update home link to use the correct base URL
+        const baseUrl = window.location.origin;
+        document.getElementById('home-link').href = baseUrl;
+    </script>
+</body>
+</html>

package/assets/js/main.js CHANGED Viewed

@@ -1318,8 +1318,31 @@ function initTooltips() {
   });
 }
+// Handle .md link redirects
+function initMarkdownLinkRedirects() {
+  // Check if current URL ends with .md and redirect
+  if (window.location.pathname.endsWith('.md')) {
+    const htmlPath = window.location.pathname.replace(/\.md$/, '.html');
+    console.log(`Redirecting from .md to .html: ${htmlPath}`);
+    window.location.replace(htmlPath);
+    return; // Stop execution as we're redirecting
+  }
+  // Intercept clicks on .md links
+  document.addEventListener('click', function(e) {
+    const link = e.target.closest('a');
+    if (link && link.href && link.href.endsWith('.md')) {
+      e.preventDefault();
+      const htmlUrl = link.href.replace(/\.md$/, '.html');
+      console.log(`Converting .md link to .html: ${htmlUrl}`);
+      window.location.href = htmlUrl;
+    }
+  });
+}
 // Initialize on DOM Load
 document.addEventListener('DOMContentLoaded', () => {
+  initMarkdownLinkRedirects();
   highlightNavigation();
   generateTableOfContents();
   initSidebarResize();

package/doc-builder.config.js CHANGED Viewed

@@ -1,38 +1,34 @@
 module.exports = {
-  // Site info
-  siteName: 'Doc Builder',
-  siteDescription: 'Beautiful documentation with the least effort possible',
-  // Directories
-  docsDir: 'docs',
-  outputDir: 'html',
-  // Production URL
-  productionUrl: 'https://doc-builder-delta.vercel.app',
-  // Features
-  features: {
-    authentication: false,
-    changelog: true,
-    mermaid: true,
-    darkMode: true
+  "siteName": "Doc Builder",
+  "siteDescription": "Beautiful documentation with the least effort possible",
+  "docsDir": "docs",
+  "outputDir": "html",
+  "productionUrl": "https://doc-builder-delta.vercel.app",
+  "features": {
+    "authentication": false,
+    "changelog": true,
+    "mermaid": true,
+    "darkMode": true
   },
-  // SEO configuration
-  seo: {
-    enabled: true,
-    siteUrl: 'https://doc-builder-delta.vercel.app',
-    author: 'Lindsay Smith',
-    twitterHandle: '@planbbackups',
-    language: 'en-US',
-    keywords: ['documentation', 'markdown', 'static site generator', 'vercel', 'notion-style'],
-    organization: {
-      name: 'KnowCode',
-      url: 'https://knowcode.com'
-    },
-    ogImage: '/og-default.png',
-    generateSitemap: true,
-    generateRobotsTxt: true,
-    customMetaTags: []
+  "seo": {
+    "enabled": true,
+    "siteUrl": "https://doc-builder-delta.vercel.app",
+    "author": "Lindsay Smith",
+    "twitterHandle": "@planbbackups",
+    "language": "en-US",
+    "keywords": [
+      "documentation",
+      "markdown",
+      "static site generator",
+      "vercel",
+      "notion-style"
+    ],
+    "generateSitemap": true,
+    "generateRobotsTxt": true,
+    "ogImage": "/og-default.png",
+    "organization": {
+      "name": "Knowcode Ltd",
+      "url": "https://knowcode.tech"
+    }
   }
-};
+};

package/html/404.html ADDED Viewed

@@ -0,0 +1,115 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Page Not Found - Redirecting...</title>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+            margin: 0;
+            padding: 0;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            min-height: 100vh;
+            background-color: #f7f7f5;
+            color: #37352f;
+        }
+        .container {
+            text-align: center;
+            padding: 2rem;
+            max-width: 600px;
+        }
+        h1 {
+            font-size: 3rem;
+            margin: 0 0 1rem 0;
+            color: #37352f;
+        }
+        p {
+            font-size: 1.125rem;
+            line-height: 1.6;
+            color: #6b6b6b;
+            margin: 0 0 2rem 0;
+        }
+        a {
+            color: #0366d6;
+            text-decoration: none;
+        }
+        a:hover {
+            text-decoration: underline;
+        }
+        .emoji {
+            font-size: 4rem;
+            margin-bottom: 1rem;
+        }
+        .loading {
+            display: none;
+            color: #0366d6;
+            margin-top: 1rem;
+        }
+        .redirect-message {
+            display: none;
+            background-color: #e8f4fd;
+            border: 1px solid #c3e0f7;
+            padding: 1rem;
+            border-radius: 8px;
+            margin-top: 1rem;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="emoji">🔍</div>
+        <h1>404</h1>
+        <p id="message">The page you're looking for doesn't exist.</p>
+        <div id="redirect-message" class="redirect-message">
+            Redirecting to the correct page...
+        </div>
+        <p id="loading" class="loading">Redirecting...</p>
+        <p>
+            <a href="/" id="home-link">Go to Home</a>
+        </p>
+    </div>
+    <script>
+        // Check if the URL ends with .md
+        const pathname = window.location.pathname;
+        if (pathname.endsWith('.md')) {
+            // Convert .md to .html
+            const htmlPath = pathname.replace(/\.md$/, '.html');
+            // Show redirect message
+            document.getElementById('message').textContent = 'Found a markdown link. Redirecting to the HTML version...';
+            document.getElementById('redirect-message').style.display = 'block';
+            document.getElementById('loading').style.display = 'block';
+            // Redirect after a brief delay to show the message
+            setTimeout(() => {
+                window.location.replace(htmlPath);
+            }, 500);
+        } else {
+            // For true 404s, show the standard message
+            document.getElementById('message').textContent = "The page you're looking for doesn't exist.";
+            // Also check if we can suggest a similar page
+            // Remove common suffixes and try to find a match
+            const basePath = pathname
+                .replace(/\.(html|htm|php|asp|aspx)$/, '')
+                .replace(/\/$/, '');
+            if (basePath && basePath !== pathname) {
+                document.getElementById('message').innerHTML =
+                    `The page you're looking for doesn't exist.<br>
+                     <small>Did you mean <a href="${basePath}.html">${basePath}.html</a>?</small>`;
+            }
+        }
+        // Update home link to use the correct base URL
+        const baseUrl = window.location.origin;
+        document.getElementById('home-link').href = baseUrl;
+    </script>
+</body>
+</html>

package/html/README.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.105Z",
-  "dateModified": "2025-07-21T20:24:35.105Z",
+  "datePublished": "2025-07-21T20:39:06.468Z",
+  "dateModified": "2025-07-21T20:39:06.468Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -92,7 +92,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/claude-workflow-guide.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.114Z",
-  "dateModified": "2025-07-21T20:24:35.114Z",
+  "datePublished": "2025-07-21T20:39:06.478Z",
+  "dateModified": "2025-07-21T20:39:06.478Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/claude-workflow-guide.html"
@@ -92,7 +92,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/documentation-index.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.117Z",
-  "dateModified": "2025-07-21T20:24:35.117Z",
+  "datePublished": "2025-07-21T20:39:06.481Z",
+  "dateModified": "2025-07-21T20:39:06.481Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -92,7 +92,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/guides/authentication-guide.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.119Z",
-  "dateModified": "2025-07-21T20:24:35.119Z",
+  "datePublished": "2025-07-21T20:39:06.483Z",
+  "dateModified": "2025-07-21T20:39:06.483Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -98,7 +98,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/guides/documentation-standards.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.123Z",
-  "dateModified": "2025-07-21T20:24:35.123Z",
+  "datePublished": "2025-07-21T20:39:06.486Z",
+  "dateModified": "2025-07-21T20:39:06.486Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -98,7 +98,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/guides/seo-guide.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.126Z",
-  "dateModified": "2025-07-21T20:24:35.126Z",
+  "datePublished": "2025-07-21T20:39:06.489Z",
+  "dateModified": "2025-07-21T20:39:06.489Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
@@ -98,7 +98,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/guides/troubleshooting-guide.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.129Z",
-  "dateModified": "2025-07-21T20:24:35.129Z",
+  "datePublished": "2025-07-21T20:39:06.492Z",
+  "dateModified": "2025-07-21T20:39:06.492Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html"
@@ -98,7 +98,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/index.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.105Z",
-  "dateModified": "2025-07-21T20:24:35.105Z",
+  "datePublished": "2025-07-21T20:39:06.468Z",
+  "dateModified": "2025-07-21T20:39:06.468Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -92,7 +92,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/js/main.js CHANGED Viewed

@@ -1318,8 +1318,31 @@ function initTooltips() {
   });
 }
+// Handle .md link redirects
+function initMarkdownLinkRedirects() {
+  // Check if current URL ends with .md and redirect
+  if (window.location.pathname.endsWith('.md')) {
+    const htmlPath = window.location.pathname.replace(/\.md$/, '.html');
+    console.log(`Redirecting from .md to .html: ${htmlPath}`);
+    window.location.replace(htmlPath);
+    return; // Stop execution as we're redirecting
+  }
+  // Intercept clicks on .md links
+  document.addEventListener('click', function(e) {
+    const link = e.target.closest('a');
+    if (link && link.href && link.href.endsWith('.md')) {
+      e.preventDefault();
+      const htmlUrl = link.href.replace(/\.md$/, '.html');
+      console.log(`Converting .md link to .html: ${htmlUrl}`);
+      window.location.href = htmlUrl;
+    }
+  });
+}
 // Initialize on DOM Load
 document.addEventListener('DOMContentLoaded', () => {
+  initMarkdownLinkRedirects();
   highlightNavigation();
   generateTableOfContents();
   initSidebarResize();

package/html/sitemap.xml CHANGED Viewed

@@ -1,68 +1,74 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://doc-builder-delta.vercel.app/404.html</loc>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
+    <changefreq>monthly</changefreq>
+    <priority>0.6</priority>
+  </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
-    <lastmod>2025-07-21T20:24:35.142Z</lastmod>
+    <lastmod>2025-07-21T20:39:06.503Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

package/html/vercel-cli-setup-guide.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.131Z",
-  "dateModified": "2025-07-21T20:24:35.131Z",
+  "datePublished": "2025-07-21T20:39:06.494Z",
+  "dateModified": "2025-07-21T20:39:06.494Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -92,7 +92,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/html/vercel-first-time-setup-guide.html CHANGED Viewed

@@ -55,11 +55,11 @@
   },
   "publisher": {
     "@type": "Organization",
-    "name": "KnowCode",
-    "url": "https://knowcode.com"
+    "name": "Knowcode Ltd",
+    "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-21T20:24:35.134Z",
-  "dateModified": "2025-07-21T20:24:35.134Z",
+  "datePublished": "2025-07-21T20:39:06.497Z",
+  "dateModified": "2025-07-21T20:39:06.497Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -92,7 +92,7 @@
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.26">Last updated: Jul 21, 2025, 08:24 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.0">Last updated: Jul 21, 2025, 08:39 PM UTC</span>
                 </div>

package/lib/core-builder.js CHANGED Viewed

@@ -700,6 +700,13 @@ async function buildDocumentation(config) {
     await createAuthPages(outputDir, config);
   }
+  // Copy 404.html for handling .md redirects
+  const notFoundSource = path.join(assetsDir, '404.html');
+  if (fs.existsSync(notFoundSource)) {
+    await fs.copy(notFoundSource, path.join(outputDir, '404.html'), { overwrite: true });
+    console.log(chalk.green('✅ Copied 404.html for .md link handling'));
+  }
   // Create index.html from index.html, README.html, or generate default
   const indexPath = path.join(outputDir, 'index.html');
   const indexSourcePath = path.join(outputDir, 'index.html'); // from index.md

package/lib/deploy.js CHANGED Viewed

@@ -93,6 +93,16 @@ async function setupVercelProject(config) {
           }
         ]
       }
+    ],
+    "routes": [
+      {
+        "handle": "filesystem"
+      },
+      {
+        "src": "/(.*)",
+        "status": 404,
+        "dest": "/404.html"
+      }
     ]
   };
@@ -265,6 +275,16 @@ async function deployToVercel(config, isProd = false) {
             }
           ]
         }
+      ],
+      "routes": [
+        {
+          "handle": "filesystem"
+        },
+        {
+          "src": "/(.*)",
+          "status": 404,
+          "dest": "/404.html"
+        }
       ]
     };
     fs.writeJsonSync(vercelConfigPath, vercelConfig, { spaces: 2 });

package/package.json CHANGED Viewed

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