From b8eb90e352b427c730a3065fe24b7c7e6575c7cc Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Fri, 18 Sep 2026 13:21:06 +0200 Subject: [PATCH 1/2] docs(js): scope browser Special Use Cases to browser-only platforms MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Special Use Cases overview and its browser-specific guides (Micro Frontends, Shared Environments / Browser Extensions, Offline Caching, Multiple Sentry Instances) are relevant only to browser SPAs, not to meta-frameworks or backends. Replace the partial (and stale) backend `notSupported` lists with `supportedCategories: [browser-only]`. - Excludes meta-frameworks (astro, nextjs, nuxt, remix, …) and all server runtimes, which the previous hand-maintained lists did inconsistently (they excluded the 13 original Node backends but still rendered on bun, cloudflare, deno, elysia, firebase, and mastra). - Offline Caching additionally keeps its explicit `notSupported` (capacitor, cordova, electron, wasm). Co-Authored-By: Claude Opus 4.8 (1M context) --- .../javascript/common/best-practices/index.mdx | 16 ++-------------- .../common/best-practices/micro-frontends.mdx | 16 ++-------------- .../best-practices/multiple-sentry-instances.mdx | 16 ++-------------- .../common/best-practices/offline-caching.mdx | 15 ++------------- .../best-practices/shared-environments.mdx | 16 ++-------------- 5 files changed, 10 insertions(+), 69 deletions(-) diff --git a/docs/platforms/javascript/common/best-practices/index.mdx b/docs/platforms/javascript/common/best-practices/index.mdx index 53e4910a8c3046..12d6b10da95755 100644 --- a/docs/platforms/javascript/common/best-practices/index.mdx +++ b/docs/platforms/javascript/common/best-practices/index.mdx @@ -3,20 +3,8 @@ title: Special Use Cases description: "Learn how to set up Sentry for several specific use cases with these best practice guides." sidebar_order: 18 sidebar_section: configuration -notSupported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.aws-lambda - - javascript.azure-functions - - javascript.express - - javascript.fastify - - javascript.gcp-functions - - javascript.hapi - - javascript.hono - - javascript.koa - - javascript.nitro - - javascript.nestjs +supportedCategories: + - browser-only --- diff --git a/docs/platforms/javascript/common/best-practices/micro-frontends.mdx b/docs/platforms/javascript/common/best-practices/micro-frontends.mdx index 02e4e0f1ee7140..35346e311a313b 100644 --- a/docs/platforms/javascript/common/best-practices/micro-frontends.mdx +++ b/docs/platforms/javascript/common/best-practices/micro-frontends.mdx @@ -2,20 +2,8 @@ title: Micro Frontends sidebar_order: 200 description: Learn how to identify the source of errors and route events to different Sentry projects when using micro frontends or module federation. -notSupported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.aws-lambda - - javascript.azure-functions - - javascript.express - - javascript.fastify - - javascript.gcp-functions - - javascript.hapi - - javascript.hono - - javascript.koa - - javascript.nitro - - javascript.nestjs +supportedCategories: + - browser-only keywords: [ "micro frontend", diff --git a/docs/platforms/javascript/common/best-practices/multiple-sentry-instances.mdx b/docs/platforms/javascript/common/best-practices/multiple-sentry-instances.mdx index 4cde6099865e7d..44182d1569966d 100644 --- a/docs/platforms/javascript/common/best-practices/multiple-sentry-instances.mdx +++ b/docs/platforms/javascript/common/best-practices/multiple-sentry-instances.mdx @@ -2,20 +2,8 @@ title: Multiple Sentry Instances sidebar_order: 300 description: Learn how to manage several Sentry instances by creating your own clients. -notSupported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.aws-lambda - - javascript.azure-functions - - javascript.express - - javascript.fastify - - javascript.gcp-functions - - javascript.hapi - - javascript.hono - - javascript.koa - - javascript.nitro - - javascript.nestjs +supportedCategories: + - browser-only keywords: ["multiple clients", "BrowserClient", "NodeClient", "monorepo"] --- diff --git a/docs/platforms/javascript/common/best-practices/offline-caching.mdx b/docs/platforms/javascript/common/best-practices/offline-caching.mdx index e27799bb0edbb4..e1ace9c58b85fc 100644 --- a/docs/platforms/javascript/common/best-practices/offline-caching.mdx +++ b/docs/platforms/javascript/common/best-practices/offline-caching.mdx @@ -2,24 +2,13 @@ title: Offline Caching description: "Learn how to cache Sentry events while being offline." sidebar_order: 400 +supportedCategories: + - browser-only notSupported: - javascript.capacitor - javascript.cordova - javascript.electron - javascript.wasm - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.aws-lambda - - javascript.azure-functions - - javascript.express - - javascript.fastify - - javascript.gcp-functions - - javascript.hapi - - javascript.hono - - javascript.koa - - javascript.nitro - - javascript.nestjs --- If your JavaScript application is designed to continue working offline, diff --git a/docs/platforms/javascript/common/best-practices/shared-environments.mdx b/docs/platforms/javascript/common/best-practices/shared-environments.mdx index 41147621bf94d6..a9a71b37cf53a6 100644 --- a/docs/platforms/javascript/common/best-practices/shared-environments.mdx +++ b/docs/platforms/javascript/common/best-practices/shared-environments.mdx @@ -2,20 +2,8 @@ title: Shared Environments / Browser Extensions sidebar_order: 50 description: Learn how to use Sentry in shared environments (for example in browser extensions or VSCode extensions). -notSupported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.aws-lambda - - javascript.azure-functions - - javascript.express - - javascript.fastify - - javascript.gcp-functions - - javascript.hapi - - javascript.hono - - javascript.koa - - javascript.nitro - - javascript.nestjs +supportedCategories: + - browser-only keywords: [ "BrowserClient", From 5c07fd0f604f9261af2d5124e104d6c09400b581 Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Wed, 23 Sep 2026 09:53:24 +0200 Subject: [PATCH 2/2] docs(js): scope Special Use Cases index and Offline Caching to browser Use the broader `browser` category instead of `browser-only` for the Special Use Cases overview and Offline Caching, so meta-framework guides (which have browser-relevant sub-pages) also render these pages. Offline Caching keeps its explicit notSupported list (capacitor, cordova, electron, wasm). Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/platforms/javascript/common/best-practices/index.mdx | 2 +- .../javascript/common/best-practices/offline-caching.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/platforms/javascript/common/best-practices/index.mdx b/docs/platforms/javascript/common/best-practices/index.mdx index 12d6b10da95755..4466c75fdb9aa3 100644 --- a/docs/platforms/javascript/common/best-practices/index.mdx +++ b/docs/platforms/javascript/common/best-practices/index.mdx @@ -4,7 +4,7 @@ description: "Learn how to set up Sentry for several specific use cases with the sidebar_order: 18 sidebar_section: configuration supportedCategories: - - browser-only + - browser --- diff --git a/docs/platforms/javascript/common/best-practices/offline-caching.mdx b/docs/platforms/javascript/common/best-practices/offline-caching.mdx index e1ace9c58b85fc..938fc29d17ad27 100644 --- a/docs/platforms/javascript/common/best-practices/offline-caching.mdx +++ b/docs/platforms/javascript/common/best-practices/offline-caching.mdx @@ -3,7 +3,7 @@ title: Offline Caching description: "Learn how to cache Sentry events while being offline." sidebar_order: 400 supportedCategories: - - browser-only + - browser notSupported: - javascript.capacitor - javascript.cordova