@knowcode/doc-builder 1.3.13 → 1.3.15

package/CACHE-BUSTING-GUIDE.md

@@ -0,0 +1,82 @@
+# Cache Busting Guide for @knowcode/doc-builder
+
+If you're not seeing updates after upgrading to a new version, it's likely due to caching. Follow these steps:
+
+## 1. Clean Everything Locally
+
+```bash
+# Remove old build artifacts
+rm -rf html/
+
+# Clear npm cache
+npm cache clean --force
+
+# Remove node_modules and reinstall
+rm -rf node_modules
+npm install
+
+# Make sure you have the latest version
+npm install @knowcode/doc-builder@latest
+```
+
+## 2. Rebuild with Fresh Files
+
+```bash
+# Build fresh documentation
+npx @knowcode/doc-builder build
+```
+
+## 3. Deploy with Force Flag
+
+```bash
+# Force Vercel to ignore cache
+vercel --prod --force
+```
+
+## 4. Clear Browser Cache
+
+- **Chrome/Edge**: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
+- **Firefox**: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
+- **Safari**: Cmd+Option+R
+- Or use Incognito/Private browsing mode
+
+## 5. Clear Vercel/CDN Cache (if applicable)
+
+If using Vercel:
+1. Go to your project dashboard
+2. Settings → Functions → Purge Cache
+3. Or redeploy with a different domain temporarily
+
+## 6. Add Cache Busting to Your Build
+
+Edit your `doc-builder.config.js` to add version query strings:
+
+```javascript
+module.exports = {
+  // ... other config
+  cacheBust: true, // This will add ?v=timestamp to CSS/JS files
+};
+```
+
+## Common Issues
+
+- **"I updated but nothing changed"** - It's cache. Follow all steps above.
+- **"Tooltips still don't work"** - Clear browser cache and check console for errors
+- **"Spacing is still wrong"** - The CSS is cached. Hard refresh the page.
+
+## Verify You Have The Right Version
+
+Check the version in your package.json:
+```bash
+npm list @knowcode/doc-builder
+```
+
+Should show: `@knowcode/doc-builder@1.3.13` or higher.
+
+## Still Not Working?
+
+1. Open browser DevTools
+2. Go to Network tab
+3. Check "Disable cache" checkbox
+4. Refresh the page
+5. Look at the CSS/JS files being loaded - they should not show "(from cache)"

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.3.14] - 2025-07-20
+
+### Fixed
+- Fixed excessive gap between breadcrumb and content area
+- Changed `.main-wrapper` from using `margin-top` to `padding-top` to eliminate double spacing
+- Reduced content top padding from `var(--space-4)` (16px) to `var(--space-2)` (8px)
+- Removed duplicate `.sidebar-header` CSS definition
+- Fixed mobile responsive padding to match desktop changes
+
+### Changed
+- Main wrapper now uses `height: 100vh` with `padding-top` instead of calculated height
+- Content padding changed to `8px 32px 16px` for tighter vertical spacing
+- Consistent padding reduction across all responsive breakpoints
+
 ## [1.3.13] - 2025-07-19
 
 ### Fixed

package/assets/css/notion-style.css

@@ -332,14 +332,7 @@ pre code {
   top: calc(var(--header-height) + var(--breadcrumb-height) + 3.5rem);
 }
 
-.sidebar-header {
-  padding: var(--space-4);
-  border-bottom: 1px solid var(--color-border-default);
-}
-
-.filter-box {
-  position: relative;
-}
+/* Sidebar header styles moved to main sidebar section */
 
 .filter-input {
   width: 100%;
@@ -476,15 +469,17 @@ pre code {
 
 /* Main Wrapper */
 .main-wrapper {
+  position: absolute;
+  top: calc(var(--header-height) + var(--breadcrumb-height));
+  left: 0;
+  right: 0;
+  bottom: 0;
   display: flex;
-  height: calc(100vh - var(--header-height) - var(--breadcrumb-height));
-  margin-top: calc(var(--header-height) + var(--breadcrumb-height));
   overflow: hidden;
 }
 
 .main-wrapper.banner-visible {
-  height: calc(100vh - var(--header-height) - var(--breadcrumb-height) - 3.5rem);
-  margin-top: calc(var(--header-height) + var(--breadcrumb-height) + 3.5rem);
+  top: calc(var(--header-height) + var(--breadcrumb-height) + 3.5rem);
 }
 
 /* Sidebar */
@@ -695,7 +690,7 @@ pre code {
 .content {
   flex: 1;
   margin-left: var(--sidebar-width);
-  padding: var(--space-4) var(--space-8);
+  padding: var(--space-2) var(--space-8) var(--space-4); /* Reduced top padding */
   overflow-y: auto;
   background: var(--color-bg-default);
   transition: margin-left var(--duration-normal);
@@ -1037,7 +1032,7 @@ tr:hover {
   
   .content {
     margin-left: 0 !important;
-    padding: var(--space-6) var(--space-4);
+    padding: var(--space-2) var(--space-4) var(--space-4); /* Reduced top padding */
     max-width: 100%;
   }
   
@@ -1665,8 +1660,9 @@ tr:hover {
   }
   
   .main-wrapper {
+    position: relative; /* Change back to relative for mobile */
+    top: 0;
     flex-direction: column;
-    height: auto;
     min-height: calc(100vh - var(--header-height) - var(--breadcrumb-height));
   }
   
@@ -1679,7 +1675,7 @@ tr:hover {
   
   .content {
     margin-left: 0 !important;
-    padding: var(--space-4);
+    padding: var(--space-2) var(--space-4) var(--space-4); /* Reduced top padding */
     max-width: 100%;
   }
   

package/package.json

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

package/test-cache-bust.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+
+echo "🧹 Cache Busting Test for doc-builder"
+echo "===================================="
+
+# Step 1: Clean everything
+echo "1. Removing old build artifacts..."
+rm -rf html/
+rm -rf node_modules/
+rm -rf .cache/
+
+# Step 2: Clear npm cache
+echo "2. Clearing npm cache..."
+npm cache clean --force
+
+# Step 3: Install latest version
+echo "3. Installing latest doc-builder..."
+npm install @knowcode/doc-builder@latest
+
+# Step 4: Show version
+echo "4. Installed version:"
+npm list @knowcode/doc-builder
+
+# Step 5: Build fresh
+echo "5. Building documentation..."
+npx @knowcode/doc-builder build
+
+# Step 6: Check CSS content
+echo "6. Checking if CSS has latest changes..."
+echo "   Looking for 'margin: 0; /* Left aligned'..."
+grep -n "margin: 0; /\* Left aligned" html/css/notion-style.css || echo "NOT FOUND!"
+
+echo "   Looking for 'position: fixed; /* Use fixed'..."
+grep -n "position: fixed; /\* Use fixed" html/css/notion-style.css || echo "NOT FOUND!"
+
+echo ""
+echo "✅ If you see the CSS changes above, the package is working correctly!"
+echo "🚨 If not found, there's a build issue we need to investigate."
+echo ""
+echo "Next steps:"
+echo "1. Deploy with: vercel --prod --force"
+echo "2. Open in incognito/private browsing"
+echo "3. Hard refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)"