From 78bd7bed4251fe64cfeeb256ab6abf0646b205f2 Mon Sep 17 00:00:00 2001
From: "sentry-junior[bot]"
 <264270552+sentry-junior[bot]@users.noreply.github.com>
Date: Fri, 4 Sep 2026 09:08:05 +0000
Subject: [PATCH 1/2] fix(docs): use Mastra icon in platform selector

Co-Authored-By: Stephanie Anderson <stephanie.anderson@sentry.io>
---
 docs/platforms/javascript/guides/mastra/index.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/platforms/javascript/guides/mastra/index.mdx b/docs/platforms/javascript/guides/mastra/index.mdx
index 57252d6e24262..dd7a0c66eea62 100644
--- a/docs/platforms/javascript/guides/mastra/index.mdx
+++ b/docs/platforms/javascript/guides/mastra/index.mdx
@@ -2,6 +2,7 @@
 title: Mastra
 description: Learn how to send Mastra agent traces, model calls, and tool executions to Sentry.
 sdk: sentry.javascript.node
+icon: mastra
 inheritCommonContent: false
 categories:
   - javascript

From 9b2165a95cd090782a2a35c0491f23508ee2ce3e Mon Sep 17 00:00:00 2001
From: "sentry-junior[bot]"
 <264270552+sentry-junior[bot]@users.noreply.github.com>
Date: Fri, 4 Sep 2026 09:12:05 +0000
Subject: [PATCH 2/2] fix(docs): preserve guide icons in doc tree

Co-Authored-By: Stephanie Anderson <stephanie.anderson@sentry.io>
---
 src/docTree.spec.ts | 3 ++-
 src/docTree.ts      | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/docTree.spec.ts b/src/docTree.spec.ts
index 474e116e5dcbf..205fa85cf3f8b 100644
--- a/src/docTree.spec.ts
+++ b/src/docTree.spec.ts
@@ -53,7 +53,7 @@ nextjsRoot.children = [
               {
                 path: 'platforms/javascript/guides/nextjs',
                 slug: 'nextjs',
-                frontmatter: {title: 'Next.js', slug: 'nextjs'},
+                frontmatter: {title: 'Next.js', slug: 'nextjs', icon: 'nextjs-icon'},
                 children: [],
                 missing: false,
                 sourcePath: 'docs/platforms/javascript/guides/nextjs/index.mdx',
@@ -122,6 +122,7 @@ describe('docTree', () => {
         'nextjs',
       ]);
       expect(node?.name).toBe('nextjs');
+      expect(node?.icon).toBe('nextjs-icon');
     });
 
     test('should find current guide from versioned path', () => {
diff --git a/src/docTree.ts b/src/docTree.ts
index e32ce6122a2ba..db1d22c30e031 100644
--- a/src/docTree.ts
+++ b/src/docTree.ts
@@ -337,6 +337,7 @@ function nodeToGuide(platform: string, n: DocNode): PlatformGuide {
     title: n.frontmatter.title,
     platform,
     sdk: n.frontmatter.sdk || `sentry.${key}`,
+    icon: n.frontmatter.icon,
     categories: n.frontmatter.categories,
     fallbackGuide: n.frontmatter.fallbackGuide,
   };