From 085c9872fe360603636d37b3e7bd4ca7bf70352b Mon Sep 17 00:00:00 2001
From: 0xlukem <lucas.malizia27@gmail.com>
Date: Mon, 23 Feb 2026 14:36:02 -0300
Subject: [PATCH 1/4] add breadcrumbs

---
 mkdocs.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mkdocs.yml b/mkdocs.yml
index 75dd6cb4..de07e262 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -25,6 +25,7 @@ theme:
     - navigation.sections
     - toc.follow
     - content.action.edit
+    - navigation.path
   palette:
     - media: "(prefers-color-scheme: dark)"
       scheme: slate

From cb15c0835882df32e33ada75f66ff62760f6801b Mon Sep 17 00:00:00 2001
From: 0xlukem <lucas.malizia27@gmail.com>
Date: Mon, 23 Feb 2026 14:36:09 -0300
Subject: [PATCH 2/4] add logic

---
 material-overrides/main.html | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/material-overrides/main.html b/material-overrides/main.html
index 90937a47..d9361930 100644
--- a/material-overrides/main.html
+++ b/material-overrides/main.html
@@ -37,6 +37,9 @@
 
 {%- block container -%}
   <div class="md-content" data-md-component="content">
+    {% if "navigation.path" in features %}
+      {% include "partials/path.html" %}
+    {% endif %}
     {% set class = "index-page" if not page.content and not page.is_homepage %}
     <article class="md-content__inner md-typeset {{ class }}">
       {% block content %}

From d61f10006bad7c9e65a7b3305fe615a81df5db7d Mon Sep 17 00:00:00 2001
From: 0xlukem <lucas.malizia27@gmail.com>
Date: Mon, 23 Feb 2026 14:36:16 -0300
Subject: [PATCH 3/4] fix styling

---
 material-overrides/assets/stylesheets/kluster.css | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/material-overrides/assets/stylesheets/kluster.css b/material-overrides/assets/stylesheets/kluster.css
index e3d5fb3f..ffd32931 100644
--- a/material-overrides/assets/stylesheets/kluster.css
+++ b/material-overrides/assets/stylesheets/kluster.css
@@ -695,6 +695,11 @@ input.md-search__input[placeholder="Search"]::placeholder {
   }
 }
 
+/* --- Breadcrumbs --- */
+.md-path__item:not(:first-child) {
+  align-items: center;
+}
+
 /* --- Page actions --- */
 .page-actions {
   display: flex;
@@ -1268,4 +1273,4 @@ pre:hover > .md-code__nav {
 /* --- Cookie Consent --- */
 .md-consent__inner {
   background-color: var(--consent-bg-color);
-}
\ No newline at end of file
+}

From d68aaabf185f6c3685046219ce3d358c205ddf6e Mon Sep 17 00:00:00 2001
From: 0xlukem <lucas.malizia27@gmail.com>
Date: Tue, 24 Feb 2026 11:45:19 -0300
Subject: [PATCH 4/4] fix

---
 material-overrides/assets/stylesheets/kluster.css |  5 +++++
 material-overrides/partials/path.html             | 15 +++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 material-overrides/partials/path.html

diff --git a/material-overrides/assets/stylesheets/kluster.css b/material-overrides/assets/stylesheets/kluster.css
index ffd32931..c7535d9e 100644
--- a/material-overrides/assets/stylesheets/kluster.css
+++ b/material-overrides/assets/stylesheets/kluster.css
@@ -700,6 +700,11 @@ input.md-search__input[placeholder="Search"]::placeholder {
   align-items: center;
 }
 
+.md-path__link:hover {
+  color: var(--md-typeset-a-color);
+  text-decoration: underline;
+}
+
 /* --- Page actions --- */
 .page-actions {
   display: flex;
diff --git a/material-overrides/partials/path.html b/material-overrides/partials/path.html
new file mode 100644
index 00000000..0d2c1b31
--- /dev/null
+++ b/material-overrides/partials/path.html
@@ -0,0 +1,15 @@
+{% import "partials/path-item.html" as item with context %}
+{% set hidden = "" %}
+{% if page.meta and page.meta.hide %}
+  {% set hidden = "hidden" if "path" in page.meta.hide %}
+{% endif %}
+{% set depth = page.ancestors | length %}
+{% if depth > 0 %}
+  <nav class="md-path" aria-label="{{ lang.t('nav') }}" {{ hidden }}>
+    <ol class="md-path__list">
+      {% for nav_item in page.ancestors | reverse %}
+        {{ item.render(nav_item) }}
+      {% endfor %}
+    </ol>
+  </nav>
+{% endif %}
\ No newline at end of file