@knowcode/doc-builder 1.4.4 → 1.4.6

package/.claude/settings.local.json

@@ -8,7 +8,14 @@
       "Bash(npm pack)",
       "Bash(cat:*)",
       "Bash(rm:*)",
-      "Bash(npm publish:*)"
+      "Bash(npm publish:*)",
+      "Bash(git tag:*)",
+      "Bash(git push:*)",
+      "Bash(git pull:*)",
+      "Bash(git rebase:*)",
+      "Bash(npm info:*)",
+      "Bash(npx:*)",
+      "Bash(grep:*)"
     ],
     "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.6] - 2025-07-21
+
+### Fixed
+- Restored breadcrumb height from 0px to 40px to fix visibility issue
+- Removed duplicate CSS rules that were causing filter icon overlap
+- Cleaned up duplicate `.filter-box`, `.filter-icon`, and `.sidebar-breadcrumbs` definitions
+
+### Background
+- The removal of style.css in v1.4.5 exposed pre-existing CSS conflicts
+- Duplicate CSS rules were causing the filter icon to render incorrectly
+- Breadcrumb height of 0px (set in v1.3.2) made the breadcrumb bar invisible
+
+## [1.4.5] - 2025-07-21
+
+### Fixed
+- Removed all references to non-existent style.css file
+- Fixed CSS rendering issues where root page appeared different from other pages
+- Updated CSS existence check in deploy.js to verify notion-style.css instead
+
+### Background
+- style.css was removed in v1.4.0 but code references remained
+- This caused 404 errors and potential CSS loading failures
+- All pages now correctly load only notion-style.css as intended
+
 ## [1.4.4] - 2025-07-21
 
 ### Added

package/README.md

@@ -1,6 +1,10 @@
 # @knowcode/doc-builder
 
-A zero-configuration documentation builder for markdown-based sites with Vercel deployment support.
+Beautiful documentation with the least effort possible. A zero-configuration documentation builder that transforms markdown files into stunning static sites.
+
+## Why This Project Exists
+
+The main premise of @knowcode/doc-builder is simple: **create beautiful documentation with the least effort possible**. We believe great documentation shouldn't require complex setup, configuration files, or deployment headaches. Just write markdown, run one command, and get a professional documentation site live on the web.
 
 ## What It Does
 
@@ -9,11 +13,23 @@ A zero-configuration documentation builder for markdown-based sites with Vercel
 - **Scans** your markdown files and automatically generates navigation
 - **Converts** markdown to HTML with syntax highlighting and diagram support
 - **Styles** everything with a clean, Notion-inspired theme
-- **Deploys** to Vercel with a single command - no configuration needed
+- **Deploys** to Vercel with a single command - leveraging their generous free tier
 - **Provides** optional features like authentication, dark mode, and changelog generation
 
 Perfect for project documentation, API references, knowledge bases, or any content written in markdown.
 
+## Why Vercel?
+
+We chose Vercel as our deployment platform because of their **generous free tier** that includes:
+- Unlimited personal projects
+- Automatic HTTPS certificates
+- Global CDN for fast loading worldwide
+- Custom domains support
+- Automatic deployments from Git
+- No credit card required
+
+This aligns perfectly with our mission: beautiful documentation should be accessible to everyone, without worrying about hosting costs or complex server management.
+
 ## Features
 
 - 🚀 **Zero Configuration** - Works out of the box with sensible defaults

package/assets/css/notion-style.css

@@ -126,7 +126,7 @@
   --container-padding-mobile: 20px;
   --container-padding-desktop: 40px;
   --header-height: 40px;
-  --breadcrumb-height: 0px;
+  --breadcrumb-height: 40px;
   --sidebar-width: 280px;
 }
 
@@ -532,40 +532,6 @@ pre code {
   margin-bottom: var(--space-4);
 }
 
