From ad47d664de4345641a0c7cf1256e510d2846c562 Mon Sep 17 00:00:00 2001
From: Harsh <harshmastic@gmail.com>
Date: Mon, 6 Oct 2025 13:36:39 +0530
Subject: [PATCH 1/2] fix: update button font size and padding to prevent
 overlap

---
 src/components/Dropdown/styles.module.scss    |  8 +++-
 src/components/PageHeader/HomePage.astro      |  4 +-
 .../ReferenceDirectoryWithFilter/index.tsx    | 40 ++++++++++---------
 styles/global.scss                            | 18 +++++----
 4 files changed, 41 insertions(+), 29 deletions(-)

diff --git a/src/components/Dropdown/styles.module.scss b/src/components/Dropdown/styles.module.scss
index b2a1612608..05ea8cdf23 100644
--- a/src/components/Dropdown/styles.module.scss
+++ b/src/components/Dropdown/styles.module.scss
@@ -113,7 +113,13 @@ button.chevron {
 .option > button > span {
   text-align: left;
   padding-left: 44px;
-  padding-right: 10px;
+  padding-right: 38px;
   display: inline-block;
   width: 100%;
+  font-size: 0.75rem;
+
+  @media (min-width: $breakpoint-tablet) {
+    font-size: 1rem;
+    padding-right: 10px;
+  }
 }
diff --git a/src/components/PageHeader/HomePage.astro b/src/components/PageHeader/HomePage.astro
index cd81ec7883..80784886ee 100644
--- a/src/components/PageHeader/HomePage.astro
+++ b/src/components/PageHeader/HomePage.astro
@@ -12,13 +12,13 @@ const { config } = Astro.props;
 
 <div class="px-lg pt-5xl lg:pt-3xl pb-0 h-full">
   <div class="homepage-header-top">
-    <div class="grid grid-cols-3 lg:grid-cols-4 gap-md overflow-hidden h-min">
+    <div class="grid grid-cols-3 lg:grid-cols-4 gap-md overflow-visible h-min">
       <p class="col-span-2 lg:col-span-3 mt-0 text-md md:text-xl lg:text-3xl">
         {config.data.heroText}
       </p>
       <Icon
         kind="asterisk-thick"
-        className="col-span-1 motion-safe:animate-spin-slow text-logo-color h-full max-w-full max-h-[200px]"
+        className="col-span-1 motion-safe:animate-spin-slow text-logo-color h-full max-w-full max-h-[80px] md:max-h-[120px] lg:max-h-[200px]"
       />
     </div>
     {
diff --git a/src/components/ReferenceDirectoryWithFilter/index.tsx b/src/components/ReferenceDirectoryWithFilter/index.tsx
index a339859b42..5ce59bcd73 100644
--- a/src/components/ReferenceDirectoryWithFilter/index.tsx
+++ b/src/components/ReferenceDirectoryWithFilter/index.tsx
@@ -2,8 +2,8 @@ import type { ReferenceDocContentItem } from "@/src/content/types";
 import { useMemo, useRef, useState } from "preact/hooks";
 import { type JSX } from "preact";
 import { Icon } from "../Icon";
-import flask from "@src/content/ui/images/icons/flask.svg?raw"; 
-import warning from "@src/content/ui/images/icons/warning.svg?raw"; 
+import flask from "@src/content/ui/images/icons/flask.svg?raw";
+import warning from "@src/content/ui/images/icons/warning.svg?raw";
 
 type ReferenceDirectoryEntry = ReferenceDocContentItem & {
   data: {
@@ -41,14 +41,14 @@ type ReferenceDirectoryWithFilterProps = {
 const getOneLineDescription = (description: string): string => {
   // Matches first paragraph tag, remove HTML tags, then trim to first fullstop
   const firstParagraphRegex = /^<p>(.*?)<\/p>/;
-  let [oneLineDescription] = description.replace(/\n/g, " ").trim()
-    .match(firstParagraphRegex) ?? [];
+  let [oneLineDescription] =
+    description.replace(/\n/g, " ").trim().match(firstParagraphRegex) ?? [];
 
   if (!oneLineDescription && description) {
     oneLineDescription = description;
   }
 
-  if(oneLineDescription){
+  if (oneLineDescription) {
     oneLineDescription = oneLineDescription
       .replace(/^<p>|<\/p>$/g, "")
       .replace(/<\/?code>/g, "")
@@ -80,11 +80,13 @@ export const ReferenceDirectoryWithFilter = ({
           );
           if (
             subcat.entry &&
-            subcat.entry.data.title.toLowerCase().includes(searchKeyword.toLowerCase())
+            subcat.entry.data.title
+              .toLowerCase()
+              .includes(searchKeyword.toLowerCase())
           ) {
             filteredEntries.push(subcat.entry);
           }
-          
+
           if (filteredEntries.length > 0) {
             subAcc.push({ ...subcat, entries: filteredEntries });
           }
@@ -111,18 +113,16 @@ export const ReferenceDirectoryWithFilter = ({
               aria-label={entry.data.title}
               aria-describedby={`${entry.data.title}-description`}
             >
-              <span
-                class="text-body-mono group-hover:underline"
-              >
+              <span class="text-body-mono group-hover:underline">
                 {entry.data.beta && (
                   <div
-                    className="inline-block mr-2 w-[16px] h-[16px] mb-[-2px]"
+                    className="mb-[-2px] mr-2 inline-block h-[16px] w-[16px]"
                     dangerouslySetInnerHTML={{ __html: flask }}
                   />
                 )}
                 {entry.data.deprecated && (
                   <div
-                    className="inline-block mr-2 w-[16px] h-[16px] mb-[-2px]"
+                    className="mb-[-2px] mr-2 inline-block h-[16px] w-[16px]"
                     dangerouslySetInnerHTML={{ __html: warning }}
                   />
                 )}
@@ -143,7 +143,7 @@ export const ReferenceDirectoryWithFilter = ({
     category: { name: string },
   ) => {
     return !(!subcat.name || !category.name);
-  }
+  };
 
   const getSubcatHeading = (
     subcat: { name: string; entry?: any },
@@ -207,7 +207,7 @@ export const ReferenceDirectoryWithFilter = ({
   return (
     <div>
       <div class="h-0 overflow-visible">
-        <div class="content-grid-simple absolute -top-[75px] -left-0 -right-0 h-[75px] border-b border-sidebar-type-color bg-accent-color px-5 pb-lg md:px-lg ">
+        <div class="content-grid-simple absolute -left-0 -right-0 -top-[60px] h-[75px] border-b border-sidebar-type-color bg-accent-color px-5 pb-lg md:px-lg ">
           <div class="text-body col-span-2 flex w-full max-w-[750px] border-b border-accent-type-color text-accent-type-color">
             <input
               type="text"
@@ -221,10 +221,14 @@ export const ReferenceDirectoryWithFilter = ({
               }}
             />
             {searchKeyword.length > 0 && (
-            <button type="reset" class="" onClick={clearInput} aria-label="Clear search input">
-          <Icon kind="close" className="h-4 w-4" />
-        </button>
-
+              <button
+                type="reset"
+                class=""
+                onClick={clearInput}
+                aria-label="Clear search input"
+              >
+                <Icon kind="close" className="h-4 w-4" />
+              </button>
             )}
           </div>
         </div>
diff --git a/styles/global.scss b/styles/global.scss
index facdfac4c2..c236366316 100644
--- a/styles/global.scss
+++ b/styles/global.scss
@@ -126,7 +126,7 @@ h4 {
     font-size: 1.5rem;
     line-height: 1.1333;
     -webkit-text-stroke-width: 0.15px;
-  } 
+  }
 }
 
 .text-body-large {
@@ -291,7 +291,9 @@ pre.code-box,
   white-space: break-spaces;
 }
 
-.callout, .experimental, .deprecated {
+.callout,
+.experimental,
+.deprecated {
   padding: var(--spacing-sm);
   border-radius: 20px;
   background-color: var(--bg-magenta-20);
@@ -308,7 +310,8 @@ pre.code-box,
   }
 }
 
-.experimental, .deprecated {
+.experimental,
+.deprecated {
   background-color: var(--bg-yellow);
 }
 
@@ -382,8 +385,7 @@ pre.code-box,
       justify-content: space-between;
 
       // 43px is the height of the top mobile bar menu
-      height: calc(50vh - var(--spacing-5xl) - 43px);
-      max-height: calc(50vh - var(--spacing-5xl) - 43px);
+      min-height: calc(50vh - var(--spacing-5xl) - 43px);
 
       @media (min-width: $breakpoint-tablet) {
         height: calc(50vh - var(--spacing-5xl));
@@ -515,8 +517,8 @@ input[type="search"]::-webkit-search-results-decoration {
   display: -webkit-box; // Needs webkit box to support line-clamp
 }
 
-.dark-theme.monochrome-theme .renderable-alt{
-  color: var(--type-black); 
+.dark-theme.monochrome-theme .renderable-alt {
+  color: var(--type-black);
 }
 
 .skip-to-main {
@@ -544,4 +546,4 @@ input[type="search"]::-webkit-search-results-decoration {
 body {
   --donate-banner-dark: #c01c4c;
   --donate-banner-background: var(--donate-p5-background);
-}
\ No newline at end of file
+}

From cdc51c4688393b0d07a5163f499f00aa97c1da34 Mon Sep 17 00:00:00 2001
From: Harsh <harshmastic@gmail.com>
Date: Mon, 6 Oct 2025 14:10:46 +0530
Subject: [PATCH 2/2] fix: add comments for better understanding of padding and
 font size adjustments

---
 src/components/Dropdown/styles.module.scss | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/components/Dropdown/styles.module.scss b/src/components/Dropdown/styles.module.scss
index 05ea8cdf23..51845a263e 100644
--- a/src/components/Dropdown/styles.module.scss
+++ b/src/components/Dropdown/styles.module.scss
@@ -113,9 +113,11 @@ button.chevron {
 .option > button > span {
   text-align: left;
   padding-left: 44px;
+  // 38px padding-right holds the chevron icon on mobile for better touch targets
   padding-right: 38px;
   display: inline-block;
   width: 100%;
+  // 0.75rem font-size for mobile to fit content in smaller screens
   font-size: 0.75rem;
 
   @media (min-width: $breakpoint-tablet) {