From 320f6d8c104a689b3ff5f1fd85231b988618dc8f Mon Sep 17 00:00:00 2001
From: Carlos Granados <barel.barelon@gmail.com>
Date: Sat, 5 Sep 2026 08:57:26 +0200
Subject: [PATCH 1/3] fix navbar links and home page hero spacing

---
 docusaurus.config.js                      | 6 +++---
 src/components/HomeHero/styles.module.css | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docusaurus.config.js b/docusaurus.config.js
index 4fc1f50..e9d813f 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -118,7 +118,7 @@ const config = {
             position: 'left',
           },
           {
-            to: '/user-guide/breakpoints',
+            to: '/user-guide/starting-the-debugger',
             label: 'Guide',
             position: 'left',
           },
@@ -128,8 +128,8 @@ const config = {
             position: 'left',
           },
           {
-            to: '/reference/debug-protocol',
-            label: 'API',
+            to: '/integrations/ide-support',
+            label: 'Integrations',
             position: 'left',
           },
           {
diff --git a/src/components/HomeHero/styles.module.css b/src/components/HomeHero/styles.module.css
index e8672b1..eda052d 100644
--- a/src/components/HomeHero/styles.module.css
+++ b/src/components/HomeHero/styles.module.css
@@ -3,7 +3,7 @@
   grid-template-columns: minmax(0, 5fr) minmax(0, 7fr);
   gap: 3rem;
   align-items: center;
-  padding: 2rem 0 3rem;
+  padding: 0 0 3rem;
 }
 
 .heroText {

From a4749472eef9ba9f8f2af4352dea549d882b2891 Mon Sep 17 00:00:00 2001
From: Carlos Granados <barel.barelon@gmail.com>
Date: Sat, 5 Sep 2026 09:02:45 +0200
Subject: [PATCH 2/3] remove the mobile hero top padding too

---
 src/components/HomeHero/styles.module.css | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/components/HomeHero/styles.module.css b/src/components/HomeHero/styles.module.css
index eda052d..96364ef 100644
--- a/src/components/HomeHero/styles.module.css
+++ b/src/components/HomeHero/styles.module.css
@@ -121,7 +121,6 @@
   .hero {
     grid-template-columns: minmax(0, 1fr);
     gap: 2rem;
-    padding-top: 1rem;
   }
 
   .title {

From 47cf25d34407be9f31539ac044ae50649850c836 Mon Sep 17 00:00:00 2001
From: Carlos Granados <barel.barelon@gmail.com>
Date: Sat, 5 Sep 2026 09:33:57 +0200
Subject: [PATCH 3/3] stop the navbar logo and install bar overflowing on
 narrow screens

---
 src/components/InstallCommand/styles.module.css |  4 +++-
 src/css/custom.css                              | 16 ++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/components/InstallCommand/styles.module.css b/src/components/InstallCommand/styles.module.css
index db8e60b..b76c903 100644
--- a/src/components/InstallCommand/styles.module.css
+++ b/src/components/InstallCommand/styles.module.css
@@ -4,6 +4,7 @@
 
 .tabs {
   display: flex;
+  flex-wrap: wrap;
   gap: 0.25rem;
 }
 
@@ -34,7 +35,8 @@
   display: flex;
   align-items: center;
   justify-content: space-between;
-  gap: 1rem;
+  flex-wrap: wrap;
+  gap: 0.5rem 1rem;
   margin-bottom: 0.5rem;
 }
 
diff --git a/src/css/custom.css b/src/css/custom.css
index 9dc2a16..3a60cbe 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -75,6 +75,22 @@
   margin-right: 2rem;
 }
 
+/* The lockup is 4.5:1, so a fixed 4rem height makes it 288px wide -- wider than
+   the room left beside the hamburger and search on a small phone, which pushed
+   the whole document sideways. Below the navbar's own breakpoint let the width
+   lead and the height follow, so it shrinks to fit instead of overflowing. */
+@media (max-width: 996px) {
+  .navbar__brand {
+    margin-right: 0.5rem;
+  }
+
+  .navbar__logo {
+    height: auto;
+    max-height: 4rem;
+    max-width: 55vw;
+  }
+}
+
 
 .navbar__link {
   font-weight: 500;