docyard 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edade5380162369781998f1693e7658c34eb7275092cd709fce68ee25393f0af
-  data.tar.gz: ec1c12df9c38802e881404526b4bff6d10f860320f0f0e3b459344f04c980f51
+  metadata.gz: 69c121af95a08c379f260d0d444aa4bc5272fdfe2d0699866091885c9f503601
+  data.tar.gz: 4550cdcc1d6863b545c4900aac9adb10f14d96a7394ccd3fe4c8924969b278dc
 SHA512:
-  metadata.gz: 656e618b495b1b657bb002857c030dff8929546f453acd559268c9fb25f5d4f355938cf0f705914b54d22d3ca3c5a601635c5168fe85cd1d574f72b1f0c7a897
-  data.tar.gz: f86343f57d8a64520652351ff1d8fa43518af247227f96092b5feff5b0ec2b185b6295017c8d18eb62f12fe28a22c66b71c1390834d296baed643181972a3480
+  metadata.gz: 690e11d0792b71540f09d26fe45dc46d57558b3aad1b3cf80f3e08c592a4056408b6b8a57bfc47f2459feba94e481038f11ccef287534a9f82e557c255728b53
+  data.tar.gz: 8baa1a707f2ff94152499b66c19596a57984c5ff763d2cf43390d986030e2e2eea994febac3089766a764ec1d6314a61479fe2caa54434ee5e64c86ade6431e1

