fix: fix theme button overlap and keep "What is Kubestellar?" dropdown open (#319)

* fix : Enhance sidebar behavior

Signed-off-by: Khushi Agrawal <[email protected]>

* fix : Enhance sidebar behavior

Signed-off-by: Khushi Agrawal <[email protected]>

* refactor: Simplify CSS calculations for sticky sidebar positioning

---------

Signed-off-by: Khushi Agrawal <[email protected]>

Author: khushiiagrawal

src/app/docs/page-map.ts

@@ -56,7 +56,7 @@ export async function buildPageMapForBranch(branch: string) {
 
   // Strong types for page-map nodes (no `any`)
   type MdxPageNode = { kind: 'MdxPage'; name: string; route: string }
-  type FolderNode = { kind: 'Folder'; name: string; route: string; children: PageMapNode[] }
+type FolderNode = { kind: 'Folder'; name: string; route: string; children: PageMapNode[]; theme?: { collapsed?: boolean } }
   type MetaNode = { kind: 'Meta'; data: Record<string, string> }
   type PageMapNode = MdxPageNode | FolderNode | MetaNode
 
@@ -238,7 +238,18 @@ export async function buildPageMapForBranch(branch: string) {
 
     if (!children.length) continue
 
-    _pageMap.push({ kind: 'Folder', name: categoryName, route: `/${basePath}/${categorySlug}`, children })
+    const folderNode: FolderNode & { theme?: { collapsed?: boolean } } = {
+      kind: 'Folder',
+      name: categoryName,
+      route: `/${basePath}/${categorySlug}`,
+      children
+    }
+
+    if (categoryName.toLowerCase().startsWith('what is kubestellar')) {
+      folderNode.theme = { collapsed: false }
+    }
+
+    _pageMap.push(folderNode)
   }
 
   const remainingFiles = allDocFiles.filter(fp => {

src/app/globals.css

@@ -81,6 +81,17 @@ html:not(.dark) .nextra-docs-theme .nextra-sidebar-container {
   height: 100%;
 }
 
+/* Ensure sticky sidebar offsets respect banner height */
+.nextra-sidebar {
+  top: calc(
+    var(--nextra-navbar-height, 4rem) + var(--nextra-banner-height, 0px)
+  ) !important;
+  height: calc(
+    100dvh - var(--nextra-navbar-height, 4rem) -
+      var(--nextra-banner-height, 0px)
+  ) !important;
+}
+
 /* Make the navigation list scrollable with proper padding at bottom */
 .nextra-sidebar-container nav {
   flex: 1;