docyard 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edade5380162369781998f1693e7658c34eb7275092cd709fce68ee25393f0af
-  data.tar.gz: ec1c12df9c38802e881404526b4bff6d10f860320f0f0e3b459344f04c980f51
+  metadata.gz: 9ea61eefa97dc9199d17929def1315fdf2ce71f75ddf4f03833b9291fa64ce75
+  data.tar.gz: '0538fae77efffb84a8aac4ba979510419ff2a8cd8eec1b5aaf9effc2950595d8'
 SHA512:
-  metadata.gz: 656e618b495b1b657bb002857c030dff8929546f453acd559268c9fb25f5d4f355938cf0f705914b54d22d3ca3c5a601635c5168fe85cd1d574f72b1f0c7a897
-  data.tar.gz: f86343f57d8a64520652351ff1d8fa43518af247227f96092b5feff5b0ec2b185b6295017c8d18eb62f12fe28a22c66b71c1390834d296baed643181972a3480
+  metadata.gz: f184c67f1be8766cdd6339da6b25ccd8b7f1d0150ce3f6c0db0de8dd68c590b82e29f76a4ec1928c29151018d318225f2769cea58be9ad1dc2c721a2593663d5
+  data.tar.gz: 982f4bdcd4170dd013dd5ee10fb21db935eeafcb486372a45db7ae58a3f8d75e6c716555585695ea9527cc7fbd2bf0e43c5a7982894160ec6832c591c2db45a1

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.1] - 2026-01-22
+
+### Added
+- **Root Fallback Redirect** - Auto-redirect to first page when no index.md exists (#127)
+
+### Fixed
+- Breadcrumb sections without index pages now link to first navigable child (#126)
+- Error pages (404/500) now use custom branding colors (#125)
+- Base URL now correctly applied to all assets including fonts and search (#124)
+- Dev server no longer applies build.base config, always uses root path (#123)
+
 ## [1.0.0] - 2026-01-22
 
 ### Added
@@ -205,7 +216,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial gem structure
 - Project scaffolding
 
-[Unreleased]: https://github.com/sanifhimani/docyard/compare/v0.9.0...HEAD
+[Unreleased]: https://github.com/sanifhimani/docyard/compare/v1.0.1...HEAD
+[1.0.1]: https://github.com/sanifhimani/docyard/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/sanifhimani/docyard/compare/v0.9.0...v1.0.0
 [0.9.0]: https://github.com/sanifhimani/docyard/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/sanifhimani/docyard/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/sanifhimani/docyard/compare/v0.6.0...v0.7.0

data/lib/docyard/build/asset_bundler.rb

@@ -37,6 +37,7 @@ module Docyard
         minified = CSSminify.compress(css_content)
         minified = fix_calc_whitespace(minified)
         minified = fix_css_math_functions(minified)
+        minified = replace_css_asset_urls(minified)
         hash = generate_hash(minified)
 
         write_bundled_asset(minified, hash, "css")
@@ -58,6 +59,11 @@ module Docyard
         css.gsub(/\bmax\(0,/, "max(0px,").gsub(/\bmin\(0,/, "min(0px,)")
       end
 
+      def replace_css_asset_urls(css)
+        base_url = normalize_base_url(config.build.base)
+        css.gsub(%r{/_docyard/fonts/}, "#{base_url}_docyard/fonts/")
+      end
+
       def resolve_css_imports(css_content)
         css_content.gsub(/@import url\('([^']+)'\);/) do |match|
           import_file = Regexp.last_match(1)
@@ -86,6 +92,7 @@ module Docyard
         components_js = concatenate_component_js
         js_content = [theme_js, components_js].join("\n")
         minified = Terser.compile(js_content)
+        minified = replace_js_asset_urls(minified)
         hash = generate_hash(minified)
 
         write_bundled_asset(minified, hash, "js")
@@ -94,6 +101,12 @@ module Docyard
         hash
       end
 
+      def replace_js_asset_urls(js_content)
+        base_url = normalize_base_url(config.build.base)
+        js_content.gsub(%r{"/_docyard/pagefind/}, "\"#{base_url}_docyard/pagefind/")
+          .gsub(%r{baseUrl:\s*["']/["']}, "baseUrl:\"#{base_url}\"")
+      end
+
       def concatenate_component_js
         components_dir = File.join(ASSETS_PATH, "js", "components")
         return "" unless Dir.exist?(components_dir)
@@ -123,6 +136,15 @@ module Docyard
           .gsub(%r{/_docyard/js/theme\.js}, "#{base_url}_docyard/bundle.#{js_hash}.js")
           .gsub(%r{/_docyard/js/components\.js}, "")
           .gsub(%r{<script src="/_docyard/js/reload\.js"></script>}, "")
+          .then { |html| replace_content_image_paths(html, base_url) }
+      end
+
+      def replace_content_image_paths(content, base_url)
+        return content if base_url == "/"
+
+        content.gsub(%r{(<img[^>]*\ssrc=")/(?!_docyard/)([^"]*")}) do
+          "#{Regexp.last_match(1)}#{base_url}#{Regexp.last_match(2)}"
+        end
       end
 
       def write_bundled_asset(content, hash, extension)

data/lib/docyard/build/error_page_generator.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Build
+    class ErrorPageGenerator
+      attr_reader :config, :docs_path, :renderer
+
+      def initialize(config:, docs_path:, renderer:)
+        @config = config
+        @docs_path = docs_path
+        @renderer = renderer
+      end
+
+      def generate
+        output_path = File.join(config.build.output, "404.html")
+        html_content = load_content
+
+        FileUtils.mkdir_p(File.dirname(output_path))
+        File.write(output_path, html_content)
+      end
+
+      private
+
+      def load_content
+        custom_error_page = File.join(docs_path, "404.html")
+        return File.read(custom_error_page) if File.exist?(custom_error_page)
+
+        branding = BrandingResolver.new(config).resolve
+        renderer.render_not_found(branding: branding)
+      end
+    end
+  end
+end

data/lib/docyard/build/file_writer.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Build
+    module FileWriter
+      def safe_file_write(path)
+        yield
+      rescue Errno::EACCES => e
+        raise BuildError, "Permission denied writing to #{path}: #{e.message}"
+      rescue Errno::ENOSPC => e
+        raise BuildError, "Disk full, cannot write to #{path}: #{e.message}"
+      rescue Errno::EROFS => e
+        raise BuildError, "Read-only filesystem, cannot write to #{path}: #{e.message}"
+      rescue SystemCallError => e
+        raise BuildError, "Failed to write #{path}: #{e.message}"
+      end
+    end
+  end
+end

data/lib/docyard/build/root_fallback_generator.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Build
+    class RootFallbackGenerator
+      attr_reader :config, :docs_path, :sidebar_cache, :renderer
+
+      def initialize(config:, docs_path:, sidebar_cache:, renderer:)
+        @config = config
+        @docs_path = docs_path
+        @sidebar_cache = sidebar_cache
+        @renderer = renderer
+      end
+
+      def generate_if_needed
+        return if root_index_exists?
+
+        first_path = find_first_navigable_path
+        return unless first_path
+
+        generate_redirect_page(first_path)
+      end
+
+      private
+
+      def root_index_exists?
+        File.exist?(File.join(docs_path, "index.md")) ||
+          File.exist?(File.join(docs_path, "index.html"))
+      end
+
+      def find_first_navigable_path
+        return nil unless sidebar_cache&.tree&.any?
+
+        find_first_file_in_tree(sidebar_cache.tree)
+      end
+
+      def find_first_file_in_tree(items)
+        items.each do |item|
+          return item[:path] if item[:type] == :file && item[:path]
+
+          if item[:children]&.any?
+            nested = find_first_file_in_tree(item[:children])
+            return nested if nested
+          end
+        end
+
+        nil
+      end
+
+      def generate_redirect_page(target_path)
+        output_path = File.join(config.build.output, "index.html")
+        full_target = build_full_target_url(target_path)
+
+        FileUtils.mkdir_p(File.dirname(output_path))
+        File.write(output_path, renderer.render_redirect(full_target))
+
+        full_target
+      end
+
+      def build_full_target_url(target_path)
+        base = config.build.base&.chomp("/") || ""
+        "#{base}#{target_path}"
+      end
+    end
+  end
+end

data/lib/docyard/build/static_generator.rb

@@ -7,10 +7,15 @@ require_relative "../navigation/page_navigation_builder"
 require_relative "../navigation/sidebar/cache"
 require_relative "../utils/path_utils"
 require_relative "../utils/git_info"
+require_relative "root_fallback_generator"
+require_relative "error_page_generator"
+require_relative "file_writer"
 
 module Docyard
   module Build
     class StaticGenerator
+      include FileWriter
+
       PARALLEL_THRESHOLD = 10
 
       attr_reader :config, :verbose, :sidebar_cache
@@ -31,6 +36,7 @@ module Docyard
 
         generate_all_pages(markdown_files)
         generate_error_page
+        generate_root_fallback_if_needed
 
         markdown_files.size
       ensure
@@ -161,18 +167,6 @@ module Docyard
         log "Generated: #{output_path}" if verbose
       end
 
-      def safe_file_write(path, &block)
-        block.call
-      rescue Errno::EACCES => e
-        raise BuildError, "Permission denied writing to #{path}: #{e.message}"
-      rescue Errno::ENOSPC => e
-        raise BuildError, "Disk full, cannot write to #{path}: #{e.message}"
-      rescue Errno::EROFS => e
-        raise BuildError, "Read-only filesystem, cannot write to #{path}: #{e.message}"
-      rescue SystemCallError => e
-        raise BuildError, "Failed to write #{path}: #{e.message}"
-      end
-
       def build_sidebar_cache
         @sidebar_cache = Sidebar::Cache.new(
           docs_path: docs_path,
@@ -194,15 +188,23 @@ module Docyard
       end
 
       def generate_error_page
-        output_path = File.join(config.build.output, "404.html")
-        html_content = load_error_page_content
-        safe_file_write(output_path) { File.write(output_path, html_content) }
+        ErrorPageGenerator.new(
+          config: config,
+          docs_path: docs_path,
+          renderer: build_renderer
+        ).generate
         log "[✓] Generated 404.html"
       end
 
-      def load_error_page_content
-        error_page = File.join(docs_path, "404.html")
-        File.exist?(error_page) ? File.read(error_page) : build_renderer.render_not_found
+      def generate_root_fallback_if_needed
+        generator = RootFallbackGenerator.new(
+          config: config,
+          docs_path: docs_path,
+          sidebar_cache: sidebar_cache,
+          renderer: build_renderer
+        )
+        target = generator.generate_if_needed
+        log "[✓] Generated root redirect to #{target}" if target
       end
     end
   end

data/lib/docyard/navigation/breadcrumb_builder.rb

@@ -76,9 +76,10 @@ module Docyard
     def search_in_ancestors(node, path, title, href)
       return unless node[:children]&.any?
 
-      effective_href = href == "/" ? derive_section_path(node) : href
-      return unless path_is_ancestor?(effective_href)
+      section_path = derive_section_path(node, href)
+      return unless path_is_ancestor?(section_path)
 
+      effective_href = resolve_section_href(node, href, section_path)
       result = find_breadcrumb_path(
         node[:children],
         path + [Item.new(title: title, href: effective_href, current: false)]
@@ -86,14 +87,52 @@ module Docyard
       result.any? ? result : nil
     end
 
-    def derive_section_path(node)
-      first_child = node[:children]&.first
+    def derive_section_path(node, href)
+      return href if section_has_index?(href)
+
+      derive_section_path_from_children(node[:children])
+    end
+
+    def derive_section_path_from_children(children)
+      first_child = children&.first
       return nil unless first_child
 
       child_path = first_child[:path]
-      return nil if child_path.nil? || child_path.empty?
+      return nil unless navigable_path?(child_path)
+
+      parent_dir = File.dirname(child_path)
+      root_parent?(parent_dir) ? child_path : parent_dir
+    end
+
+    def root_parent?(parent_dir)
+      parent_dir == "/" || parent_dir.empty?
+    end
+
+    def resolve_section_href(node, href, section_path)
+      return href if section_has_index?(href)
+
+      find_first_navigable_child(node[:children]) || section_path
+    end
+
+    def section_has_index?(path)
+      path && !path.empty? && path != "/"
+    end
+
+    def find_first_navigable_child(children)
+      return nil unless children&.any?
+
+      children.each do |child|
+        return child[:path] if navigable_path?(child[:path])
+
+        nested = find_first_navigable_child(child[:children])
+        return nested if nested
+      end
+
+      nil
+    end
 
-      File.dirname(child_path)
+    def navigable_path?(path)
+      path && !path.empty? && path != "/"
     end
 
     def search_in_children(node, path)

data/lib/docyard/rendering/renderer.rb

@@ -83,16 +83,23 @@ module Docyard
       ERB.new(template).result(binding)
     end
 
-    def render_not_found
+    def render_not_found(branding: nil)
+      @primary_color = branding&.dig(:primary_color)
       render_error_template(404)
     end
 
-    def render_server_error(error)
+    def render_server_error(error, branding: nil)
       @error_message = error.message
       @backtrace = error.backtrace&.join("\n") || "No backtrace available"
+      @primary_color = branding&.dig(:primary_color)
       render_error_template(500)
     end
 
+    def render_redirect(target_url)
+      @target_url = target_url
+      render_error_template(:redirect)
+    end
+
     def render_error_template(status)
       error_template_path = File.join(ERRORS_PATH, "#{status}.html.erb")
       template = File.read(error_template_path)

data/lib/docyard/server/rack_application.rb

@@ -19,7 +19,7 @@ module Docyard
       @dev_mode = !sse_port.nil?
       @sidebar_cache = sidebar_cache
       @router = Router.new(docs_path: docs_path)
-      @renderer = Renderer.new(base_url: config&.build&.base || "/", config: config, dev_mode: @dev_mode,
+      @renderer = Renderer.new(base_url: "/", config: config, dev_mode: @dev_mode,
                                sse_port: sse_port)
       @asset_handler = AssetHandler.new(public_dir: config&.public_dir || "docs/public")
       @pagefind_handler = PagefindHandler.new(pagefind_path: pagefind_path, config: config)
@@ -124,7 +124,7 @@ module Docyard
     end
 
     def render_not_found_page
-      html = renderer.render_not_found
+      html = renderer.render_not_found(branding: branding_options)
       [Constants::STATUS_NOT_FOUND, { "Content-Type" => Constants::CONTENT_TYPE_HTML }, [html]]
     end
 
@@ -147,7 +147,7 @@ module Docyard
       Docyard.logger.error("Request error: #{error.message} [#{request_context}]")
       Docyard.logger.debug(error.backtrace.join("\n"))
       [Constants::STATUS_INTERNAL_ERROR, { "Content-Type" => Constants::CONTENT_TYPE_HTML },
-       [renderer.render_server_error(error)]]
+       [renderer.render_server_error(error, branding: branding_options)]]
     end
 
     def build_request_context(env)

data/lib/docyard/templates/assets/css/components/banner.css

@@ -76,11 +76,11 @@ body.has-announcement:not(.has-tabs) .layout {
 
 @media (max-width: 1280px) and (min-width: 1025px) {
   body.has-announcement .layout {
-    padding-top: calc(var(--header-height) + var(--tab-bar-height) + var(--announcement-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--tab-bar-height) + var(--announcement-height) + var(--secondary-header-height));
   }
 
   body.has-announcement:not(.has-tabs) .layout {
-    padding-top: calc(var(--header-height) + var(--announcement-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--announcement-height) + var(--secondary-header-height));
   }
 }
 
@@ -91,7 +91,7 @@ body.has-announcement:not(.has-tabs) .layout {
   }
 
   body.has-announcement .layout {
-    padding-top: calc(var(--header-height) + var(--announcement-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--announcement-height) + var(--secondary-header-height));
   }
 
   body.has-announcement .sidebar {

data/lib/docyard/templates/assets/css/components/heading-anchor.css

@@ -12,7 +12,7 @@
 .has-tabs .content h4[id],
 .has-tabs .content h5[id],
 .has-tabs .content h6[id] {
-  scroll-margin-top: calc(var(--header-height) + 3rem + var(--spacing-6));
+  scroll-margin-top: calc(var(--header-height) + var(--tab-bar-height) + var(--spacing-6));
 }
 
 @media (max-width: 1280px) and (min-width: 1025px) {
@@ -22,7 +22,7 @@
   .content h4[id],
   .content h5[id],
   .content h6[id] {
-    scroll-margin-top: calc(var(--header-height) + 3rem + var(--spacing-6));
+    scroll-margin-top: calc(var(--header-height) + var(--secondary-header-height) + var(--spacing-6));
   }
 }
 

data/lib/docyard/templates/assets/css/components/tab-bar.css

@@ -123,7 +123,7 @@
 
 @media (max-width: 1280px) and (min-width: 1025px) {
   .has-tabs .layout {
-    padding-top: calc(var(--header-height) + var(--tab-bar-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--tab-bar-height) + var(--secondary-header-height));
   }
 }
 
@@ -143,7 +143,7 @@
   }
 
   .has-tabs .layout {
-    padding-top: calc(var(--header-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--secondary-header-height));
   }
 
   .has-tabs .sidebar {

data/lib/docyard/templates/assets/css/components/table-of-contents.css

@@ -257,30 +257,30 @@
 
 @media (max-width: 1280px) and (min-width: 1025px) {
   .docyard-toc__nav {
-    top: calc(var(--header-height) + 3rem + var(--spacing-2));
+    top: calc(var(--header-height) + var(--secondary-header-height) + var(--spacing-2));
     right: var(--spacing-6);
     width: 280px;
-    max-height: calc(100vh - var(--header-height) - 3rem - var(--spacing-8));
+    max-height: calc(100vh - var(--header-height) - var(--secondary-header-height) - var(--spacing-8));
   }
 
   .has-tabs .docyard-toc__nav {
-    top: calc(var(--header-height) + var(--tab-bar-height) + 3rem + var(--spacing-2));
-    max-height: calc(100vh - var(--header-height) - var(--tab-bar-height) - 3rem - var(--spacing-8));
+    top: calc(var(--header-height) + var(--tab-bar-height) + var(--secondary-header-height) + var(--spacing-2));
+    max-height: calc(100vh - var(--header-height) - var(--tab-bar-height) - var(--secondary-header-height) - var(--spacing-8));
   }
 }
 
 @media (max-width: 1024px) {
   .docyard-toc__nav {
-    top: calc(var(--header-height) + 3rem - 2px);
+    top: calc(var(--header-height) + var(--secondary-header-height) - 2px);
     left: var(--spacing-4);
     right: var(--spacing-4);
-    max-height: calc(100vh - var(--header-height) - 3rem - var(--spacing-2));
+    max-height: calc(100vh - var(--header-height) - var(--secondary-header-height) - var(--spacing-2));
     transform-origin: top center;
   }
 
   .secondary-header.shift-up ~ .layout .docyard-toc__nav {
-    top: calc(3rem - 2px);
-    max-height: calc(100vh - 3rem - var(--spacing-2));
+    top: calc(var(--secondary-header-height) - 2px);
+    max-height: calc(100vh - var(--secondary-header-height) - var(--spacing-2));
   }
 
   .docyard-toc__list .docyard-toc__list {
@@ -292,25 +292,25 @@
 /* Adjust TOC dropdown position when announcement banner is visible */
 @media (max-width: 1280px) and (min-width: 1025px) {
   body.has-announcement .docyard-toc__nav {
-    top: calc(var(--header-height) + var(--announcement-height) + 3rem + var(--spacing-2));
-    max-height: calc(100vh - var(--header-height) - var(--announcement-height) - 3rem - var(--spacing-8));
+    top: calc(var(--header-height) + var(--announcement-height) + var(--secondary-header-height) + var(--spacing-2));
+    max-height: calc(100vh - var(--header-height) - var(--announcement-height) - var(--secondary-header-height) - var(--spacing-8));
   }
 
   body.has-announcement.has-tabs .docyard-toc__nav {
-    top: calc(var(--header-height) + var(--tab-bar-height) + var(--announcement-height) + 3rem + var(--spacing-2));
-    max-height: calc(100vh - var(--header-height) - var(--tab-bar-height) - var(--announcement-height) - 3rem - var(--spacing-8));
+    top: calc(var(--header-height) + var(--tab-bar-height) + var(--announcement-height) + var(--secondary-header-height) + var(--spacing-2));
+    max-height: calc(100vh - var(--header-height) - var(--tab-bar-height) - var(--announcement-height) - var(--secondary-header-height) - var(--spacing-8));
   }
 }
 
 @media (max-width: 1024px) {
   body.has-announcement .docyard-toc__nav {
-    top: calc(var(--header-height) + var(--announcement-height) + 3rem - 2px);
-    max-height: calc(100vh - var(--header-height) - var(--announcement-height) - 3rem - var(--spacing-2));
+    top: calc(var(--header-height) + var(--announcement-height) + var(--secondary-header-height) - 2px);
+    max-height: calc(100vh - var(--header-height) - var(--announcement-height) - var(--secondary-header-height) - var(--spacing-2));
   }
 
   body.has-announcement .secondary-header.shift-up ~ .layout .docyard-toc__nav {
-    top: calc(var(--announcement-height) + 3rem - 2px);
-    max-height: calc(100vh - var(--announcement-height) - 3rem - var(--spacing-2));
+    top: calc(var(--announcement-height) + var(--secondary-header-height) - 2px);
+    max-height: calc(100vh - var(--announcement-height) - var(--secondary-header-height) - var(--spacing-2));
   }
 }
 

data/lib/docyard/templates/assets/css/layout.css

@@ -179,6 +179,15 @@ html:has(.has-tabs) {
   display: none;
 }
 
+.layout {
+  display: flex;
+  min-height: calc(100vh - var(--header-height));
+  padding-top: var(--header-height);
+  width: 100%;
+  max-width: var(--layout-max-width);
+  margin: 0 auto;
+  position: relative;
+}
 
 .secondary-header {
   display: none;
@@ -193,8 +202,8 @@ html:has(.has-tabs) {
     top: var(--header-height);
     left: calc(max(0px, (100vw - var(--layout-max-width)) / 2) + var(--sidebar-width));
     right: max(0px, calc((100vw - var(--layout-max-width)) / 2));
-    height: 3rem;
-    min-height: 3rem;
+    height: var(--secondary-header-height);
+    min-height: var(--secondary-header-height);
     background: var(--background);
     border-bottom: 1px solid var(--border);
     padding: 0 var(--spacing-6);
@@ -213,7 +222,7 @@ html:has(.has-tabs) {
   }
 
   .layout {
-    padding-top: calc(var(--header-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--secondary-header-height));
   }
 }
 
@@ -226,8 +235,8 @@ html:has(.has-tabs) {
     top: var(--header-height);
     left: 0;
     right: 0;
-    height: 3rem;
-    min-height: 3rem;
+    height: var(--secondary-header-height);
+    min-height: var(--secondary-header-height);
     background: var(--background);
     border-bottom: 1px solid var(--border);
     padding: 0 var(--spacing-6);
@@ -278,16 +287,6 @@ html:has(.has-tabs) {
   }
 }
 
-.layout {
-  display: flex;
-  min-height: calc(100vh - var(--header-height));
-  padding-top: var(--header-height);
-  width: 100%;
-  max-width: var(--layout-max-width);
-  margin: 0 auto;
-  position: relative;
-}
-
 .sidebar {
   width: var(--sidebar-width);
   height: calc(100vh - var(--header-height));
@@ -424,7 +423,7 @@ main.content {
   }
 
   .layout {
-    padding-top: calc(var(--header-height) + 3rem);
+    padding-top: calc(var(--header-height) + var(--secondary-header-height));
     flex-direction: column;
   }
 

data/lib/docyard/templates/assets/css/variables.css

@@ -157,6 +157,7 @@
   --toc-width: 17.5rem;
   --header-height: 4rem;
   --tab-bar-height: 3rem;
+  --secondary-header-height: 3rem;
   --content-max-width: 50rem;
   --layout-max-width: 88rem;
 

data/lib/docyard/templates/errors/404.html.erb

@@ -7,7 +7,7 @@
   <style>
     @font-face {
       font-family: 'Inter';
-      src: url('/_docyard/fonts/Inter-Variable.ttf') format('truetype');
+      src: url('<%= base_url %>_docyard/fonts/Inter-Variable.ttf') format('truetype');
       font-weight: 100 900;
       font-style: normal;
     }
@@ -31,6 +31,17 @@
       --primary-foreground: oklch(0.30 0.05 230);
     }
 
+    <% if @primary_color && (@primary_color[:light] || @primary_color[:dark]) %>
+    <% light_color = @primary_color[:light] %>
+    <% dark_color = @primary_color[:dark] || light_color %>
+    <% if light_color %>
+    :root { --primary: <%= light_color %>; }
+    .dark { --primary: <%= dark_color %>; }
+    <% elsif dark_color %>
+    .dark { --primary: <%= dark_color %>; }
+    <% end %>
+    <% end %>
+
     * {
       margin: 0;
       padding: 0;
@@ -116,7 +127,7 @@
     <p class="error-code">404</p>
     <h1 class="error-title">Page not found</h1>
     <p class="error-message">This page doesn't exist or has been moved.</p>
-    <a href="/" class="btn">
+    <a href="<%= base_url %>" class="btn">
       <%= icon(:house_line) %>
       Back to home
     </a>

data/lib/docyard/templates/errors/500.html.erb

@@ -7,7 +7,7 @@
   <style>
     @font-face {
       font-family: 'Inter';
-      src: url('/_docyard/fonts/Inter-Variable.ttf') format('truetype');
+      src: url('<%= base_url %>_docyard/fonts/Inter-Variable.ttf') format('truetype');
       font-weight: 100 900;
       font-style: normal;
     }
@@ -35,6 +35,17 @@
       --destructive: #f87171;
     }
 
+    <% if @primary_color && (@primary_color[:light] || @primary_color[:dark]) %>
+    <% light_color = @primary_color[:light] %>
+    <% dark_color = @primary_color[:dark] || light_color %>
+    <% if light_color %>
+    :root { --primary: <%= light_color %>; }
+    .dark { --primary: <%= dark_color %>; }
+    <% elsif dark_color %>
+    .dark { --primary: <%= dark_color %>; }
+    <% end %>
+    <% end %>
+
     * {
       margin: 0;
       padding: 0;
@@ -166,7 +177,7 @@
     <p class="error-code">500</p>
     <h1 class="error-title">Something went wrong</h1>
     <p class="error-message">We encountered an unexpected error. Please try again.</p>
-    <a href="/" class="btn">
+    <a href="<%= base_url %>" class="btn">
       <%= icon(:house_line) %>
       Back to home
     </a>

data/lib/docyard/templates/errors/redirect.html.erb

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta http-equiv="refresh" content="0;url=<%= @target_url %>">
+  <title>Redirecting...</title>
+  <script>window.location.href = "<%= @target_url %>";</script>
+</head>
+<body>
+  <p>Redirecting to <a href="<%= @target_url %>"><%= @target_url %></a>...</p>
+</body>
+</html>

data/lib/docyard/templates/partials/_head.html.erb

@@ -32,7 +32,7 @@
 <% end %>
 <% end %>
 
-<link rel="preload" href="/_docyard/fonts/Inter-Variable.ttf" as="font" type="font/ttf" crossorigin>
+<link rel="preload" href="<%= asset_path('_docyard/fonts/Inter-Variable.ttf') %>" as="font" type="font/ttf" crossorigin>
 
 <%= render_partial('_icon_library') %>
 

data/lib/docyard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Docyard
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: docyard
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Sanif Himani
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-22 00:00:00.000000000 Z
+date: 2026-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cssminify
@@ -192,8 +192,11 @@ files:
 - exe/docyard
 - lib/docyard.rb
 - lib/docyard/build/asset_bundler.rb
+- lib/docyard/build/error_page_generator.rb
 - lib/docyard/build/file_copier.rb
+- lib/docyard/build/file_writer.rb
 - lib/docyard/build/llms_txt_generator.rb
+- lib/docyard/build/root_fallback_generator.rb
 - lib/docyard/build/sitemap_generator.rb
 - lib/docyard/build/static_generator.rb
 - lib/docyard/builder.rb
@@ -347,6 +350,7 @@ files:
 - lib/docyard/templates/config/docyard.yml.erb
 - lib/docyard/templates/errors/404.html.erb
 - lib/docyard/templates/errors/500.html.erb
+- lib/docyard/templates/errors/redirect.html.erb
 - lib/docyard/templates/init/_sidebar.yml
 - lib/docyard/templates/init/docyard.yml
 - lib/docyard/templates/init/pages/components.md