-/* Already defined above, but ensure consistency */
-.sidebar-breadcrumbs {
-  margin-bottom: var(--space-3);
-}
-
-.filter-box {
-  position: relative;
-  display: flex;
-  align-items: center;
-}
-
-.filter-input {
-  width: 100%;
-  padding: var(--space-2) var(--space-8) var(--space-2) var(--space-3);
-  border: 1px solid var(--color-border-default);
-  border-radius: var(--radius-md);
-  background: var(--color-bg-default);
-  color: var(--color-text-primary);
-  font-size: var(--text-sm);
-  transition: all var(--duration-fast);
-}
-
-.filter-input:focus {
-  outline: none;
-  border-color: var(--color-border-focus);
-  box-shadow: 0 0 0 2px var(--color-accent-blue-bg);
-}
-
-.filter-icon {
-  position: absolute;
-  right: var(--space-3);
-  color: var(--color-text-tertiary);
-  pointer-events: none;
-}
 
 /* Navigation */
 .navigation {

package/html/README.html

@@ -17,7 +17,6 @@
     
     <!-- Styles -->
     <link rel="stylesheet" href="/css/notion-style.css">
-    <link rel="stylesheet" href="/css/style.css">
     
     <!-- Favicon -->
     <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>📚</text></svg>">
@@ -30,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.4">Last updated: Jul 21, 2025, 10:35 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.5">Last updated: Jul 21, 2025, 10:58 AM UTC</span>
                 </div>
                 
                 

package/html/css/notion-style.css

@@ -126,7 +126,7 @@
   --container-padding-mobile: 20px;
   --container-padding-desktop: 40px;
   --header-height: 40px;
-  --breadcrumb-height: 0px;
+  --breadcrumb-height: 40px;
   --sidebar-width: 280px;
 }
 
@@ -532,40 +532,6 @@ pre code {
   margin-bottom: var(--space-4);
 }
 
-/* Already defined above, but ensure consistency */
-.sidebar-breadcrumbs {
-  margin-bottom: var(--space-3);
-}
-
-.filter-box {
-  position: relative;
-  display: flex;
-  align-items: center;
-}
-
-.filter-input {
-  width: 100%;
-  padding: var(--space-2) var(--space-8) var(--space-2) var(--space-3);
-  border: 1px solid var(--color-border-default);
-  border-radius: var(--radius-md);
-  background: var(--color-bg-default);
-  color: var(--color-text-primary);
-  font-size: var(--text-sm);
-  transition: all var(--duration-fast);
-}
-
-.filter-input:focus {
-  outline: none;
-  border-color: var(--color-border-focus);
-  box-shadow: 0 0 0 2px var(--color-accent-blue-bg);
-}
-
-.filter-icon {
-  position: absolute;
-  right: var(--space-3);
-  color: var(--color-text-tertiary);
-  pointer-events: none;
-}
 
 /* Navigation */
 .navigation {

package/html/index.html

@@ -17,7 +17,6 @@
     
     <!-- Styles -->
     <link rel="stylesheet" href="/css/notion-style.css">
-    <link rel="stylesheet" href="/css/style.css">
     
     <!-- Favicon -->
     <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>📚</text></svg>">
@@ -30,7 +29,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.4.4">Last updated: Jul 21, 2025, 10:35 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.5">Last updated: Jul 21, 2025, 10:58 AM UTC</span>
                 </div>
                 
                 

package/lib/core-builder.js

@@ -117,7 +117,6 @@ function generateHTML(title, content, navigation, currentPath = '', config = {})
     
     <!-- Styles -->
     <link rel="stylesheet" href="/css/notion-style.css">
-    <link rel="stylesheet" href="/css/style.css">
     
     <!-- Favicon -->
     <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>📚</text></svg>">
@@ -861,7 +860,6 @@ async function createDefaultIndexPage(outputDir, config, version) {
     <title>Welcome to ${siteName}</title>
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/css/notion-style.css">
-    <link rel="stylesheet" href="/css/style.css">
     <style>
       .welcome-container {
         max-width: 800px;

package/lib/deploy.js

@@ -187,7 +187,7 @@ async function deployToVercel(config, isProd = false) {
   }
   
   // Check if CSS files exist
-  const cssPath = path.join(outputPath, 'css', 'style.css');
+  const cssPath = path.join(outputPath, 'css', 'notion-style.css');
   if (!fs.existsSync(cssPath)) {
     console.log(chalk.yellow('\n⚠️  Warning: CSS files not found in output directory!'));
     console.log(chalk.yellow('   Your documentation may appear without styling.'));
@@ -433,7 +433,6 @@ async function prepareDeployment(config) {
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta http-equiv="refresh" content="0; url=${firstFile}">
   <title>${config.siteName || 'Documentation'}</title>
-  <link rel="stylesheet" href="/css/style.css">
   <link rel="stylesheet" href="/css/notion-style.css">
 </head>
 <body>

package/package.json

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