docyard 0.7.0 → 0.9.0

data/lib/docyard/templates/assets/js/components/tabs.js

@@ -1,13 +1,5 @@
-/**
- * TabsManager - Manages tab component interactions
- *
- * @class TabsManager
- */
 class TabsManager {
-  /**
-   * Create a TabsManager instance
-   * @param {HTMLElement} container - The .docyard-tabs container element
-   */
+  
   constructor(container) {
     if (!container) return;
 
@@ -28,9 +20,7 @@ class TabsManager {
     this.init();
   }
 
-  /**
-   * Initialize the tabs component
-   */
+  
   init() {
     if (!this.tabList || this.tabs.length === 0 || this.panels.length === 0) {
       return;
@@ -41,12 +31,15 @@ class TabsManager {
     this.attachEventListeners();
     this.activateTab(this.activeIndex, false);
     this.updateIndicator();
-    this.updateScrollIndicators();
+
+    requestAnimationFrame(() => {
+      requestAnimationFrame(() => {
+        this.updateScrollIndicators();
+      });
+    });
   }
 
-  /**
-   * Create scroll indicator elements
-   */
+  
   createScrollIndicators() {
     if (!this.tabListWrapper || !this.tabList) return;
 
@@ -59,9 +52,7 @@ class TabsManager {
     this.tabListWrapper.appendChild(this.rightIndicator);
   }
 
-  /**
-   * Attach all event listeners
-   */
+  
   attachEventListeners() {
     this.tabs.forEach((tab, index) => {
       tab.addEventListener('click', () => this.handleTabClick(index));
@@ -74,10 +65,7 @@ class TabsManager {
     window.addEventListener('resize', this.handleResize);
   }
 
-  /**
-   * Handle tab click
-   * @param {number} index - Index of clicked tab
-   */
+  
   handleTabClick(index) {
     if (index === this.activeIndex) return;
 
@@ -85,10 +73,7 @@ class TabsManager {
     this.savePreference(index);
   }
 
-  /**
-   * Handle keyboard navigation
-   * @param {KeyboardEvent} event - Keyboard event
-   */
+  
   handleKeyDown(event) {
     const { key } = event;
 
@@ -118,9 +103,7 @@ class TabsManager {
     }
   }
 
-  /**
-   * Handle scroll event - update scroll indicators
-   */
+  
   handleScroll() {
     if (this.scrollTimeout) {
       cancelAnimationFrame(this.scrollTimeout);
@@ -131,9 +114,7 @@ class TabsManager {
     });
   }
 
-  /**
-   * Handle window resize - update indicator and scroll indicators
-   */
+  
   handleResize() {
     if (this.resizeTimeout) {
       cancelAnimationFrame(this.resizeTimeout);
@@ -145,17 +126,15 @@ class TabsManager {
     });
   }
 
-  /**
-   * Activate a specific tab
-   * @param {number} index - Index of tab to activate
-   * @param {boolean} animate - Whether to animate the transition
-   */
+  
   activateTab(index, animate = true) {
     if (index < 0 || index >= this.tabs.length) return;
 
     const previousIndex = this.activeIndex;
     this.activeIndex = index;
 
+    const direction = index > previousIndex ? 'right' : 'left';
+
     this.tabs.forEach((tab, i) => {
       const isActive = i === index;
       tab.setAttribute('aria-selected', isActive ? 'true' : 'false');
@@ -165,6 +144,12 @@ class TabsManager {
     this.panels.forEach((panel, i) => {
       const isActive = i === index;
       panel.setAttribute('aria-hidden', isActive ? 'false' : 'true');
+
+      if (isActive && animate && previousIndex !== index) {
+        panel.setAttribute('data-direction', direction);
+      } else {
+        panel.removeAttribute('data-direction');
+      }
     });
 
     this.updateIndicator(animate);
@@ -174,26 +159,19 @@ class TabsManager {
     }
   }
 
-  /**
-   * Activate the next tab (wraps around)
-   */
+  
   activateNextTab() {
     const nextIndex = (this.activeIndex + 1) % this.tabs.length;
     this.activateTab(nextIndex, true);
   }
 
-  /**
-   * Activate the previous tab (wraps around)
-   */
+  
   activatePreviousTab() {
     const prevIndex = (this.activeIndex - 1 + this.tabs.length) % this.tabs.length;
     this.activateTab(prevIndex, true);
   }
 
-  /**
-   * Update the visual indicator position
-   * @param {boolean} animate - Whether to animate the transition
-   */
+  
   updateIndicator(animate = true) {
     if (!this.indicator || !this.tabs[this.activeIndex]) return;
 
@@ -214,9 +192,7 @@ class TabsManager {
     }
   }
 
-  /**
-   * Update scroll indicators visibility based on scroll position
-   */
+  
   updateScrollIndicators() {
     if (!this.tabList || !this.leftIndicator || !this.rightIndicator) return;
 
@@ -244,9 +220,7 @@ class TabsManager {
     }
   }
 
-  /**
-   * Load user preference from localStorage
-   */
+  
   loadPreference() {
     try {
       const preferredTab = localStorage.getItem('docyard-preferred-pm');
@@ -264,10 +238,7 @@ class TabsManager {
     }
   }
 
-  /**
-   * Save user preference to localStorage
-   * @param {number} index - Index of active tab
-   */
+  
   savePreference(index) {
     if (index < 0 || index >= this.tabs.length) return;
 
@@ -279,10 +250,7 @@ class TabsManager {
     }
   }
 
-  /**
-   * Activate tab by name
-   * @param {string} name - Name of tab to activate
-   */
+  
   activateTabByName(name) {
     const index = this.tabs.findIndex(tab =>
       tab.textContent.trim().toLowerCase() === name.toLowerCase()
@@ -293,9 +261,7 @@ class TabsManager {
     }
   }
 
-  /**
-   * Cleanup - remove event listeners
-   */
+  
   destroy() {
     this.tabs.forEach((tab, index) => {
       tab.removeEventListener('click', () => this.handleTabClick(index));
@@ -315,9 +281,6 @@ class TabsManager {
   }
 }
 
-/**
- * Auto-initialize all tabs on page load
- */
 function initializeTabs() {
   const tabsContainers = document.querySelectorAll('.docyard-tabs');
 
@@ -326,7 +289,6 @@ function initializeTabs() {
   });
 }
 
-// Initialize on DOM ready
 if (document.readyState === 'loading') {
   document.addEventListener('DOMContentLoaded', initializeTabs);
 } else {

data/lib/docyard/templates/assets/js/components/tooltip.js

@@ -0,0 +1,118 @@
+function initializeTooltips() {
+  const tooltips = document.querySelectorAll('.docyard-tooltip');
+  if (tooltips.length === 0) return;
+
+  const popover = createTooltipPopover();
+  document.body.appendChild(popover);
+
+  let hideTimeout;
+  let isHoveringPopover = false;
+
+  popover.addEventListener('mouseenter', () => {
+    isHoveringPopover = true;
+    clearTimeout(hideTimeout);
+  });
+
+  popover.addEventListener('mouseleave', () => {
+    isHoveringPopover = false;
+    hideTimeout = setTimeout(() => {
+      hideTooltipPopover(popover);
+    }, 100);
+  });
+
+  tooltips.forEach(tooltip => {
+    tooltip.addEventListener('mouseenter', () => {
+      clearTimeout(hideTimeout);
+      showTooltipPopover(popover, tooltip);
+    });
+
+    tooltip.addEventListener('mouseleave', () => {
+      hideTimeout = setTimeout(() => {
+        if (!isHoveringPopover) {
+          hideTooltipPopover(popover);
+        }
+      }, 100);
+    });
+  });
+}
+
+function createTooltipPopover() {
+  const popover = document.createElement('div');
+  popover.className = 'docyard-tooltip-popover';
+  popover.innerHTML = `
+    <span class="docyard-tooltip-popover__term"></span>
+    <span class="docyard-tooltip-popover__description"></span>
+    <a class="docyard-tooltip-popover__link" style="display: none;">
+      <span class="docyard-tooltip-popover__link-text"></span>
+      <svg class="docyard-tooltip-popover__link-icon" viewBox="0 0 256 256" fill="currentColor">
+        <path d="M221.66,133.66l-72,72a8,8,0,0,1-11.32-11.32L196.69,136H40a8,8,0,0,1,0-16H196.69l-58.35-58.34a8,8,0,0,1,11.32-11.32l72,72A8,8,0,0,1,221.66,133.66Z"></path>
+      </svg>
+    </a>
+  `;
+  return popover;
+}
+
+function showTooltipPopover(popover, tooltip) {
+  const term = tooltip.textContent;
+  const description = tooltip.dataset.description;
+  const link = tooltip.dataset.link;
+  const linkText = tooltip.dataset.linkText;
+
+  popover.querySelector('.docyard-tooltip-popover__term').textContent = term;
+  popover.querySelector('.docyard-tooltip-popover__description').textContent = description;
+
+  const linkEl = popover.querySelector('.docyard-tooltip-popover__link');
+  if (link) {
+    linkEl.href = link;
+    linkEl.querySelector('.docyard-tooltip-popover__link-text').textContent = linkText;
+    linkEl.style.display = 'inline-flex';
+  } else {
+    linkEl.style.display = 'none';
+  }
+
+  const rect = tooltip.getBoundingClientRect();
+  const scrollX = window.scrollX;
+  const scrollY = window.scrollY;
+
+  popover.style.visibility = 'hidden';
+  popover.classList.add('is-visible');
+
+  requestAnimationFrame(() => {
+    const popoverRect = popover.getBoundingClientRect();
+    let left = rect.left + scrollX + (rect.width / 2) - (popoverRect.width / 2);
+    let top = rect.top + scrollY - popoverRect.height - 8;
+
+    const viewportWidth = window.innerWidth;
+    const padding = 16;
+
+    if (left < padding) {
+      left = padding;
+    } else if (left + popoverRect.width > viewportWidth - padding) {
+      left = viewportWidth - popoverRect.width - padding;
+    }
+
+    if (top < scrollY + padding) {
+      top = rect.bottom + scrollY + 8;
+      popover.classList.add('is-below');
+    } else {
+      popover.classList.remove('is-below');
+    }
+
+    const arrowLeft = rect.left + scrollX + (rect.width / 2) - left;
+    popover.style.setProperty('--arrow-left', `${Math.max(12, Math.min(arrowLeft, popoverRect.width - 12))}px`);
+
+    popover.style.left = `${left}px`;
+    popover.style.top = `${top}px`;
+    popover.style.visibility = 'visible';
+  });
+}
+
+function hideTooltipPopover(popover) {
+  popover.classList.remove('is-visible');
+}
+
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', initializeTooltips);
+} else {
+  initializeTooltips();
+}

data/lib/docyard/templates/assets/js/theme.js

@@ -1,6 +1,3 @@
-// Docyard Theme JavaScript
-// Handles dark/light theme toggling
-
 (function() {
   'use strict';
 

data/lib/docyard/templates/assets/logo-dark.svg

@@ -1,4 +1,10 @@
 <svg width="531" height="769" viewBox="0 0 531 769" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M359.643 59.1798C402.213 89.4398 449.713 123.6 502.063 160.99C510.793 167.23 515.873 170.31 519.293 178.05C523.253 187.02 521.733 198.11 515.883 205.77C513.77 208.536 510.93 211.2 507.363 213.76C379.643 305.353 309.413 355.73 296.673 364.89C287.987 371.136 282.07 374.8 278.923 375.88C269.703 379.026 260.263 378.636 250.603 374.71C248.243 373.75 244.497 371.416 239.363 367.71C199.963 339.29 177.32 322.99 171.433 318.81C128.863 288.54 81.3733 254.39 29.0233 216.99C20.2833 210.75 15.2033 207.67 11.7833 199.93C7.82332 190.96 9.34332 179.87 15.1933 172.21C17.3067 169.443 20.1467 166.78 23.7133 164.22C151.433 72.6264 221.663 22.2498 234.403 13.0898C243.09 6.84309 249.007 3.17976 252.153 2.09976C261.373 -1.04691 270.813 -0.656912 280.473 3.26976C282.833 4.22976 286.58 6.56309 291.713 10.2698C331.113 38.6898 353.757 54.9931 359.643 59.1798Z" fill="#DC2626"/>
-<path d="M467.383 298.01C483.943 286.23 505.033 289.93 519.063 303.51C524.457 308.723 528.033 314.713 529.793 321.48C530.433 323.92 530.733 330.946 530.693 342.56C530.647 356.206 530.657 427.233 530.723 555.64C530.723 566.633 530.513 573 530.093 574.74C527.033 587.29 518.333 592.61 506.693 601.06C504.313 602.786 430.877 656.346 286.383 761.74C275.623 769.59 261.793 770.79 250.113 764.36C249.18 763.846 245.86 761.513 240.153 757.36C150.56 692.066 74.8667 637.046 13.0733 592.3C6.70001 587.68 2.65667 581.73 0.943337 574.45C0.316671 571.783 0.00333476 564.803 0.00333476 553.51C-0.00333191 421.323 -4.06895e-06 348.98 0.0133293 336.48C0.0133293 332.84 -0.0766665 327.18 0.783334 323.18C4.59333 305.51 20.1033 293.29 37.4533 291.15C42.9467 290.476 48.8667 291.276 55.2133 293.55C58.28 294.643 63.3533 297.8 70.4333 303.02C75.98 307.113 82.4433 311.78 89.8233 317.02C128.563 344.526 178.703 380.303 240.243 424.35C242.73 426.13 245.853 428.246 249.613 430.7C257.443 435.8 268.453 436.24 277.213 433.14C279.8 432.22 284.54 429.283 291.433 424.33C394.46 350.276 453.11 308.17 467.383 298.01Z" fill="#E5E5E5"/>
+<defs>
+<style>
+.logo-accent { fill: #22D3EE; }
+.logo-dark { fill: #FFFFFF; }
+</style>
+</defs>
+<path class="logo-accent" d="M359.643 59.1798C402.213 89.4398 449.713 123.6 502.063 160.99C510.793 167.23 515.873 170.31 519.293 178.05C523.253 187.02 521.733 198.11 515.883 205.77C513.77 208.536 510.93 211.2 507.363 213.76C379.643 305.353 309.413 355.73 296.673 364.89C287.987 371.136 282.07 374.8 278.923 375.88C269.703 379.026 260.263 378.636 250.603 374.71C248.243 373.75 244.497 371.416 239.363 367.71C199.963 339.29 177.32 322.99 171.433 318.81C128.863 288.54 81.3733 254.39 29.0233 216.99C20.2833 210.75 15.2033 207.67 11.7833 199.93C7.82332 190.96 9.34332 179.87 15.1933 172.21C17.3067 169.443 20.1467 166.78 23.7133 164.22C151.433 72.6264 221.663 22.2498 234.403 13.0898C243.09 6.84309 249.007 3.17976 252.153 2.09976C261.373 -1.04691 270.813 -0.656912 280.473 3.26976C282.833 4.22976 286.58 6.56309 291.713 10.2698C331.113 38.6898 353.757 54.9931 359.643 59.1798Z"/>
+<path class="logo-dark" d="M467.383 298.01C483.943 286.23 505.033 289.93 519.063 303.51C524.457 308.723 528.033 314.713 529.793 321.48C530.433 323.92 530.733 330.946 530.693 342.56C530.647 356.206 530.657 427.233 530.723 555.64C530.723 566.633 530.513 573 530.093 574.74C527.033 587.29 518.333 592.61 506.693 601.06C504.313 602.786 430.877 656.346 286.383 761.74C275.623 769.59 261.793 770.79 250.113 764.36C249.18 763.846 245.86 761.513 240.153 757.36C150.56 692.066 74.8667 637.046 13.0733 592.3C6.70001 587.68 2.65667 581.73 0.943337 574.45C0.316671 571.783 0.00333476 564.803 0.00333476 553.51C-0.00333191 421.323 -4.06895e-06 348.98 0.0133293 336.48C0.0133293 332.84 -0.0766665 327.18 0.783334 323.18C4.59333 305.51 20.1033 293.29 37.4533 291.15C42.9467 290.476 48.8667 291.276 55.2133 293.55C58.28 294.643 63.3533 297.8 70.4333 303.02C75.98 307.113 82.4433 311.78 89.8233 317.02C128.563 344.526 178.703 380.303 240.243 424.35C242.73 426.13 245.853 428.246 249.613 430.7C257.443 435.8 268.453 436.24 277.213 433.14C279.8 432.22 284.54 429.283 291.433 424.33C394.46 350.276 453.11 308.17 467.383 298.01Z"/>
 </svg>

data/lib/docyard/templates/assets/logo.svg

@@ -1,12 +1,15 @@
 <svg width="531" height="769" viewBox="0 0 531 769" fill="none" xmlns="http://www.w3.org/2000/svg">
 <defs>
 <style>
+.logo-accent { fill: #06B6D4; }
+.logo-dark { fill: #18181B; }
+
 @media (prefers-color-scheme: dark) {
-  path[fill="#1E1E1D"] { fill: #E5E5E5; }
-  path[fill="#AB333D"] { fill: #DC2626; }
+  .logo-accent { fill: #22D3EE; }
+  .logo-dark { fill: #E4E4E7; }
 }
 </style>
 </defs>
-<path d="M359.643 59.1798C402.213 89.4398 449.713 123.6 502.063 160.99C510.793 167.23 515.873 170.31 519.293 178.05C523.253 187.02 521.733 198.11 515.883 205.77C513.77 208.536 510.93 211.2 507.363 213.76C379.643 305.353 309.413 355.73 296.673 364.89C287.987 371.136 282.07 374.8 278.923 375.88C269.703 379.026 260.263 378.636 250.603 374.71C248.243 373.75 244.497 371.416 239.363 367.71C199.963 339.29 177.32 322.99 171.433 318.81C128.863 288.54 81.3733 254.39 29.0233 216.99C20.2833 210.75 15.2033 207.67 11.7833 199.93C7.82332 190.96 9.34332 179.87 15.1933 172.21C17.3067 169.443 20.1467 166.78 23.7133 164.22C151.433 72.6264 221.663 22.2498 234.403 13.0898C243.09 6.84309 249.007 3.17976 252.153 2.09976C261.373 -1.04691 270.813 -0.656912 280.473 3.26976C282.833 4.22976 286.58 6.56309 291.713 10.2698C331.113 38.6898 353.757 54.9931 359.643 59.1798Z" fill="#AB333D"/>
-<path d="M467.383 298.01C483.943 286.23 505.033 289.93 519.063 303.51C524.457 308.723 528.033 314.713 529.793 321.48C530.433 323.92 530.733 330.946 530.693 342.56C530.647 356.206 530.657 427.233 530.723 555.64C530.723 566.633 530.513 573 530.093 574.74C527.033 587.29 518.333 592.61 506.693 601.06C504.313 602.786 430.877 656.346 286.383 761.74C275.623 769.59 261.793 770.79 250.113 764.36C249.18 763.846 245.86 761.513 240.153 757.36C150.56 692.066 74.8667 637.046 13.0733 592.3C6.70001 587.68 2.65667 581.73 0.943337 574.45C0.316671 571.783 0.00333476 564.803 0.00333476 553.51C-0.00333191 421.323 -4.06895e-06 348.98 0.0133293 336.48C0.0133293 332.84 -0.0766665 327.18 0.783334 323.18C4.59333 305.51 20.1033 293.29 37.4533 291.15C42.9467 290.476 48.8667 291.276 55.2133 293.55C58.28 294.643 63.3533 297.8 70.4333 303.02C75.98 307.113 82.4433 311.78 89.8233 317.02C128.563 344.526 178.703 380.303 240.243 424.35C242.73 426.13 245.853 428.246 249.613 430.7C257.443 435.8 268.453 436.24 277.213 433.14C279.8 432.22 284.54 429.283 291.433 424.33C394.46 350.276 453.11 308.17 467.383 298.01Z" fill="#1E1E1D"/>
+<path class="logo-accent" d="M359.643 59.1798C402.213 89.4398 449.713 123.6 502.063 160.99C510.793 167.23 515.873 170.31 519.293 178.05C523.253 187.02 521.733 198.11 515.883 205.77C513.77 208.536 510.93 211.2 507.363 213.76C379.643 305.353 309.413 355.73 296.673 364.89C287.987 371.136 282.07 374.8 278.923 375.88C269.703 379.026 260.263 378.636 250.603 374.71C248.243 373.75 244.497 371.416 239.363 367.71C199.963 339.29 177.32 322.99 171.433 318.81C128.863 288.54 81.3733 254.39 29.0233 216.99C20.2833 210.75 15.2033 207.67 11.7833 199.93C7.82332 190.96 9.34332 179.87 15.1933 172.21C17.3067 169.443 20.1467 166.78 23.7133 164.22C151.433 72.6264 221.663 22.2498 234.403 13.0898C243.09 6.84309 249.007 3.17976 252.153 2.09976C261.373 -1.04691 270.813 -0.656912 280.473 3.26976C282.833 4.22976 286.58 6.56309 291.713 10.2698C331.113 38.6898 353.757 54.9931 359.643 59.1798Z"/>
+<path class="logo-dark" d="M467.383 298.01C483.943 286.23 505.033 289.93 519.063 303.51C524.457 308.723 528.033 314.713 529.793 321.48C530.433 323.92 530.733 330.946 530.693 342.56C530.647 356.206 530.657 427.233 530.723 555.64C530.723 566.633 530.513 573 530.093 574.74C527.033 587.29 518.333 592.61 506.693 601.06C504.313 602.786 430.877 656.346 286.383 761.74C275.623 769.59 261.793 770.79 250.113 764.36C249.18 763.846 245.86 761.513 240.153 757.36C150.56 692.066 74.8667 637.046 13.0733 592.3C6.70001 587.68 2.65667 581.73 0.943337 574.45C0.316671 571.783 0.00333476 564.803 0.00333476 553.51C-0.00333191 421.323 -4.06895e-06 348.98 0.0133293 336.48C0.0133293 332.84 -0.0766665 327.18 0.783334 323.18C4.59333 305.51 20.1033 293.29 37.4533 291.15C42.9467 290.476 48.8667 291.276 55.2133 293.55C58.28 294.643 63.3533 297.8 70.4333 303.02C75.98 307.113 82.4433 311.78 89.8233 317.02C128.563 344.526 178.703 380.303 240.243 424.35C242.73 426.13 245.853 428.246 249.613 430.7C257.443 435.8 268.453 436.24 277.213 433.14C279.8 432.22 284.54 429.283 291.433 424.33C394.46 350.276 453.11 308.17 467.383 298.01Z"/>
 </svg>

data/lib/docyard/templates/config/docyard.yml.erb

@@ -1,42 +1,45 @@
 # Docyard Configuration
 # Documentation: https://github.com/yourusername/docyard
 
-# Site Information
-site:
-  title: "My Documentation"
-  description: "Documentation for my project"
+# Site Identity
+title: "My Documentation"
+description: "Documentation for my project"
 
-# Custom Branding (Optional)
-# Paths relative to docs/ directory, or use URLs for CDN-hosted assets
-branding:
-  # logo: "assets/logo.svg"              # Light mode logo
-  # logo_dark: "assets/logo-dark.svg"    # Dark mode logo (optional, falls back to 'logo')
-  # favicon: "assets/favicon.svg"        # Browser tab icon
-  # appearance:
-  #   logo: true                          # Show logo in header
-  #   title: true                         # Show site title in header
+# Branding (Optional)
+# Docyard auto-detects these files from docs/public/:
+#   - logo.svg or logo.png (and logo-dark.svg for dark mode)
+#   - favicon.ico, favicon.svg, or favicon.png
+# Only configure if you need custom paths or filenames.
+# branding:
+#   logo: "custom-logo.svg"    # Override auto-detected logo
+#   favicon: "custom.ico"      # Override auto-detected favicon
+#   credits: true              # Show "Built with Docyard" link
 
-# Sidebar Navigation (Optional)
-# Customize the order and organization of your documentation pages
-# Without this, sidebar is auto-generated from docs/ folder structure
-# sidebar:
-#   items:
-#     - installation                     # Simple page reference
-#
-#     - guides:                          # Nested group
-#         text: "User Guides"
-#         icon: "book-open"              # Icon from phosphoricons.com
-#         items:
-#           - markdown-features
-#           - configuration
-#
-#     - text: "GitHub"                   # External link
-#       link: "https://github.com/youruser/yourrepo"
-#       icon: "github-logo"
-#       target: "_blank"
+# Social Links (Optional)
+# These appear in the footer
+# socials:
+#   github: https://github.com/user/repo
+#   twitter: https://twitter.com/handle
+
+# Tab Navigation (Optional)
+# Use tabs to organize large documentation into sections
+# tabs:
+#   - text: Guide
+#     href: /guide
+#   - text: API Reference
+#     href: /api
+#   - text: Blog
+#     href: https://blog.example.com
+#     external: true
+
+# Search Configuration
+# search:
+#   enabled: true
+#   placeholder: "Search documentation..."
+#   exclude:
+#     - /drafts/*
 
 # Build Configuration
 build:
-  output_dir: "dist"      # Output directory for static files
-  base_url: "/"           # Base URL for deployment (e.g., "/docs/" for subdirectory)
-  clean: true             # Clean output directory before building
+  output: "dist"      # Output directory for static files
+  base: "/"           # Base URL for deployment (e.g., "/docs/" for subdirectory)

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

@@ -4,7 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>404 - Page Not Found</title>
-  <link rel="stylesheet" href="/assets/css/main.css">
+  <link rel="stylesheet" href="/_docyard/css/main.css">
 </head>
 <body>
   <main>

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

@@ -4,7 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>500 - Server Error</title>
-  <link rel="stylesheet" href="/assets/css/main.css">
+  <link rel="stylesheet" href="/_docyard/css/main.css">
 </head>
 <body>
   <main>

data/lib/docyard/templates/layouts/default.html.erb

@@ -1,99 +1,51 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <meta name="description" content="<%= @site_description %>">
-  <title><%= @page_title %> | <%= @site_title %></title>
-  <link rel="icon" href="<%= asset_path(@favicon) %>" type="image/svg+xml">
-
-  <!-- Prevent flash of wrong theme -->
-  <script>
-    (function() {
-      const theme = localStorage.getItem('theme') ||
-                   (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
-      document.documentElement.classList.toggle('dark', theme === 'dark');
-    })();
-  </script>
-
-  <link rel="stylesheet" href="/assets/css/main.css">
+  <%= render_partial('_head') %>
 </head>
-<body>
-  <!-- Skip to main content for accessibility -->
+<body<%= ' class="has-tabs"' if @has_tabs %>>
+  <%= render_partial('_banner') %>
   <a href="#main-content" class="skip-link">Skip to main content</a>
 
-  <!-- Primary Header -->
-  <header class="header">
-    <div class="header-content">
-      <a href="<%= link_path('/') %>" class="header-logo">
-        <% if @display_logo %>
-        <div class="site-logo-container">
-          <% if @logo %>
-          <img src="<%= asset_path(@logo) %>" alt="<%= @site_title %>" class="site-logo site-logo-light">
-          <% end %>
-          <% if @logo_dark %>
-          <img src="<%= asset_path(@logo_dark) %>" alt="<%= @site_title %>" class="site-logo site-logo-dark">
-          <% else %>
-          <img src="<%= asset_path(@logo) %>" alt="<%= @site_title %>" class="site-logo site-logo-dark">
-          <% end %>
-        </div>
-        <% end %>
-        <% if @display_title %>
-        <span class="header-title"><%= @site_title %></span>
-        <% end %>
-      </a>
-
-      <% if @search_enabled %>
-      <div class="header-center">
-        <%= render_partial('_search_trigger') %>
-      </div>
-      <% end %>
-
-      <div class="header-actions">
-        <%= render_partial('_theme_toggle') %>
-      </div>
-    </div>
-  </header>
+  <%= render_partial('_header') %>
+  <%= render_partial('_tab_bar') %>
+  <%= render_partial('_nav_menu') %>
 
-  <!-- Secondary Header (Mobile Navigation) -->
   <div class="secondary-header">
     <button class="secondary-header-menu" aria-label="Toggle navigation menu" aria-expanded="false">
-      <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor" width="18" height="18">
-        <path d="M224,128a8,8,0,0,1-8,8H40a8,8,0,0,1,0-16H216A8,8,0,0,1,224,128ZM40,72H216a8,8,0,0,0,0-16H40a8,8,0,0,0,0,16ZM216,184H40a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16Z"></path>
-      </svg>
+      <%= icon(:sidebar) %>
       <span>Menu</span>
     </button>
 
     <%= render_partial('_table_of_contents_toggle') %>
   </div>
 
-  <!-- Mobile overlay -->
   <div class="mobile-overlay" aria-hidden="true"></div>
 
   <div class="layout">
-    <!-- Sidebar navigation -->
     <%= @sidebar_html %>
 
-    <!-- Main content area -->
     <div class="layout-main">
       <main id="main-content" class="content" data-pagefind-body>
+        <%= render_partial('_breadcrumbs') %>
         <%= @content %>
 
-        <!-- Previous/Next Navigation -->
         <%= @prev_next_html %>
+
+        <div class="doc-footer-mobile">
+          <%= render_partial('_doc_footer') %>
+        </div>
       </main>
     </div>
 
-    <!-- Table of contents -->
-    <%= render_partial('_table_of_contents') %>
+    <aside class="doc-aside">
+      <%= render_partial('_table_of_contents') %>
+      <div class="doc-footer-desktop">
+        <%= render_partial('_doc_footer') %>
+      </div>
+    </aside>
   </div>
 
-  <% if @search_enabled %>
-  <%= render_partial('_search_modal') %>
-  <% end %>
-
-  <script src="/assets/js/theme.js"></script>
-  <script src="/assets/js/components.js"></script>
-  <script src="/assets/js/reload.js"></script>
+  <%= render_partial('_scripts') %>
 </body>
 </html>