From 91590a5cf57bdb13aefe95c397814423dd247f7e Mon Sep 17 00:00:00 2001
From: Kristin Brown <kristin.brown@solo.io>
Date: Thu, 6 Aug 2026 09:46:12 -0400
Subject: [PATCH 1/3] Fixed Docs being bigger than other top nav options

Signed-off-by: Kristin Brown <kristin.brown@solo.io>
---
 docs-site/assets/css/custom.css | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs-site/assets/css/custom.css b/docs-site/assets/css/custom.css
index 1be553e0..036358a5 100644
--- a/docs-site/assets/css/custom.css
+++ b/docs-site/assets/css/custom.css
@@ -446,6 +446,21 @@ h6 {
   border-color: rgba(255, 255, 255, 0.1);
 }
 
+/* ── Top-nav dropdown toggle font size (Docs) ──────────────────────────
+   Hextra renders the Docs item as a <button class="hextra-nav-menu-toggle">
+   instead of an <a>, since it has child entries. Browsers don't apply the
+   inherited hx:text-sm sizing to <button> the same way they do to <a>, so
+   Docs renders larger than its sibling nav links. docs-theme-extras ships
+   an equivalent fix, but only for the .dropdown > button/a markup pattern
+   used by kgateway/agentgateway-oss' custom navbar, not Hextra's native
+   .hextra-nav-menu-toggle markup used here, so it doesn't reach this case. */
+.hextra-nav-menu-toggle {
+  font-family: inherit;
+  font-size: 0.875rem; /* match hx:text-sm on sibling nav links */
+  font-weight: 400;
+  line-height: 1.25rem;
+}
+
 /* Dropdown item spacing lives here, NOT in hx: utility classes: ad-hoc hx:
    spacing values (gap-3, px-4, py-2.5, …) that Hextra core doesn't already use
    are not generated in this Tailwind build, so they silently no-op. */

From c8a32369240f9aeac01ce8718db5ccf0118b32aa Mon Sep 17 00:00:00 2001
From: Kristin Brown <kristin.brown@solo.io>
Date: Thu, 6 Aug 2026 09:52:53 -0400
Subject: [PATCH 2/3] Revised comment

Signed-off-by: Kristin Brown <kristin.brown@solo.io>
---
 docs-site/assets/css/custom.css | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/docs-site/assets/css/custom.css b/docs-site/assets/css/custom.css
index 036358a5..c171488f 100644
--- a/docs-site/assets/css/custom.css
+++ b/docs-site/assets/css/custom.css
@@ -22,11 +22,11 @@
     border-bottom-color: #374151;
 }
 
-/* Theme-toggle icon visibility — explicit fallback for the Tailwind v4
-   hx:group-data-[theme=*]:hidden variant.  The v4 rule uses :is()/:where()
+/* -toggle icon visibility — explicit fallback for the Tailwind v4
+   hx:group-data-[=*]:hidden variant.  The v4 rule uses :is()/:where()
    which can lose the battle against Tailwind v3's svg{display:block} preflight
    when both pipelines run.  This direct descendant selector with !important
-   guarantees only the current-theme icon renders. */
+   guarantees only the current- icon renders. */
 .hx\:group[data-theme="light"]  .hx\:group-data-\[theme\=light\]\:hidden,
 .hx\:group[data-theme="dark"]   .hx\:group-data-\[theme\=dark\]\:hidden,
 .hx\:group[data-theme="system"] .hx\:group-data-\[theme\=system\]\:hidden {
@@ -450,10 +450,7 @@ h6 {
    Hextra renders the Docs item as a <button class="hextra-nav-menu-toggle">
    instead of an <a>, since it has child entries. Browsers don't apply the
    inherited hx:text-sm sizing to <button> the same way they do to <a>, so
-   Docs renders larger than its sibling nav links. docs-theme-extras ships
-   an equivalent fix, but only for the .dropdown > button/a markup pattern
-   used by kgateway/agentgateway-oss' custom navbar, not Hextra's native
-   .hextra-nav-menu-toggle markup used here, so it doesn't reach this case. */
+   Docs renders larger than its sibling nav links. */
 .hextra-nav-menu-toggle {
   font-family: inherit;
   font-size: 0.875rem; /* match hx:text-sm on sibling nav links */

From 759ca9a012c936809a8b6a5142a0120fa0d78616 Mon Sep 17 00:00:00 2001
From: Kristin Brown <kristin.brown@solo.io>
Date: Thu, 6 Aug 2026 09:53:47 -0400
Subject: [PATCH 3/3] Clarify theme-toggle icon visibility comments

Updated comments for clarity regarding theme-toggle icon visibility and Tailwind CSS compatibility.

Signed-off-by: Kristin Brown <kristin.brown@solo.io>
---
 docs-site/assets/css/custom.css | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs-site/assets/css/custom.css b/docs-site/assets/css/custom.css
index c171488f..d0f350b2 100644
--- a/docs-site/assets/css/custom.css
+++ b/docs-site/assets/css/custom.css
@@ -22,11 +22,11 @@
     border-bottom-color: #374151;
 }
 
-/* -toggle icon visibility — explicit fallback for the Tailwind v4
-   hx:group-data-[=*]:hidden variant.  The v4 rule uses :is()/:where()
+/* Theme-toggle icon visibility — explicit fallback for the Tailwind v4
+   hx:group-data-[theme=*]:hidden variant.  The v4 rule uses :is()/:where()
    which can lose the battle against Tailwind v3's svg{display:block} preflight
    when both pipelines run.  This direct descendant selector with !important
-   guarantees only the current- icon renders. */
+   guarantees only the current-theme icon renders. */
 .hx\:group[data-theme="light"]  .hx\:group-data-\[theme\=light\]\:hidden,
 .hx\:group[data-theme="dark"]   .hx\:group-data-\[theme\=dark\]\:hidden,
 .hx\:group[data-theme="system"] .hx\:group-data-\[theme\=system\]\:hidden {