data/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.2] - 2026-01-23
+
+### Fixed
+- "Last updated" timestamps now show correct dates when deploying via CI (#129)
+
+### Documentation
+- Added git history requirements for accurate timestamps on GitHub Actions, Vercel, and Netlify
+
+## [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 +224,10 @@ 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.2...HEAD
+[1.0.2]: https://github.com/sanifhimani/docyard/compare/v1.0.1...v1.0.2
+[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,16 @@ 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 == "/"
+
+        base_path_pattern = Regexp.escape(base_url.delete_prefix("/"))
+        content.gsub(%r{(<img[^>]*\ssrc=")/(?!_docyard/|#{base_path_pattern})([^"]*")}) 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
@@ -149,7 +155,8 @@ module Docyard
         @navigation_builder ||= Navigation::PageNavigationBuilder.new(
           docs_path: docs_path,
           config: config,
-          sidebar_cache: sidebar_cache
+          sidebar_cache: sidebar_cache,
+          base_url: config.build.base
         )
       end
 
@@ -161,18 +168,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 +189,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/navigation/page_navigation_builder.rb

@@ -7,10 +7,11 @@ require_relative "breadcrumb_builder"
 module Docyard
   module Navigation
     class PageNavigationBuilder
-      def initialize(docs_path:, config:, sidebar_cache: nil)
+      def initialize(docs_path:, config:, sidebar_cache: nil, base_url: "/")
         @docs_path = docs_path
         @config = config
         @sidebar_cache = sidebar_cache
+        @base_url = base_url
       end
 
       def build(current_path:, markdown:, header_ctas: [], show_sidebar: true)
@@ -26,7 +27,7 @@ module Docyard
 
       private
 
-      attr_reader :docs_path, :config, :sidebar_cache
+      attr_reader :docs_path, :config, :sidebar_cache, :base_url
 
       def empty_navigation
         { sidebar_html: "", prev_next_html: "", breadcrumbs: nil }
@@ -47,7 +48,8 @@ module Docyard
           sidebar_tree: sidebar_builder.tree,
           current_path: current_path,
           frontmatter: markdown.frontmatter,
-          config: {}
+          config: {},
+          base_url: base_url
         ).to_html
       end
 

data/lib/docyard/navigation/prev_next_builder.rb

@@ -5,13 +5,14 @@ require_relative "../utils/path_resolver"
 
 module Docyard
   class PrevNextBuilder
-    attr_reader :sidebar_tree, :current_path, :frontmatter, :config
+    attr_reader :sidebar_tree, :current_path, :frontmatter, :config, :base_url
 
-    def initialize(sidebar_tree:, current_path:, frontmatter: {}, config: {})
+    def initialize(sidebar_tree:, current_path:, frontmatter: {}, config: {}, base_url: "/")
       @sidebar_tree = sidebar_tree
       @current_path = Utils::PathResolver.normalize(current_path)
       @frontmatter = frontmatter
       @config = config
+      @base_url = base_url
     end
 
     def prev_next_links
@@ -27,7 +28,7 @@ module Docyard
       links = prev_next_links
       return "" if links.nil? || (links[:prev].nil? && links[:next].nil?)
 
-      Renderer.new.render_partial(
+      Renderer.new(base_url: base_url).render_partial(
         "_prev_next", {
           prev: links[:prev],
           next: links[:next],

data/lib/docyard/rendering/renderer.rb

@@ -35,7 +35,7 @@ module Docyard
       markdown = Markdown.new(raw_content, config: config, file_path: file_path)
 
       render(
-        content: strip_md_from_links(markdown.html),
+        content: process_content_links(markdown.html),
         page_title: markdown.title || Constants::DEFAULT_SITE_TITLE,
         page_description: markdown.description,
         page_og_image: markdown.og_image,
@@ -51,7 +51,7 @@ module Docyard
     def render_for_search(file_path)
       markdown = Markdown.new(File.read(file_path), config: config, file_path: file_path)
       title = markdown.title || Constants::DEFAULT_SITE_TITLE
-      content = strip_md_from_links(markdown.html)
+      content = process_content_links(markdown.html)
 
       <<~HTML
         <!DOCTYPE html>
@@ -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)
@@ -163,10 +170,25 @@ module Docyard
       @footer_links = footer[:links]
     end
 
+    def process_content_links(html)
+      rewrite_internal_links(strip_md_from_links(html))
+    end
+
     def strip_md_from_links(html)
       html.gsub(/href="([^"]+)\.md"/, 'href="\1"')
     end
 
+    def rewrite_internal_links(html)
+      return html if base_url == "/"
+
+      html.gsub(%r{href="(/(?!/)[^"]*)"}) do |_match|
+        path = ::Regexp.last_match(1)
+        next %(href="#{path}") if path.start_with?(base_url)
+
+        %(href="#{base_url.chomp('/')}#{path}")
+      end
+    end
+
     def assign_git_info(branding, file_path)
       @show_edit_link = branding[:show_edit_link] && file_path
       @show_last_updated = branding[:show_last_updated] && file_path

data/lib/docyard/server/preview_server.rb

@@ -11,12 +11,13 @@ module Docyard
   class PreviewServer
     DEFAULT_PORT = 4000
 
-    attr_reader :port, :output_dir
+    attr_reader :port, :output_dir, :base_url
 
     def initialize(port: DEFAULT_PORT)
       @port = port
       @config = Config.load
       @output_dir = File.expand_path(@config.build.output)
+      @base_url = normalize_base_url(@config.build.base)
       @launcher = nil
     end
 
@@ -38,12 +39,12 @@ module Docyard
     def print_server_info
       Docyard.logger.info("Starting preview server...")
       Docyard.logger.info("* Version: #{Docyard::VERSION}")
-      Docyard.logger.info("* Running at: http://localhost:#{port}")
+      Docyard.logger.info("* Running at: http://localhost:#{port}#{base_url}")
       Docyard.logger.info("Use Ctrl+C to stop\n")
     end
 
     def run_server
-      app = StaticFileApp.new(output_dir)
+      app = StaticFileApp.new(output_dir, base_path: base_url)
       puma_config = build_puma_config(app)
       log_writer = Puma::LogWriter.strings
 
@@ -64,5 +65,12 @@ module Docyard
         config.quiet
       end
     end
+
+    def normalize_base_url(url)
+      return "/" if url.nil? || url.empty?
+
+      url = "/#{url}" unless url.start_with?("/")
+      url.end_with?("/") ? url : "#{url}/"
+    end
   end
 end

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/server/static_file_app.rb

@@ -4,15 +4,20 @@ require "rack/mime"
 
 module Docyard
   class StaticFileApp
-    def initialize(root)
+    def initialize(root, base_path: "/")
       @root = root
+      @base_path = base_path.chomp("/")
     end
 
     def call(env)
       path = env["PATH_INFO"]
-      file_path = File.join(@root, path)
 
-      if path.end_with?("/") || File.directory?(file_path)
+      return serve_not_found unless path_under_base?(path)
+
+      relative_path = strip_base_path(path)
+      file_path = File.join(@root, relative_path)
+
+      if relative_path.end_with?("/") || relative_path.empty? || File.directory?(file_path)
         index_path = File.join(file_path, "index.html")
         return serve_file(index_path) if File.file?(index_path)
       elsif File.file?(file_path)
@@ -24,6 +29,18 @@ module Docyard
 
     private
 
+    def path_under_base?(path)
+      return true if @base_path.empty?
+
+      path == @base_path || path.start_with?("#{@base_path}/")
+    end
+
+    def strip_base_path(path)
+      return path if @base_path.empty?
+
+      path.delete_prefix(@base_path)
+    end
+
     def serve_file(path)
       content = File.read(path)
       content_type = Rack::Mime.mime_type(File.extname(path), "application/octet-stream")

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.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: docyard
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 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
@@ -178,7 +178,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.18'
-description: Beautiful, zero-config documentation sites. Built with Ruby.
+description: Generate beautiful documentation sites from Markdown
 email:
 - sanifhimani92@gmail.com
 executables:
@@ -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
@@ -399,13 +403,16 @@ files:
 - lib/docyard/utils/text_formatter.rb
 - lib/docyard/utils/url_helpers.rb
 - lib/docyard/version.rb
-homepage: https://github.com/sanifhimani/docyard
+homepage: https://docyard.dev
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/sanifhimani/docyard
+  homepage_uri: https://docyard.dev
   source_code_uri: https://github.com/sanifhimani/docyard
+  changelog_uri: https://github.com/sanifhimani/docyard/blob/main/CHANGELOG.md
+  documentation_uri: https://docyard.dev
+  bug_tracker_uri: https://github.com/sanifhimani/docyard/issues
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -425,5 +432,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Documentation generator for Ruby
+summary: Generate beautiful documentation sites from Markdown
 test_files: []