@knowcode/doc-builder 1.5.2 → 1.5.4

package/html/sitemap.xml

@@ -2,79 +2,85 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://doc-builder-delta.vercel.app/404.html</loc>
-    <lastmod>2025-07-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</lastmod>
+    <changefreq>monthly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html</loc>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</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-22T05:55:46.744Z</lastmod>
+    <lastmod>2025-07-22T06:56:56.811Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

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

@@ -28,6 +28,9 @@
     <meta name="twitter:description" content="Vercel CLI Setup Guide.">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
+    <!-- Custom Meta Tags -->
+    <meta name="google-site-verification" content="FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ">
+    
     <!-- Fonts -->
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
     
@@ -58,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T05:55:46.731Z",
-  "dateModified": "2025-07-22T05:55:46.731Z",
+  "datePublished": "2025-07-22T06:56:56.800Z",
+  "dateModified": "2025-07-22T06:56:56.800Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -92,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.1">Last updated: Jul 22, 2025, 05:55 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.3">Last updated: Jul 22, 2025, 06:56 AM UTC</span>
                 </div>
                 
                 
@@ -153,6 +156,7 @@
         <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="This guide explains how to configure and use the built-in authentication feature in @knowcode/doc-builder to protect your documentation with basic..."><i class="fas fa-file-alt"></i> Authentication Guide</a>
         <a href="/guides/claude-workflow-guide.html" class="nav-item" data-tooltip="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it..."><i class="fas fa-file-alt"></i> Claude Workflow Guide</a>
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
+        <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>

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

@@ -28,6 +28,9 @@
     <meta name="twitter:description" content="Vercel First-Time Setup Guide - Complete Prompt-by-Prompt Walkthrough.">
     <meta name="twitter:image" content="https://doc-builder-delta.vercel.app/og-default.png">
     
+    <!-- Custom Meta Tags -->
+    <meta name="google-site-verification" content="FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ">
+    
     <!-- Fonts -->
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
     
@@ -58,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T05:55:46.734Z",
-  "dateModified": "2025-07-22T05:55:46.734Z",
+  "datePublished": "2025-07-22T06:56:56.803Z",
+  "dateModified": "2025-07-22T06:56:56.803Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -92,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.1">Last updated: Jul 22, 2025, 05:55 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.3">Last updated: Jul 22, 2025, 06:56 AM UTC</span>
                 </div>
                 
                 
@@ -153,6 +156,7 @@
         <a href="/guides/authentication-guide.html" class="nav-item" data-tooltip="This guide explains how to configure and use the built-in authentication feature in @knowcode/doc-builder to protect your documentation with basic..."><i class="fas fa-file-alt"></i> Authentication Guide</a>
         <a href="/guides/claude-workflow-guide.html" class="nav-item" data-tooltip="This guide demonstrates an efficient workflow for using Claude Code with a refined CLAUDE.md file to create high-quality documentation and deploy it..."><i class="fas fa-file-alt"></i> Claude Workflow Guide</a>
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
+        <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>

package/lib/core-builder.js

@@ -229,7 +229,8 @@ function generateHTML(title, content, navigation, currentPath = '', config = {},
       ogImage: config.seo.ogImage,
       siteName: siteName,
       language: config.seo.language,
-      type: 'article'
+      type: 'article',
+      customMetaTags: config.seo.customMetaTags || []
     });
     
     // Generate JSON-LD

package/lib/seo.js

@@ -84,7 +84,8 @@ function generateMetaTags(options) {
     ogImage,
     siteName,
     language = 'en-US',
-    type = 'article'
+    type = 'article',
+    customMetaTags = []
   } = options;
   
   const tags = [];
@@ -157,6 +158,18 @@ function generateMetaTags(options) {
     }
   }
   
