From 98c4e9183744f015d524caf3e3fd7f0ba4555406 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Wed, 8 Jul 2026 18:58:30 -0400
Subject: [PATCH 01/10] feat(docs): replace Algolia search with MiniSearch

---
 package-lock.json                             |  17 +-
 packages/stacks-docs/package.json             |   3 +-
 packages/stacks-docs/src/app.css              |   9 -
 packages/stacks-docs/src/app.d.ts             |   9 +
 .../stacks-docs/src/components/Search.svelte  | 247 ++++++++++++++----
 .../stacks-docs/src/routes/+layout.server.ts  |  37 +++
 .../stacks-docs/src/routes/+layout.svelte     |   2 +-
 7 files changed, 252 insertions(+), 72 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index a4e63cd1f5..3acfdd1291 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -597,14 +597,6 @@
                 "node": ">=14.17.0"
             }
         },
-        "node_modules/@docsearch/css": {
-            "version": "4.6.0",
-            "license": "MIT"
-        },
-        "node_modules/@docsearch/js": {
-            "version": "4.6.0",
-            "license": "MIT"
-        },
         "node_modules/@emnapi/core": {
             "version": "1.9.2",
             "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.9.2.tgz",
@@ -9431,6 +9423,12 @@
                 "url": "https://github.com/sponsors/isaacs"
             }
         },
