@@ -78,3 +78,24 @@ export const rewriteRelativeLink = (url: string): string => {
 
   return updatedUrl;
 };
+
+/**
+ * Transforms an Astro content slug for an example into the legacy website slug.
+ *
+ * Astro automatically uses the directory structure for slug information.
+ * Historically the p5 website has used a different structure for example file
+ * vs. webpage routing. This function bridges the two.
+ *
+ * Note: This function lives in _utils-node.ts (rather than _utils.ts) so that
+ * it can be imported by Node-only scripts such as the search-index builder
+ * without pulling in Astro-specific virtual modules.
+ */
+export const exampleContentSlugToLegacyWebsiteSlug = (slug: string): string =>
+  slug
+    // First transformation: Remove any locale prefix.
+    .replace(/^[\w-]+?\//, "") // Remove locale prefix
+    // Second transformation: Convert slugs built from local dev path to the legacy format.
+    // For example, "123_topicA/456_topicB/description" becomes "topicA-topicB.html".
+    .replace(/\d+_(.*?)\/\d+_(.*?)\/description$/, "$1-$2")
+    // Third transformation: Replace all remaining underscores in the slug with hyphens.
+    .replace(/_/g, "-");
@@ -11,7 +11,8 @@ import { JSDOM } from "jsdom";
 import type { JumpToLink, JumpToState } from "../globals/state";
 import { categories as referenceCategories } from "../content/reference/config";
 import memoize from "lodash/memoize";
-import { removeNestedReferencePaths } from "./_utils-node";
+import { removeNestedReferencePaths, exampleContentSlugToLegacyWebsiteSlug } from "./_utils-node";
+export { exampleContentSlugToLegacyWebsiteSlug };
 
 interface EntryWithId {
   id: string;
@@ -141,25 +142,10 @@ export const getRelatedEntriesinCollection = async <
   return foundEntries.filter((el) => el !== undefined) as CollectionEntry<C>[];
 };
 
-/**
- * Astro automatically uses the directory structure for slug information
- * Historically the p5 website has used a different structure for example file vs. webpage routing
- * This function transforms the Astro slug to the appropriate webpage route to avoid breaking
- * Any inbound legacy links
- */
-export const exampleContentSlugToLegacyWebsiteSlug = (slug: string): string =>
-  slug
-    // First transformation: Remove any locale prefix.
-    .replace(/^[\w-]+?\//, "") // Remove locale prefix
-    // Second transformation: Convert slugs built from local dev path to the legacy format.
-    // For example, "123_topicA/456_topicB/description" becomes "topicA-topicB.html".
-    .replace(/\d+_(.*?)\/\d+_(.*?)\/description$/, "$1-$2")
-    // Third transformation: Replace all remaining underscores in the slug with hyphens.
-    .replace(/_/g, "-");
-
 export const getExampleCategory = (entry: any): string =>
   entry.filePath.split("/")[4].split("_").splice(1).join(" ");
 
+
 export const normalizeReferenceRoute = (route: string): string =>
   removeNestedReferencePaths(removeLocaleAndExtension(route));
 
 
@@ -10,7 +10,7 @@ import keywordExtractor from "keyword-extractor";
 import { contentTypes } from "../../globals/globals";
 import { supportedLocales as localesWithSearchSupport } from "../../i18n/const";
 import type { LanguageName } from "keyword-extractor/types/lib/keyword_extractor";
-import { removeNestedReferencePaths } from "../../pages/_utils-node";
+import { removeNestedReferencePaths, exampleContentSlugToLegacyWebsiteSlug } from "../../pages/_utils-node";
 
 interface SearchIndex {
   [title: string]: {
@@ -223,19 +223,19 @@ export const generateSearchIndex = async (
         title = data.title;
         description = getKeywordsFromContent(content, locale);
         break;
-      case "examples":
-        relativeUrl = file
+      case "examples": {
+        // The helper expects a slug with the locale prefix intact (e.g.
+        // "en/05_Transformation/01_Rotate/description") because its first
+        // regex strips ^[\w-]+?/ (the locale). contentRelativeUrl is already
+        // locale-stripped, so derive the slug from the content base path.
+        const exampleSlug = file
           .replace("src/content/examples/", "")
-          .replace(".mdx", "")
-          .toLowerCase()
-          // TODO: Separate Astro utils from the exampleContentSlugToLegacyWebsiteSlug
-          .replace(/^[\w-]+?\//, "")
-          .replace(/\d+_(.*?)\/\d+_(.*?)\/description$/, "$1-$2")
-          .replace(/_/g, "-");
-        relativeUrl = `/examples/${relativeUrl}`;
+          .replace(".mdx", "");
+        relativeUrl = `/examples/${exampleContentSlugToLegacyWebsiteSlug(exampleSlug)}`;
         title = data.title;
         description = getKeywordsFromContent(content, locale);
         break;
+      }
       case "reference":
         relativeUrl = removeNestedReferencePaths(relativeUrl);
         title = data.title;
 
@@ -1,22 +1,25 @@
 import { describe, expect, test, vi } from "vitest";
 import { generateSearchIndex } from "../../src/scripts/builders/search";
+import { getContentFilePaths } from "../../src/scripts/utils";
 import type {
   ContentType,
   SearchSupportedLocales,
 } from "../../types/content.interface";
 
 vi.mock("../../src/scripts/utils", () => ({
-  getContentFilePaths: vi
-    .fn()
-    .mockResolvedValue([
-      "src/content/reference/en/p5/mouseX.mdx",
-      "src/content/reference/en/p5.Vector/add.mdx",
-      "src/content/reference/en/p5/loadImage.mdx",
-    ]),
+  getContentFilePaths: vi.fn(),
 }));
 
+const mockedGetContentFilePaths = vi.mocked(getContentFilePaths);
+
 describe("Search Index Title Generation", () => {
   test("generates correct titles for reference items", async () => {
+    mockedGetContentFilePaths.mockResolvedValue([
+      "src/content/reference/en/p5/mouseX.mdx",
+      "src/content/reference/en/p5.Vector/add.mdx",
+      "src/content/reference/en/p5/loadImage.mdx",
+    ]);
+
     const mockContentType: ContentType = "reference";
     const mockLocale: SearchSupportedLocales = "en";
 
@@ -40,3 +43,24 @@ describe("Search Index Title Generation", () => {
     expect(result?.["loadImage()"].alias).toBe("loadImage");
   });
 });
+
+describe("Search Index Example URL Generation", () => {
+  test("generates correct case-sensitive URLs for example items", async () => {
+    mockedGetContentFilePaths.mockResolvedValue([
+      "src/content/examples/en/01_Shapes_And_Color/00_Shape_Primitives/description.mdx",
+      "src/content/examples/en/05_Transformation/01_Rotate/description.mdx",
+    ]);
+
+    const result = await generateSearchIndex("examples", "en");
+
+    expect(result).toBeDefined();
+
+    // Verify URLs preserve original casing and match Astro routing
+    expect(result?.["Shape Primitives"].relativeUrl).toBe(
+      "/examples/Shapes-And-Color-Shape-Primitives",
+    );
+    expect(result?.["Rotate"].relativeUrl).toBe(
+      "/examples/Transformation-Rotate",
+    );
+  });
+});