+  // Add custom meta tags
+  if (customMetaTags && customMetaTags.length > 0) {
+    tags.push(`    \n    <!-- Custom Meta Tags -->`);
+    customMetaTags.forEach(tag => {
+      if (tag.name && tag.content) {
+        tags.push(`    <meta name="${escapeHtml(tag.name)}" content="${escapeHtml(tag.content)}">`);
+      } else if (tag.property && tag.content) {
+        tags.push(`    <meta property="${escapeHtml(tag.property)}" content="${escapeHtml(tag.content)}">`);
+      }
+    });
+  }
+  
   return tags.join('\n');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {
@@ -8,7 +8,9 @@
   },
   "scripts": {
     "postinstall": "node scripts/setup.js || true",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "publish:npm": "./publish.sh",
+    "release": "./publish.sh"
   },
   "keywords": [
     "documentation",

package/publish.sh

@@ -0,0 +1,198 @@
+#!/bin/bash
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Icons
+CHECK="✓"
+CROSS="✗"
+ARROW="→"
+INFO="ℹ"
+WARN="⚠"
+
+# Function to print colored output
+print_info() {
+    echo -e "${BLUE}${INFO}${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}${CHECK}${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}${CROSS}${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}${WARN}${NC} $1"
+}
+
+print_step() {
+    echo -e "${CYAN}${ARROW}${NC} $1"
+}
+
+# Header
+echo ""
+echo -e "${BLUE}┌─────────────────────────────────────────┐${NC}"
+echo -e "${BLUE}│       📦 NPM Publishing Script          │${NC}"
+echo -e "${BLUE}│         @knowcode/doc-builder           │${NC}"
+echo -e "${BLUE}└─────────────────────────────────────────┘${NC}"
+echo ""
+
+# Check if we're in the right directory
+if [ ! -f "package.json" ]; then
+    print_error "package.json not found! Are you in the project root?"
+    exit 1
+fi
+
+# Get package info
+PACKAGE_NAME=$(node -p "require('./package.json').name")
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+
+print_info "Package: ${PACKAGE_NAME}"
+print_info "Current version: ${CURRENT_VERSION}"
+echo ""
+
+# Check if user is logged into npm
+print_step "Checking npm login status..."
+if ! npm whoami &> /dev/null; then
+    print_error "You are not logged into npm!"
+    print_info "Please run: npm login"
+    exit 1
+else
+    NPM_USER=$(npm whoami)
+    print_success "Logged in as: ${NPM_USER}"
+fi
+echo ""
+
+# Check for uncommitted changes
+print_step "Checking for uncommitted changes..."
+if ! git diff-index --quiet HEAD --; then
+    print_warning "You have uncommitted changes!"
+    echo ""
+    git status --short
+    echo ""
+    read -p "Do you want to continue anyway? (y/N) " -n 1 -r
+    echo ""
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        print_info "Publishing cancelled."
+        exit 1
+    fi
+else
+    print_success "Working directory is clean"
+fi
+echo ""
+
+# Check if version exists on npm
+print_step "Checking if version ${CURRENT_VERSION} is already published..."
+if npm view "${PACKAGE_NAME}@${CURRENT_VERSION}" version &> /dev/null; then
+    print_error "Version ${CURRENT_VERSION} is already published!"
+    print_info "Please update the version in package.json first."
+    echo ""
+    
+    # Show last few published versions
+    print_info "Recent versions:"
+    npm view "${PACKAGE_NAME}" versions --json | tail -5 | sed 's/,$//' | sed 's/^/  /'
+    echo ""
+    
+    # Suggest next version
+    LATEST_VERSION=$(npm view "${PACKAGE_NAME}" version)
+    print_info "Latest published version: ${LATEST_VERSION}"
+    print_info "Suggested next versions:"
+    echo "  - Patch: $(npx semver ${LATEST_VERSION} -i patch)"
+    echo "  - Minor: $(npx semver ${LATEST_VERSION} -i minor)"
+    echo "  - Major: $(npx semver ${LATEST_VERSION} -i major)"
+    exit 1
+else
+    print_success "Version ${CURRENT_VERSION} is not yet published"
+fi
+echo ""
+
+# Build the project
+print_step "Building documentation..."
+if node cli.js build > /dev/null 2>&1; then
+    print_success "Build completed successfully"
+else
+    print_error "Build failed!"
+    print_info "Run 'node cli.js build' to see the error"
+    exit 1
+fi
+echo ""
+
+# Run npm pack to preview
+print_step "Creating package preview..."
+PACK_FILE=$(npm pack --dry-run 2>&1 | grep -E "^[a-zA-Z0-9@/._-]+\.tgz$" | tail -1)
+print_success "Package will be created as: ${PACK_FILE}"
+
+# Show what will be published
+print_info "Files to be included:"
+npm pack --dry-run 2>&1 | grep -E "^npm notice.*[0-9]+B" | head -10 | sed 's/npm notice/  /'
+TOTAL_FILES=$(npm pack --dry-run 2>&1 | grep -E "^npm notice total files:" | sed 's/npm notice total files://')
+print_info "Total files:${TOTAL_FILES}"
+echo ""
+
+# Final confirmation
+echo -e "${YELLOW}┌─────────────────────────────────────────┐${NC}"
+echo -e "${YELLOW}│          READY TO PUBLISH               │${NC}"
+echo -e "${YELLOW}├─────────────────────────────────────────┤${NC}"
+echo -e "${YELLOW}│${NC} Package:  ${PACKAGE_NAME}"
+echo -e "${YELLOW}│${NC} Version:  ${CURRENT_VERSION}"
+echo -e "${YELLOW}│${NC} User:     ${NPM_USER}"
+echo -e "${YELLOW}│${NC} Registry: https://registry.npmjs.org/"
+echo -e "${YELLOW}└─────────────────────────────────────────┘${NC}"
+echo ""
+
+read -p "Do you want to publish to npm? (y/N) " -n 1 -r
+echo ""
+echo ""
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    print_warning "Publishing cancelled by user"
+    exit 0
+fi
+
+# Publish to npm
+print_step "Publishing to npm..."
+echo ""
+
+if npm publish; then
+    echo ""
+    print_success "Successfully published ${PACKAGE_NAME}@${CURRENT_VERSION}!"
+    echo ""
+    
+    # Show post-publish info
+    echo -e "${GREEN}┌─────────────────────────────────────────┐${NC}"
+    echo -e "${GREEN}│         🎉 PUBLISHED SUCCESSFULLY!      │${NC}"
+    echo -e "${GREEN}└─────────────────────────────────────────┘${NC}"
+    echo ""
+    
+    print_info "View on npm:"
+    echo "  https://www.npmjs.com/package/${PACKAGE_NAME}"
+    echo ""
+    
+    print_info "Install command:"
+    echo "  npm install ${PACKAGE_NAME}@${CURRENT_VERSION}"
+    echo ""
+    
+    print_info "Or use with npx:"
+    echo "  npx ${PACKAGE_NAME}@latest"
+    echo ""
+    
+    # Suggest next steps
+    print_info "Next steps:"
+    echo "  1. Create a git tag: git tag v${CURRENT_VERSION}"
+    echo "  2. Push the tag: git push origin v${CURRENT_VERSION}"
+    echo "  3. Create a GitHub release"
+    echo "  4. Update CHANGELOG.md for the next version"
+    echo ""
+else
+    echo ""
+    print_error "Publishing failed!"
+    print_info "Check the error message above for details"
+    exit 1
+fi