+        "node_modules/minisearch": {
+            "version": "7.2.0",
+            "resolved": "https://registry.npmjs.org/minisearch/-/minisearch-7.2.0.tgz",
+            "integrity": "sha512-dqT2XBYUOZOiC5t2HRnwADjhNS2cecp9u+TJRiJ1Qp/f5qjkeT5APcGPjHw+bz89Ms8Jp+cG4AlE+QZ/QnDglg==",
+            "license": "MIT"
+        },
         "node_modules/mitt": {
             "version": "3.0.1",
             "dev": true,
@@ -15709,8 +15707,6 @@
         "packages/stacks-docs": {
             "name": "@stackoverflow/stacks-docs",
             "dependencies": {
-                "@docsearch/css": "^4.3.2",
-                "@docsearch/js": "^4.3.2",
                 "@hbsnow/rehype-sectionize": "^1.0.7",
                 "@stackoverflow/stacks": "*",
                 "@stackoverflow/stacks-editor": "*",
@@ -15720,6 +15716,7 @@
                 "@stefanprobst/rehype-extract-toc": "^3.0.0",
                 "better-auth": "^1.6.11",
                 "highlight.js": "^11.11.1",
+                "minisearch": "^7.2.0",
                 "rehype-autolink-headings": "^7.1.0",
                 "rehype-slug": "^6.0.0",
                 "turndown": "^7.2.2",
diff --git a/packages/stacks-docs/package.json b/packages/stacks-docs/package.json
index 207acf7f3f..ebdadde79d 100644
--- a/packages/stacks-docs/package.json
+++ b/packages/stacks-docs/package.json
@@ -23,8 +23,6 @@
         "vite": "^7.3.3"
     },
     "dependencies": {
-        "@docsearch/css": "^4.3.2",
-        "@docsearch/js": "^4.3.2",
         "@hbsnow/rehype-sectionize": "^1.0.7",
         "@stackoverflow/stacks": "*",
         "@stackoverflow/stacks-editor": "*",
@@ -34,6 +32,7 @@
         "@stefanprobst/rehype-extract-toc": "^3.0.0",
         "better-auth": "^1.6.11",
         "highlight.js": "^11.11.1",
+        "minisearch": "^7.2.0",
         "rehype-autolink-headings": "^7.1.0",
         "rehype-slug": "^6.0.0",
         "turndown": "^7.2.2",
diff --git a/packages/stacks-docs/src/app.css b/packages/stacks-docs/src/app.css
index 7d3f7fc100..73276ca4e0 100644
--- a/packages/stacks-docs/src/app.css
+++ b/packages/stacks-docs/src/app.css
@@ -608,12 +608,3 @@ h1 {
 .hmn6 .s-editor-resizable {
     min-height: var(--su640) !important;
 }
-
-/* Agolia Docsearch */
-
-.DocSearch-Container {
-    z-index: 9999 !important;
-}
-.DocSearch-Footer {
-    margin: 0;
-}
diff --git a/packages/stacks-docs/src/app.d.ts b/packages/stacks-docs/src/app.d.ts
index 8b9d7c7948..78df67cef0 100644
--- a/packages/stacks-docs/src/app.d.ts
+++ b/packages/stacks-docs/src/app.d.ts
@@ -32,6 +32,14 @@ declare global {
         [key: string]: unknown;
     };
 
+    type DocsSearchDocument = {
+        id: string;
+        title: string;
+        description: string;
+        path: string;
+        text: string;
+    };
+
     namespace App {
         interface Locals {
             session?: unknown;
@@ -47,6 +55,7 @@ declare global {
             markdown?: string | null;
             metadata?: DocsMetadata | null;
             needsAuth?: boolean;
+            searchDocuments?: DocsSearchDocument[];
             source?: string | null;
             structure?: { navigation?: DocsNavItem[] };
             [key: string]: unknown;
diff --git a/packages/stacks-docs/src/components/Search.svelte b/packages/stacks-docs/src/components/Search.svelte
index 66e2707fe3..e1ace62d78 100644
--- a/packages/stacks-docs/src/components/Search.svelte
+++ b/packages/stacks-docs/src/components/Search.svelte
@@ -1,52 +1,199 @@
-<script>
-	import { untrack } from 'svelte';
-	import docsearch from '@docsearch/js';
-	import '@docsearch/css';
-
-	import { env } from '$env/dynamic/public';
-
-	import { Button, Icon } from '@stackoverflow/stacks-svelte';
-	import { IconSearch } from '@stackoverflow/stacks-icons';
-
-	let docSearchButton = $state();
-
-	// Check if all required env vars are available
-	const searchEnabled = env.PUBLIC_ALGOLIA_APP_ID && env.PUBLIC_ALGOLIA_API_KEY && env.PUBLIC_ALGOLIA_INDEX_NAME;
-
-	$effect(() => {
-		if (!searchEnabled) return;
-
-		const container = document.createElement('div');
-		container.style.display = 'none';
-		document.body.appendChild(container);
-
-		try {
-			docsearch({
-				container,
-				appId: env.PUBLIC_ALGOLIA_APP_ID,
-				apiKey: env.PUBLIC_ALGOLIA_API_KEY,
-				indexName: env.PUBLIC_ALGOLIA_INDEX_NAME,
-			});
-
-			// Store reference to the DocSearch button
-			docSearchButton = untrack(() => container.querySelector('.DocSearch-Button'));
-		} catch (error) {
-			console.warn('Search initialization failed:', error);
-		}
-
-		return () => {
-			container.remove();
-		};
-	});
-
-	function openSearch() {
-		docSearchButton?.click();
-	}
+<script lang="ts">
+    import { tick } from "svelte";
+    import MiniSearch, { type SearchResult } from "minisearch";
+
+    import {
+        Button,
+        EmptyState,
+        Icon,
+        Menu,
+        MenuItem,
+        Modal,
+    } from "@stackoverflow/stacks-svelte";
+    import { IconSearch } from "@stackoverflow/stacks-icons";
+
+    let { searchDocuments = [] }: { searchDocuments?: DocsSearchDocument[] } =
+        $props();
+
+    let searchInput = $state<HTMLInputElement>();
+    let isOpen = $state(false);
+    let query = $state("");
+
+    const miniSearch = $derived.by(() => {
+        const search = new MiniSearch<DocsSearchDocument>({
+            fields: ["title", "description", "text"],
+            storeFields: ["title", "description", "path"],
+            searchOptions: {
+                boost: { title: 3, description: 2 },
+                fuzzy: 0.2,
+                prefix: true,
+            },
+        });
+
+        search.addAll(searchDocuments);
+        return search;
+    });
+
+    const results = $derived.by(() => {
+        const trimmedQuery = query.trim();
+        if (!trimmedQuery) return [];
+
+        return miniSearch.search(trimmedQuery).slice(0, 8) as Array<
+            SearchResult &
+                Pick<DocsSearchDocument, "title" | "description" | "path">
+        >;
+    });
+
+    const hasQuery = $derived(query.trim().length > 0);
+
+    $effect(() => {
+        if (!isOpen) return;
+
+        tick().then(() => searchInput?.focus());
+    });
+
+    function toggleSearch() {
+        isOpen = !isOpen;
+    }
+
+    function closeSearch() {
+        isOpen = false;
+        query = "";
+    }
+
+    function handleWindowKeydown(event: KeyboardEvent) {
+        if (
+            (event.metaKey || event.ctrlKey) &&
+            event.key.toLowerCase() === "k"
+        ) {
+            event.preventDefault();
+            toggleSearch();
+        }
+    }
+
+    async function handleSearchInputKeydown(event: KeyboardEvent) {
+        if (event.key !== "ArrowDown" || !results.length) return;
+
+        event.preventDefault();
+        await tick();
+
+        getResultActions()[0]?.focus();
+    }
+
+    function handleResultKeydown(event: KeyboardEvent, index: number) {
+        if (event.key === "ArrowDown") {
+            event.preventDefault();
+            focusResult(index + 1);
+            return;
+        }
+
+        if (event.key !== "ArrowUp") return;
+
+        event.preventDefault();
+
+        if (index === 0) {
+            searchInput?.focus();
+            return;
+        }
+
+        focusResult(index - 1);
+    }
+
+    function focusResult(index: number) {
+        const result = getResultActions()[index];
+        result?.focus();
+        result?.scrollIntoView({ block: "nearest" });
+    }
+
+    function getResultActions() {
+        return Array.from(
+            document.querySelectorAll<HTMLElement>(
+                "#docs-search-description .s-menu--action"
+            )
+        );
+    }
 </script>
 
-{#if searchEnabled}
-	<Button icon weight="clear" class="h:fc-blue-400 px0" onclick={openSearch}>
-		<Icon src={IconSearch} />
-		<span class="v-visible-sr">Search</span>
-	</Button>
-{/if}
+<svelte:window onkeydown={handleWindowKeydown} />
+
+<Button icon weight="clear" class="s-btn__xs mrn6 px6 h:fc-blue-400" onclick={toggleSearch}>
+    <Icon src={IconSearch} />
+    <span class="v-visible-sr">Search</span>
+</Button>
+
+<Modal
+    id="docs-search"
+    visible={isOpen}
+    class="search-modal d-flex fd-column w100 wmx5 hs5 hmx-screen overflow-hidden pb0"
+    i18nCloseButtonLabel="Close search"
+    onclose={closeSearch}
+>
+    {#snippet header()}
+        Search documentation
+    {/snippet}
+
+    {#snippet body()}
+        <div class="d-flex ai-center bb bc-black-200 mxn4 px4 pt4 pb16">
+            <input
+                bind:this={searchInput}
+                bind:value={query}
+                class="s-input"
+                placeholder="Search documentation..."
+                aria-label="Search documentation"
+                onkeydown={handleSearchInputKeydown}
+            />
+        </div>
+
+        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 py8">
+            {#if results.length}
+                <Menu class="m0">
+                    {#each results as result, index (result.id)}
+                        <MenuItem
+                            href={result.path}
+                            onclick={closeSearch}
+                            onkeydown={(event) => handleResultKeydown(event, index)}
+                        >
+                            <span class="d-block fw-bold mb2">{result.title}</span>
+                            {#if result.description}
+                                <span class="d-block fs-caption truncate fc-black-500 lh-md"
+                                    >{result.description}</span
+                                >
+                            {/if}
+                            <span class="d-block fs-fine fc-black-400 mt4"
+                                >{result.path}</span
+                            >
+                        </MenuItem>
+                    {/each}
+                </Menu>
+            {:else if hasQuery}
+                <EmptyState title="No results found" class="p24">
+                    {#snippet description()}
+                        Try a different search term.
+                    {/snippet}
+                </EmptyState>
+            {:else}
+                <p class="m0 p12 fs-body1 fc-black-500">
+                    Search components, guidelines, and foundations.
+                </p>
+            {/if}
+        </div>
+    {/snippet}
+</Modal>
+
+<style>
+    :global(#docs-search-description) {
+        display: flex;
+        flex-direction: column;
+        margin-bottom: 0;
+        min-height: 0;
+        overflow: hidden;
+    }
+
+    .search-results {
+        min-height: 0;
+    }
+
+    .search-results :global(.s-menu--action) {
+        display: block;
+    }
+</style>
diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index df4ac8a57c..481adc209d 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -1,7 +1,17 @@
 import type { LayoutServerLoad } from "./$types";
+import type { Component } from "svelte";
+import { render } from "svelte/server";
+import TurndownService from "turndown";
 import YAML from "yaml";
 import structureRaw from "$src/structure.yaml?raw";
 
+const mdFiles = import.meta.glob("$docs/public/**/*.md");
+
+const turndownService = new TurndownService({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+});
+
 type NavItem = {
     slug: string;
     title?: string;
@@ -29,6 +39,32 @@ function findByPath(
     return "slug" in currentLevel ? currentLevel : undefined;
 }
 
+function getSearchPath(filePath: string): string {
+    return filePath
+        .replace("/src/docs/public/", "/")
+        .replace(/\/index\.md$/, "/")
+        .replace(/\.md$/, "");
+}
+
+async function getSearchDocuments(): Promise<DocsSearchDocument[]> {
+    return Promise.all(
+        Object.entries(mdFiles).map(async ([path, doc]) => {
+            const page = (await doc()) as {
+                default: Component;
+                metadata: DocsMetadata;
+            };
+
+            return {
+                id: path,
+                title: page.metadata?.title ?? getSearchPath(path),
+                description: page.metadata?.description ?? "",
+                path: getSearchPath(path),
+                text: turndownService.turndown(render(page.default).body),
+            };
+        })
+    );
+}
+
 export const load: LayoutServerLoad = async (event) => {
     // Load the navigation structure from the structure.yaml
     let structure: Structure = {};
@@ -96,5 +132,6 @@ export const load: LayoutServerLoad = async (event) => {
         active,
         breadcrumb,
         needsAuth,
+        searchDocuments: await getSearchDocuments(),
     };
 };
diff --git a/packages/stacks-docs/src/routes/+layout.svelte b/packages/stacks-docs/src/routes/+layout.svelte
index a1a40c2c8a..63461ede48 100644
--- a/packages/stacks-docs/src/routes/+layout.svelte
+++ b/packages/stacks-docs/src/routes/+layout.svelte
@@ -39,7 +39,7 @@
 			<Icon src={IconLogo} />
 		</a>
 
-		<Search />
+		<Search searchDocuments={data.searchDocuments ?? []} />
 
 		<Button class="d-none sm:d-block" onclick={() => mobileMenu = !mobileMenu} weight="clear" icon>
 			<Icon src={mobileMenu ? IconCross : IconMenu} class="fc-black" />

From e8fe3d6175656f62bfff4ec908f9bf79aee2ae7d Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 11:05:01 -0400
Subject: [PATCH 02/10] fix(docs): allow search modal body overflow

---
 packages/stacks-docs/src/components/Search.svelte | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/stacks-docs/src/components/Search.svelte b/packages/stacks-docs/src/components/Search.svelte
index e1ace62d78..f383775e71 100644
--- a/packages/stacks-docs/src/components/Search.svelte
+++ b/packages/stacks-docs/src/components/Search.svelte
@@ -186,7 +186,7 @@
         flex-direction: column;
         margin-bottom: 0;
         min-height: 0;
-        overflow: hidden;
+        overflow: visible;
     }
 
     .search-results {

From a1156e3ec5f01ca814ad87b5627c340085fa1e29 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 12:25:52 -0400
Subject: [PATCH 03/10] fix(docs): simplify search result semantics

---
 .../stacks-docs/src/components/Search.svelte  | 88 +++++--------------
 .../stacks-docs/src/routes/+layout.server.ts  |  4 +-
 2 files changed, 26 insertions(+), 66 deletions(-)

diff --git a/packages/stacks-docs/src/components/Search.svelte b/packages/stacks-docs/src/components/Search.svelte
index f383775e71..dbe1405769 100644
--- a/packages/stacks-docs/src/components/Search.svelte
+++ b/packages/stacks-docs/src/components/Search.svelte
@@ -6,8 +6,6 @@
         Button,
         EmptyState,
         Icon,
-        Menu,
-        MenuItem,
         Modal,
     } from "@stackoverflow/stacks-svelte";
     import { IconSearch } from "@stackoverflow/stacks-icons";
@@ -71,47 +69,6 @@
         }
     }
 
-    async function handleSearchInputKeydown(event: KeyboardEvent) {
-        if (event.key !== "ArrowDown" || !results.length) return;
-
-        event.preventDefault();
-        await tick();
-
-        getResultActions()[0]?.focus();
-    }
-
-    function handleResultKeydown(event: KeyboardEvent, index: number) {
-        if (event.key === "ArrowDown") {
-            event.preventDefault();
-            focusResult(index + 1);
-            return;
-        }
-
-        if (event.key !== "ArrowUp") return;
-
-        event.preventDefault();
-
-        if (index === 0) {
-            searchInput?.focus();
-            return;
-        }
-
-        focusResult(index - 1);
-    }
-
-    function focusResult(index: number) {
-        const result = getResultActions()[index];
-        result?.focus();
-        result?.scrollIntoView({ block: "nearest" });
-    }
-
-    function getResultActions() {
-        return Array.from(
-            document.querySelectorAll<HTMLElement>(
-                "#docs-search-description .s-menu--action"
-            )
-        );
-    }
 </script>
 
 <svelte:window onkeydown={handleWindowKeydown} />
@@ -133,38 +90,39 @@
     {/snippet}
 
     {#snippet body()}
-        <div class="d-flex ai-center bb bc-black-200 mxn4 px4 pt4 pb16">
+        <div class="d-flex ai-center bb bc-black-200 pb12">
             <input
                 bind:this={searchInput}
                 bind:value={query}
                 class="s-input"
                 placeholder="Search documentation..."
                 aria-label="Search documentation"
-                onkeydown={handleSearchInputKeydown}
             />
         </div>
 
         <div class="search-results fl-shrink1 overflow-auto h5 hmx100 py8">
             {#if results.length}
-                <Menu class="m0">
-                    {#each results as result, index (result.id)}
-                        <MenuItem
-                            href={result.path}
-                            onclick={closeSearch}
-                            onkeydown={(event) => handleResultKeydown(event, index)}
-                        >
-                            <span class="d-block fw-bold mb2">{result.title}</span>
-                            {#if result.description}
-                                <span class="d-block fs-caption truncate fc-black-500 lh-md"
-                                    >{result.description}</span
-                                >
-                            {/if}
-                            <span class="d-block fs-fine fc-black-400 mt4"
-                                >{result.path}</span
+                <ul class="list-reset m0">
+                    {#each results as result (result.id)}
+                        <li>
+                            <a
+                                class="search-result d-block p12 bar-sm fc-black-600 h:bg-black-100 h:fc-black-600"
+                                href={result.path}
+                                onclick={closeSearch}
                             >
-                        </MenuItem>
+                                <span class="d-block fw-bold mb2">{result.title}</span>
+                                {#if result.description}
+                                    <span class="d-block fs-caption truncate fc-black-500 lh-md"
+                                        >{result.description}</span
+                                    >
+                                {/if}
+                                <span class="d-block fs-fine fc-black-400 mt4"
+                                    >{result.path}</span
+                                >
+                            </a>
+                        </li>
                     {/each}
-                </Menu>
+                </ul>
             {:else if hasQuery}
                 <EmptyState title="No results found" class="p24">
                     {#snippet description()}
@@ -186,14 +144,14 @@
         flex-direction: column;
         margin-bottom: 0;
         min-height: 0;
-        overflow: visible;
+        overflow: hidden;
     }
 
     .search-results {
         min-height: 0;
     }
 
-    .search-results :global(.s-menu--action) {
-        display: block;
+    .search-result {
+        text-decoration: none;
     }
 </style>
diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index 481adc209d..c1722326c3 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -65,6 +65,8 @@ async function getSearchDocuments(): Promise<DocsSearchDocument[]> {
     );
 }
 
+const searchDocumentsPromise = getSearchDocuments();
+
 export const load: LayoutServerLoad = async (event) => {
     // Load the navigation structure from the structure.yaml
     let structure: Structure = {};
@@ -132,6 +134,6 @@ export const load: LayoutServerLoad = async (event) => {
         active,
         breadcrumb,
         needsAuth,
-        searchDocuments: await getSearchDocuments(),
+        searchDocuments: await searchDocumentsPromise,
     };
 };

From 57d45b7fe0118bcfc94360031dbf32d320612b95 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 12:29:22 -0400
Subject: [PATCH 04/10] fix(docs): adjust search modal overflow spacing

---
 packages/stacks-docs/src/components/Search.svelte | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/stacks-docs/src/components/Search.svelte b/packages/stacks-docs/src/components/Search.svelte
index dbe1405769..0cfb063343 100644
--- a/packages/stacks-docs/src/components/Search.svelte
+++ b/packages/stacks-docs/src/components/Search.svelte
@@ -100,7 +100,7 @@
             />
         </div>
 
-        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 py8">
+        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 px4 mxn4 py8">
             {#if results.length}
                 <ul class="list-reset m0">
                     {#each results as result (result.id)}
@@ -144,7 +144,7 @@
         flex-direction: column;
         margin-bottom: 0;
         min-height: 0;
-        overflow: hidden;
+        overflow: visible;
     }
 
     .search-results {

From c98bd1435664d2dc09bdf43ed2b4a05e3423064a Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 12:34:01 -0400
Subject: [PATCH 05/10] fix(docs): improve search document titles

---
 .../stacks-docs/src/routes/+layout.server.ts  | 97 ++++++++++++++++---
 1 file changed, 82 insertions(+), 15 deletions(-)

diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index c1722326c3..1b35b6d417 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -15,6 +15,8 @@ const turndownService = new TurndownService({
 type NavItem = {
     slug: string;
     title?: string;
+    description?: string;
+    externalUrl?: string;
     private?: boolean;
     items?: NavItem[];
     [key: string]: unknown;
@@ -24,6 +26,17 @@ type Structure = {
     navigation?: NavItem[];
 };
 
+function parseStructure(): Structure {
+    try {
+        return YAML.parse(structureRaw);
+    } catch (err) {
+        console.error("Failed to parse structure.yaml:", err);
+        return {};
+    }
+}
+
+const structure = parseStructure();
+
 function findByPath(
     { navigation = [] }: Structure,
     path: string[]
@@ -39,6 +52,24 @@ function findByPath(
     return "slug" in currentLevel ? currentLevel : undefined;
 }
 
+function getNavTrail(
+    { navigation = [] }: Structure,
+    path: string[]
+): NavItem[] {
+    const trail: NavItem[] = [];
+    let currentLevel: { items?: NavItem[] } | NavItem = { items: navigation };
+
+    for (const slug of path) {
+        const next = currentLevel.items?.find((item) => item.slug === slug);
+        if (!next) return trail;
+
+        trail.push(next);
+        currentLevel = next;
+    }
+
+    return trail;
+}
+
 function getSearchPath(filePath: string): string {
     return filePath
         .replace("/src/docs/public/", "/")
@@ -46,37 +77,73 @@ function getSearchPath(filePath: string): string {
         .replace(/\.md$/, "");
 }
 
-async function getSearchDocuments(): Promise<DocsSearchDocument[]> {
-    return Promise.all(
+function getSearchTitle(
+    metadata: DocsMetadata,
+    structure: Structure,
+    path: string
+): string {
+    if (metadata?.title) return metadata.title;
+
+    const trail = getNavTrail(structure, path.split("/").filter(Boolean));
+    if (trail.length) {
+        return trail.map((item) => item.title ?? item.slug).join(" > ");
+    }
+
+    return path;
+}
+
+function getSearchDescription(
+    metadata: DocsMetadata,
+    structure: Structure,
+    path: string
+): string {
+    if (metadata?.description) return metadata.description;
+
+    const trail = getNavTrail(structure, path.split("/").filter(Boolean));
+    return trail.at(-1)?.description ?? "";
+}
+
+async function getSearchDocuments(
+    structure: Structure
+): Promise<DocsSearchDocument[]> {
+    const markdownDocuments = await Promise.all(
         Object.entries(mdFiles).map(async ([path, doc]) => {
             const page = (await doc()) as {
                 default: Component;
                 metadata: DocsMetadata;
             };
+            const searchPath = getSearchPath(path);
 
             return {
                 id: path,
-                title: page.metadata?.title ?? getSearchPath(path),
-                description: page.metadata?.description ?? "",
-                path: getSearchPath(path),
+                title: getSearchTitle(page.metadata, structure, searchPath),
+                description: getSearchDescription(
+                    page.metadata,
+                    structure,
+                    searchPath
+                ),
+                path: searchPath,
                 text: turndownService.turndown(render(page.default).body),
             };
         })
     );
+
+    return [
+        ...markdownDocuments,
+        {
+            id: "route:/resources/icons",
+            title: "Resources > Icons & Spots",
+            description:
+                "Search and browse Stack Overflow icons and spot illustrations.",
+            path: "/resources/icons",
+            text: "icons icon spots spot illustrations illustration figma github svg svelte",
+        },
+    ];
 }
 
-const searchDocumentsPromise = getSearchDocuments();
+const searchDocumentsPromise = getSearchDocuments(structure);
 
 export const load: LayoutServerLoad = async (event) => {
-    // Load the navigation structure from the structure.yaml
-    let structure: Structure = {};
-
-    try {
-        structure = YAML.parse(structureRaw);
-    } catch (err) {
-        console.error("Failed to parse structure.yaml:", err);
-    }
-
     // Grab the current section from the structure
     const path = [
         event.params.category,

From b431ad4afdebcf4ef028606e2ce90110be213693 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 12:37:34 -0400
Subject: [PATCH 06/10] fix(docs): strip markup from search text

---
 packages/stacks-docs/src/routes/+layout.server.ts | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index 1b35b6d417..e3acce3d38 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -103,6 +103,14 @@ function getSearchDescription(
     return trail.at(-1)?.description ?? "";
 }
 
+function getPlainText(html: string): string {
+    return turndownService
+        .turndown(html)
+        .replace(/<[^>]+>/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+
 async function getSearchDocuments(
     structure: Structure
 ): Promise<DocsSearchDocument[]> {
@@ -113,6 +121,7 @@ async function getSearchDocuments(
                 metadata: DocsMetadata;
             };
             const searchPath = getSearchPath(path);
+            const text = getPlainText(render(page.default).body);
 
             return {
                 id: path,
@@ -123,7 +132,7 @@ async function getSearchDocuments(
                     searchPath
                 ),
                 path: searchPath,
-                text: turndownService.turndown(render(page.default).body),
+                text,
             };
         })
     );

From a080e2668b9319df0b7a13ed79c020c51a0f6e9a Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 12:40:11 -0400
Subject: [PATCH 07/10] fix(docs): strip markup from search descriptions

---
 packages/stacks-docs/src/routes/+layout.server.ts | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index e3acce3d38..f3cad6c84d 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -82,7 +82,7 @@ function getSearchTitle(
     structure: Structure,
     path: string
 ): string {
-    if (metadata?.title) return metadata.title;
+    if (metadata?.title) return normalizeText(metadata.title);
 
     const trail = getNavTrail(structure, path.split("/").filter(Boolean));
     if (trail.length) {
@@ -97,15 +97,18 @@ function getSearchDescription(
     structure: Structure,
     path: string
 ): string {
-    if (metadata?.description) return metadata.description;
+    if (metadata?.description) return normalizeText(metadata.description);
 
     const trail = getNavTrail(structure, path.split("/").filter(Boolean));
-    return trail.at(-1)?.description ?? "";
+    return normalizeText(trail.at(-1)?.description ?? "");
 }
 
 function getPlainText(html: string): string {
-    return turndownService
-        .turndown(html)
+    return normalizeText(turndownService.turndown(html));
+}
+
+function normalizeText(text: string): string {
+    return text
         .replace(/<[^>]+>/g, "")
         .replace(/\s+/g, " ")
         .trim();

From 0729d9117cb49cafdcda90a4c16a3a846f764f77 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 12:56:32 -0400
Subject: [PATCH 08/10] fix(docs): improve search accessibility

---
 .../stacks-docs/src/components/Search.svelte  | 44 ++++++++---
 .../stacks-docs/src/routes/+layout.server.ts  | 77 ++++++++++++-------
 2 files changed, 82 insertions(+), 39 deletions(-)

diff --git a/packages/stacks-docs/src/components/Search.svelte b/packages/stacks-docs/src/components/Search.svelte
index 0cfb063343..ddfb2543b1 100644
--- a/packages/stacks-docs/src/components/Search.svelte
+++ b/packages/stacks-docs/src/components/Search.svelte
@@ -1,4 +1,5 @@
 <script lang="ts">
+    import { resolve } from "$app/paths";
     import { tick } from "svelte";
     import MiniSearch, { type SearchResult } from "minisearch";
 
@@ -43,6 +44,11 @@
     });
 
     const hasQuery = $derived(query.trim().length > 0);
+    const resultStatus = $derived.by(() => {
+        if (!hasQuery) return "";
+
+        return `${results.length} search ${results.length === 1 ? "result" : "results"} found.`;
+    });
 
     $effect(() => {
         if (!isOpen) return;
@@ -54,6 +60,10 @@
         isOpen = !isOpen;
     }
 
+    function openSearch() {
+        isOpen = true;
+    }
+
     function closeSearch() {
         isOpen = false;
         query = "";
@@ -65,15 +75,19 @@
             event.key.toLowerCase() === "k"
         ) {
             event.preventDefault();
-            toggleSearch();
+            openSearch();
         }
     }
-
 </script>
 
 <svelte:window onkeydown={handleWindowKeydown} />
 
-<Button icon weight="clear" class="s-btn__xs mrn6 px6 h:fc-blue-400" onclick={toggleSearch}>
+<Button
+    icon
+    weight="clear"
+    class="s-btn__xs mrn6 px6 h:fc-blue-400"
+    onclick={toggleSearch}
+>
     <Icon src={IconSearch} />
     <span class="v-visible-sr">Search</span>
 </Button>
@@ -81,7 +95,7 @@
 <Modal
     id="docs-search"
     visible={isOpen}
-    class="search-modal d-flex fd-column w100 wmx5 hs5 hmx-screen overflow-hidden pb0"
+    class="search-modal d-flex fd-column w100 wmx5 hs5 hmx-screen overflow-hidden px0 pb0"
     i18nCloseButtonLabel="Close search"
     onclose={closeSearch}
 >
@@ -90,7 +104,7 @@
     {/snippet}
 
     {#snippet body()}
-        <div class="d-flex ai-center bb bc-black-200 pb12">
+        <div class="d-flex ai-center bb bc-black-200 px24 pb12">
             <input
                 bind:this={searchInput}
                 bind:value={query}
@@ -100,19 +114,24 @@
             />
         </div>
 
-        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 px4 mxn4 py8">
+        <p class="v-visible-sr" aria-live="polite">{resultStatus}</p>
+
+        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 px24 py8">
             {#if results.length}
-                <ul class="list-reset m0">
+                <ul class="list-reset m0" aria-label="Search results">
                     {#each results as result (result.id)}
                         <li>
                             <a
                                 class="search-result d-block p12 bar-sm fc-black-600 h:bg-black-100 h:fc-black-600"
-                                href={result.path}
+                                href={resolve(result.path as `/${string}`)}
                                 onclick={closeSearch}
                             >
-                                <span class="d-block fw-bold mb2">{result.title}</span>
+                                <span class="d-block fw-bold mb2"
+                                    >{result.title}</span
+                                >
                                 {#if result.description}
-                                    <span class="d-block fs-caption truncate fc-black-500 lh-md"
+                                    <span
+                                        class="d-block fs-caption truncate fc-black-500 lh-md"
                                         >{result.description}</span
                                     >
                                 {/if}
@@ -139,6 +158,11 @@
 </Modal>
 
 <style>
+    :global(#docs-search-title) {
+        padding-left: var(--su24);
+        padding-right: var(--su24);
+    }
+
     :global(#docs-search-description) {
         display: flex;
         flex-direction: column;
diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index f3cad6c84d..6b6d707420 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -5,6 +5,7 @@ import TurndownService from "turndown";
 import YAML from "yaml";
 import structureRaw from "$src/structure.yaml?raw";
 
+// Only public docs are indexed because layout data is sent to every visitor.
 const mdFiles = import.meta.glob("$docs/public/**/*.md");
 
 const turndownService = new TurndownService({
@@ -109,51 +110,69 @@ function getPlainText(html: string): string {
 
 function normalizeText(text: string): string {
     return text
-        .replace(/<[^>]+>/g, "")
+        .replace(/<[^>]+>/g, " ")
         .replace(/\s+/g, " ")
         .trim();
 }
 
+const routeSearchDocuments: DocsSearchDocument[] = [
+    // Non-markdown docs routes are not included in the glob above.
+    {
+        id: "route:/resources/icons",
+        title: "Resources > Icons & Spots",
+        description:
+            "Search and browse Stack Overflow icons and spot illustrations.",
+        path: "/resources/icons",
+        text: "icons icon spots spot illustrations illustration figma github svg svelte",
+    },
+];
+
 async function getSearchDocuments(
     structure: Structure
 ): Promise<DocsSearchDocument[]> {
     const markdownDocuments = await Promise.all(
         Object.entries(mdFiles).map(async ([path, doc]) => {
-            const page = (await doc()) as {
-                default: Component;
-                metadata: DocsMetadata;
-            };
-            const searchPath = getSearchPath(path);
-            const text = getPlainText(render(page.default).body);
-
-            return {
-                id: path,
-                title: getSearchTitle(page.metadata, structure, searchPath),
-                description: getSearchDescription(
-                    page.metadata,
-                    structure,
-                    searchPath
-                ),
-                path: searchPath,
-                text,
-            };
+            try {
+                const page = (await doc()) as {
+                    default: Component;
+                    metadata: DocsMetadata;
+                };
+                const searchPath = getSearchPath(path);
+                const text = getPlainText(render(page.default).body);
+
+                return {
+                    id: path,
+                    title: getSearchTitle(page.metadata, structure, searchPath),
+                    description: getSearchDescription(
+                        page.metadata,
+                        structure,
+                        searchPath
+                    ),
+                    path: searchPath,
+                    text,
+                };
+            } catch (err) {
+                console.error(
+                    `Failed to build search document for ${path}:`,
+                    err
+                );
+                return null;
+            }
         })
     );
 
     return [
-        ...markdownDocuments,
-        {
-            id: "route:/resources/icons",
-            title: "Resources > Icons & Spots",
-            description:
-                "Search and browse Stack Overflow icons and spot illustrations.",
-            path: "/resources/icons",
-            text: "icons icon spots spot illustrations illustration figma github svg svelte",
-        },
+        ...markdownDocuments.filter(
+            (document): document is DocsSearchDocument => document !== null
+        ),
+        ...routeSearchDocuments,
     ];
 }
 
-const searchDocumentsPromise = getSearchDocuments(structure);
+const searchDocumentsPromise = getSearchDocuments(structure).catch((err) => {
+    console.error("Failed to build search documents:", err);
+    return routeSearchDocuments;
+});
 
 export const load: LayoutServerLoad = async (event) => {
     // Grab the current section from the structure

From c5b43514e1eb35cb688f076bee15ded20bc66c63 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 13:07:20 -0400
Subject: [PATCH 09/10] style(docs): use atomic search result styles

---
 packages/stacks-docs/src/components/Search.svelte | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/stacks-docs/src/components/Search.svelte b/packages/stacks-docs/src/components/Search.svelte
index ddfb2543b1..9372df88b2 100644
--- a/packages/stacks-docs/src/components/Search.svelte
+++ b/packages/stacks-docs/src/components/Search.svelte
@@ -116,13 +116,13 @@
 
         <p class="v-visible-sr" aria-live="polite">{resultStatus}</p>
 
-        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 px24 py8">
+        <div class="search-results fl-shrink1 overflow-auto h5 hmx100 hmn0 px24 py8">
             {#if results.length}
                 <ul class="list-reset m0" aria-label="Search results">
                     {#each results as result (result.id)}
                         <li>
                             <a
-                                class="search-result d-block p12 bar-sm fc-black-600 h:bg-black-100 h:fc-black-600"
+                                class="d-block p12 bar-sm fc-black-600 h:bg-black-100 h:fc-black-600 td-none"
                                 href={resolve(result.path as `/${string}`)}
                                 onclick={closeSearch}
                             >
@@ -171,11 +171,4 @@
         overflow: visible;
     }
 
-    .search-results {
-        min-height: 0;
-    }
-
-    .search-result {
-        text-decoration: none;
-    }
 </style>

From 6f16fc1f50bdaec216c57d4e744c7609374a5cec Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Thu, 9 Jul 2026 13:13:47 -0400
Subject: [PATCH 10/10] refactor(docs): extract search document builder

---
 .../stacks-docs/src/lib/searchDocuments.ts    | 148 ++++++++++++++++++
 .../stacks-docs/src/routes/+layout.server.ts  | 134 +---------------
 2 files changed, 150 insertions(+), 132 deletions(-)
 create mode 100644 packages/stacks-docs/src/lib/searchDocuments.ts

diff --git a/packages/stacks-docs/src/lib/searchDocuments.ts b/packages/stacks-docs/src/lib/searchDocuments.ts
new file mode 100644
index 0000000000..8427b08ec0
--- /dev/null
+++ b/packages/stacks-docs/src/lib/searchDocuments.ts
@@ -0,0 +1,148 @@
+import type { Component } from "svelte";
+import { render } from "svelte/server";
+import TurndownService from "turndown";
+
+// Only public docs are indexed because layout data is sent to every visitor.
+const mdFiles = import.meta.glob("$docs/public/**/*.md");
+
+const turndownService = new TurndownService({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+});
+
+type NavItem = {
+    slug: string;
+    title?: string;
+    description?: string;
+    externalUrl?: string;
+    private?: boolean;
+    items?: NavItem[];
+    [key: string]: unknown;
+};
+
+type Structure = {
+    navigation?: NavItem[];
+};
+
+function getNavTrail(
+    { navigation = [] }: Structure,
+    path: string[]
+): NavItem[] {
+    const trail: NavItem[] = [];
+    let currentLevel: { items?: NavItem[] } | NavItem = { items: navigation };
+
+    for (const slug of path) {
+        const next = currentLevel.items?.find((item) => item.slug === slug);
+        if (!next) return trail;
+
+        trail.push(next);
+        currentLevel = next;
+    }
+
+    return trail;
+}
+
+function getSearchPath(filePath: string): string {
+    return filePath
+        .replace("/src/docs/public/", "/")
+        .replace(/\/index\.md$/, "/")
+        .replace(/\.md$/, "");
+}
+
+function getSearchTitle(
+    metadata: DocsMetadata,
+    structure: Structure,
+    path: string
+): string {
+    if (metadata?.title) return normalizeText(metadata.title);
+
+    const trail = getNavTrail(structure, path.split("/").filter(Boolean));
+    if (trail.length) {
+        return trail.map((item) => item.title ?? item.slug).join(" > ");
+    }
+
+    return path;
+}
+
+function getSearchDescription(
+    metadata: DocsMetadata,
+    structure: Structure,
+    path: string
+): string {
+    if (metadata?.description) return normalizeText(metadata.description);
+
+    const trail = getNavTrail(structure, path.split("/").filter(Boolean));
+    return normalizeText(trail.at(-1)?.description ?? "");
+}
+
+function getPlainText(html: string): string {
+    return normalizeText(turndownService.turndown(html));
+}
+
+function normalizeText(text: string): string {
+    return text
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+
+const routeSearchDocuments: DocsSearchDocument[] = [
+    // Non-markdown docs routes are not included in the glob above.
+    {
+        id: "route:/resources/icons",
+        title: "Resources > Icons & Spots",
+        description:
+            "Search and browse Stack Overflow icons and spot illustrations.",
+        path: "/resources/icons",
+        text: "icons icon spots spot illustrations illustration figma github svg svelte",
+    },
+];
+
+async function getSearchDocuments(
+    structure: Structure
+): Promise<DocsSearchDocument[]> {
+    const markdownDocuments = await Promise.all(
+        Object.entries(mdFiles).map(async ([path, doc]) => {
+            try {
+                const page = (await doc()) as {
+                    default: Component;
+                    metadata: DocsMetadata;
+                };
+                const searchPath = getSearchPath(path);
+                const text = getPlainText(render(page.default).body);
+
+                return {
+                    id: path,
+                    title: getSearchTitle(page.metadata, structure, searchPath),
+                    description: getSearchDescription(
+                        page.metadata,
+                        structure,
+                        searchPath
+                    ),
+                    path: searchPath,
+                    text,
+                };
+            } catch (err) {
+                console.error(
+                    `Failed to build search document for ${path}:`,
+                    err
+                );
+                return null;
+            }
+        })
+    );
+
+    return [
+        ...markdownDocuments.filter(
+            (document): document is DocsSearchDocument => document !== null
+        ),
+        ...routeSearchDocuments,
+    ];
+}
+
+export function getSearchDocumentsPromise(structure: Structure) {
+    return getSearchDocuments(structure).catch((err) => {
+        console.error("Failed to build search documents:", err);
+        return routeSearchDocuments;
+    });
+}
diff --git a/packages/stacks-docs/src/routes/+layout.server.ts b/packages/stacks-docs/src/routes/+layout.server.ts
index 6b6d707420..48019ae22f 100644
--- a/packages/stacks-docs/src/routes/+layout.server.ts
+++ b/packages/stacks-docs/src/routes/+layout.server.ts
@@ -1,17 +1,7 @@
 import type { LayoutServerLoad } from "./$types";
-import type { Component } from "svelte";
-import { render } from "svelte/server";
-import TurndownService from "turndown";
 import YAML from "yaml";
 import structureRaw from "$src/structure.yaml?raw";
-
-// Only public docs are indexed because layout data is sent to every visitor.
-const mdFiles = import.meta.glob("$docs/public/**/*.md");
-
-const turndownService = new TurndownService({
-    headingStyle: "atx",
-    codeBlockStyle: "fenced",
-});
+import { getSearchDocumentsPromise } from "$lib/searchDocuments";
 
 type NavItem = {
     slug: string;
@@ -37,6 +27,7 @@ function parseStructure(): Structure {
 }
 
 const structure = parseStructure();
+const searchDocumentsPromise = getSearchDocumentsPromise(structure);
 
 function findByPath(
     { navigation = [] }: Structure,
@@ -53,127 +44,6 @@ function findByPath(
     return "slug" in currentLevel ? currentLevel : undefined;
 }
 
-function getNavTrail(
-    { navigation = [] }: Structure,
-    path: string[]
-): NavItem[] {
-    const trail: NavItem[] = [];
-    let currentLevel: { items?: NavItem[] } | NavItem = { items: navigation };
-
-    for (const slug of path) {
-        const next = currentLevel.items?.find((item) => item.slug === slug);
-        if (!next) return trail;
-
-        trail.push(next);
-        currentLevel = next;
-    }
-
-    return trail;
-}
-
-function getSearchPath(filePath: string): string {
-    return filePath
-        .replace("/src/docs/public/", "/")
-        .replace(/\/index\.md$/, "/")
-        .replace(/\.md$/, "");
-}
-
-function getSearchTitle(
-    metadata: DocsMetadata,
-    structure: Structure,
-    path: string
-): string {
-    if (metadata?.title) return normalizeText(metadata.title);
-
-    const trail = getNavTrail(structure, path.split("/").filter(Boolean));
-    if (trail.length) {
-        return trail.map((item) => item.title ?? item.slug).join(" > ");
-    }
-
-    return path;
-}
-
-function getSearchDescription(
-    metadata: DocsMetadata,
-    structure: Structure,
-    path: string
-): string {
-    if (metadata?.description) return normalizeText(metadata.description);
-
-    const trail = getNavTrail(structure, path.split("/").filter(Boolean));
-    return normalizeText(trail.at(-1)?.description ?? "");
-}
-
-function getPlainText(html: string): string {
-    return normalizeText(turndownService.turndown(html));
-}
-
-function normalizeText(text: string): string {
-    return text
-        .replace(/<[^>]+>/g, " ")
-        .replace(/\s+/g, " ")
-        .trim();
-}
-
-const routeSearchDocuments: DocsSearchDocument[] = [
-    // Non-markdown docs routes are not included in the glob above.
-    {
-        id: "route:/resources/icons",
-        title: "Resources > Icons & Spots",
-        description:
-            "Search and browse Stack Overflow icons and spot illustrations.",
-        path: "/resources/icons",
-        text: "icons icon spots spot illustrations illustration figma github svg svelte",
-    },
-];
-
-async function getSearchDocuments(
-    structure: Structure
-): Promise<DocsSearchDocument[]> {
-    const markdownDocuments = await Promise.all(
-        Object.entries(mdFiles).map(async ([path, doc]) => {
-            try {
-                const page = (await doc()) as {
-                    default: Component;
-                    metadata: DocsMetadata;
-                };
-                const searchPath = getSearchPath(path);
-                const text = getPlainText(render(page.default).body);
-
-                return {
-                    id: path,
-                    title: getSearchTitle(page.metadata, structure, searchPath),
-                    description: getSearchDescription(
-                        page.metadata,
-                        structure,
-                        searchPath
-                    ),
-                    path: searchPath,
-                    text,
-                };
-            } catch (err) {
-                console.error(
-                    `Failed to build search document for ${path}:`,
-                    err
-                );
-                return null;
-            }
-        })
-    );
-
-    return [
-        ...markdownDocuments.filter(
-            (document): document is DocsSearchDocument => document !== null
-        ),
-        ...routeSearchDocuments,
-    ];
-}
-
-const searchDocumentsPromise = getSearchDocuments(structure).catch((err) => {
-    console.error("Failed to build search documents:", err);
-    return routeSearchDocuments;
-});
-
 export const load: LayoutServerLoad = async (event) => {
     // Grab the current section from the structure
     const path = [