@knowcode/doc-builder 1.4.5 → 1.4.7

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.7] - 2025-07-21
+
+### Fixed
+- Removed excess spacing above navigation menu by setting sidebar-header margin-bottom to 0
+- Cleaned up duplicate `.sidebar-header` CSS definitions that were causing conflicts
+
+### Background
+- Previous CSS fixes exposed duplicate `.sidebar-header` definitions with conflicting margins
+- The extra spacing was introduced by `margin-bottom: var(--space-4)` on the sidebar header
+- This completes the CSS cleanup started in v1.4.5 and v1.4.6
+
+## [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

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;
 }
 
@@ -333,16 +333,6 @@ 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);
-  margin-bottom: var(--space-4);
-}
-
-/* Sidebar Breadcrumbs */
-.sidebar-breadcrumbs {
-  margin-bottom: var(--space-3);
-}
 
 .sidebar-home-link {
   display: inline-flex;
@@ -529,43 +519,9 @@ pre code {
 .sidebar-header {
   padding: var(--space-3);
   border-bottom: 1px solid var(--color-border-default);
-  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);
+  margin-bottom: 0;
 }
 
-.filter-icon {
-  position: absolute;
-  right: var(--space-3);
-  color: var(--color-text-tertiary);
-  pointer-events: none;
-}
 
 /* Navigation */
 .navigation {

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.5">Last updated: Jul 21, 2025, 10:46 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.6">Last updated: Jul 21, 2025, 11:05 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;
 }
 
@@ -333,16 +333,6 @@ 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);
-  margin-bottom: var(--space-4);
-}
-
-/* Sidebar Breadcrumbs */
-.sidebar-breadcrumbs {
-  margin-bottom: var(--space-3);
-}
 
 .sidebar-home-link {
   display: inline-flex;
@@ -529,43 +519,9 @@ pre code {
 .sidebar-header {
   padding: var(--space-3);
   border-bottom: 1px solid var(--color-border-default);
-  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);
+  margin-bottom: 0;
 }
 
-.filter-icon {
-  position: absolute;
-  right: var(--space-3);
-  color: var(--color-text-tertiary);
-  pointer-events: none;
-}
 
 /* Navigation */
 .navigation {

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.5">Last updated: Jul 21, 2025, 10:46 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.4.6">Last updated: Jul 21, 2025, 11:05 AM UTC</span>
                 </div>
                 
                 

package/package.json

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