From b273eee2b5be3fba34e4ed4f58f162626b312977 Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Fri, 18 Sep 2026 11:02:48 +0200 Subject: [PATCH 1/2] docs(javascript): add browser-only and server-only categories Introduce two new `PlatformCategory` values, `browser-only` and `server-only`, and apply them to the JavaScript platform and guides: - `browser-only`: guides that run only in the browser (angular, react, vue, svelte, ember, gatsby, solid, wasm, capacitor, cordova) and the base Browser JavaScript platform. - `server-only`: guides that run only server-side (node, express, fastify, nestjs, and the serverless/edge runtimes such as aws-lambda, cloudflare, bun, deno, etc.). - Meta-frameworks that run in both (astro, nextjs, nuxt, remix, react-router, solidstart, sveltekit, tanstackstart-react) and electron (desktop) get neither tag. These let content distinguish "runs only on the server" from "also runs on the server" (which `server`/`serverless` alone cannot, since meta-frameworks carry `server` too). Also drop the redundant `categories` blocks from the effect and tanstackstart-react guide `config.yml` files: guide categories are read from `index.mdx` in the doc tree, so those duplicates were dead (and effect's had drifted out of sync). Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/platforms/javascript/config.yml | 1 + docs/platforms/javascript/guides/angular/index.mdx | 1 + docs/platforms/javascript/guides/aws-lambda/index.mdx | 1 + .../javascript/guides/azure-functions/index.mdx | 1 + docs/platforms/javascript/guides/bun/index.mdx | 1 + docs/platforms/javascript/guides/capacitor/index.mdx | 1 + docs/platforms/javascript/guides/cloudflare/index.mdx | 1 + docs/platforms/javascript/guides/connect/index.mdx | 1 + docs/platforms/javascript/guides/cordova/index.mdx | 1 + docs/platforms/javascript/guides/deno/index.mdx | 1 + docs/platforms/javascript/guides/effect/config.yml | 3 --- docs/platforms/javascript/guides/effect/index.mdx | 1 + docs/platforms/javascript/guides/elysia/index.mdx | 1 + docs/platforms/javascript/guides/ember/index.mdx | 1 + docs/platforms/javascript/guides/eve/index.mdx | 1 + docs/platforms/javascript/guides/express/index.mdx | 1 + docs/platforms/javascript/guides/fastify/index.mdx | 1 + docs/platforms/javascript/guides/firebase/index.mdx | 1 + docs/platforms/javascript/guides/gatsby/index.mdx | 1 + docs/platforms/javascript/guides/gcp-functions/index.mdx | 1 + docs/platforms/javascript/guides/hapi/index.mdx | 1 + docs/platforms/javascript/guides/hono/index.mdx | 1 + docs/platforms/javascript/guides/koa/index.mdx | 1 + docs/platforms/javascript/guides/mastra/index.mdx | 1 + docs/platforms/javascript/guides/nestjs/index.mdx | 1 + docs/platforms/javascript/guides/nitro/index.mdx | 1 + docs/platforms/javascript/guides/node/index.mdx | 1 + docs/platforms/javascript/guides/react/index.mdx | 1 + docs/platforms/javascript/guides/solid/index.mdx | 1 + docs/platforms/javascript/guides/svelte/index.mdx | 1 + .../javascript/guides/tanstackstart-react/config.yml | 3 --- docs/platforms/javascript/guides/vue/index.mdx | 1 + docs/platforms/javascript/guides/wasm/index.mdx | 1 + src/types/platform.tsx | 9 ++++++++- 34 files changed, 39 insertions(+), 7 deletions(-) diff --git a/docs/platforms/javascript/config.yml b/docs/platforms/javascript/config.yml index 2f62fbce9ceba2..7ec2279bb78f92 100644 --- a/docs/platforms/javascript/config.yml +++ b/docs/platforms/javascript/config.yml @@ -8,3 +8,4 @@ sdk: 'sentry.javascript.browser' language: typescript categories: - browser + - browser-only diff --git a/docs/platforms/javascript/guides/angular/index.mdx b/docs/platforms/javascript/guides/angular/index.mdx index 7a97b86eec5f45..e72fcc124e44d6 100644 --- a/docs/platforms/javascript/guides/angular/index.mdx +++ b/docs/platforms/javascript/guides/angular/index.mdx @@ -4,6 +4,7 @@ description: "Learn how to set up Sentry in your Angular application and capture sdk: sentry.javascript.angular categories: - browser + - browser-only --- ## Prerequisites diff --git a/docs/platforms/javascript/guides/aws-lambda/index.mdx b/docs/platforms/javascript/guides/aws-lambda/index.mdx index 8b893d5e655024..0edfca511907d5 100644 --- a/docs/platforms/javascript/guides/aws-lambda/index.mdx +++ b/docs/platforms/javascript/guides/aws-lambda/index.mdx @@ -6,6 +6,7 @@ fallbackGuide: javascript.node categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/azure-functions/index.mdx b/docs/platforms/javascript/guides/azure-functions/index.mdx index 0232ecebd0215e..019578443c6ba5 100644 --- a/docs/platforms/javascript/guides/azure-functions/index.mdx +++ b/docs/platforms/javascript/guides/azure-functions/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/bun/index.mdx b/docs/platforms/javascript/guides/bun/index.mdx index 74723e401fd1d8..9cb59b4cda3da9 100644 --- a/docs/platforms/javascript/guides/bun/index.mdx +++ b/docs/platforms/javascript/guides/bun/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.bun categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/capacitor/index.mdx b/docs/platforms/javascript/guides/capacitor/index.mdx index b4dbe1af8218a7..acab8b07495262 100644 --- a/docs/platforms/javascript/guides/capacitor/index.mdx +++ b/docs/platforms/javascript/guides/capacitor/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.capacitor categories: - browser - mobile + - browser-only --- diff --git a/docs/platforms/javascript/guides/cloudflare/index.mdx b/docs/platforms/javascript/guides/cloudflare/index.mdx index f20b1aecd5a511..ee86267841af27 100644 --- a/docs/platforms/javascript/guides/cloudflare/index.mdx +++ b/docs/platforms/javascript/guides/cloudflare/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.cloudflare categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/connect/index.mdx b/docs/platforms/javascript/guides/connect/index.mdx index 1417c308995c2d..99fcbef7ffb955 100644 --- a/docs/platforms/javascript/guides/connect/index.mdx +++ b/docs/platforms/javascript/guides/connect/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/cordova/index.mdx b/docs/platforms/javascript/guides/cordova/index.mdx index 84306e51bd4c8f..2d91c1fc1ff0b6 100644 --- a/docs/platforms/javascript/guides/cordova/index.mdx +++ b/docs/platforms/javascript/guides/cordova/index.mdx @@ -5,6 +5,7 @@ description: Learn how to manually set up Sentry in your Cordova app and capture categories: - browser - mobile + - browser-only --- diff --git a/docs/platforms/javascript/guides/deno/index.mdx b/docs/platforms/javascript/guides/deno/index.mdx index 30132265658c29..9c460e93495fa8 100644 --- a/docs/platforms/javascript/guides/deno/index.mdx +++ b/docs/platforms/javascript/guides/deno/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.deno categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/effect/config.yml b/docs/platforms/javascript/guides/effect/config.yml index 48b548d5327dee..b50b7fbb2ed6b1 100644 --- a/docs/platforms/javascript/guides/effect/config.yml +++ b/docs/platforms/javascript/guides/effect/config.yml @@ -1,6 +1,3 @@ title: Effect description: Learn how to set up and configure Sentry in your Effect application, capture your first errors, and view them in Sentry. sdk: sentry.javascript.effect -categories: - - server - - browser diff --git a/docs/platforms/javascript/guides/effect/index.mdx b/docs/platforms/javascript/guides/effect/index.mdx index 79b120dbb3e7ea..a33cd8ea8befea 100644 --- a/docs/platforms/javascript/guides/effect/index.mdx +++ b/docs/platforms/javascript/guides/effect/index.mdx @@ -4,6 +4,7 @@ sdk: sentry.javascript.effect description: Learn how to set up and configure Sentry in your Effect application, capture your first errors, and view them in Sentry. categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/elysia/index.mdx b/docs/platforms/javascript/guides/elysia/index.mdx index f7ba7b7666a08f..06181b77ddab62 100644 --- a/docs/platforms/javascript/guides/elysia/index.mdx +++ b/docs/platforms/javascript/guides/elysia/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.elysia fallbackGuide: javascript.bun categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/ember/index.mdx b/docs/platforms/javascript/guides/ember/index.mdx index eda3aae0727e18..c704250dff2eca 100644 --- a/docs/platforms/javascript/guides/ember/index.mdx +++ b/docs/platforms/javascript/guides/ember/index.mdx @@ -4,6 +4,7 @@ description: "Learn how to set up Sentry in your Ember application and capture y sdk: sentry.javascript.ember categories: - browser + - browser-only --- diff --git a/docs/platforms/javascript/guides/eve/index.mdx b/docs/platforms/javascript/guides/eve/index.mdx index 77efcacd35cffa..b466da4ee65ac8 100644 --- a/docs/platforms/javascript/guides/eve/index.mdx +++ b/docs/platforms/javascript/guides/eve/index.mdx @@ -6,6 +6,7 @@ fallbackGuide: javascript.node icon: eve categories: - server + - server-only keywords: - eve - ai diff --git a/docs/platforms/javascript/guides/express/index.mdx b/docs/platforms/javascript/guides/express/index.mdx index 741115c75382dd..c495ee6e41d748 100644 --- a/docs/platforms/javascript/guides/express/index.mdx +++ b/docs/platforms/javascript/guides/express/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/fastify/index.mdx b/docs/platforms/javascript/guides/fastify/index.mdx index b6feebbadc715b..d7aecbc64fde8a 100644 --- a/docs/platforms/javascript/guides/fastify/index.mdx +++ b/docs/platforms/javascript/guides/fastify/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/firebase/index.mdx b/docs/platforms/javascript/guides/firebase/index.mdx index 36d14397543b4e..f34b8fadbc14df 100644 --- a/docs/platforms/javascript/guides/firebase/index.mdx +++ b/docs/platforms/javascript/guides/firebase/index.mdx @@ -6,6 +6,7 @@ fallbackGuide: javascript.node categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/gatsby/index.mdx b/docs/platforms/javascript/guides/gatsby/index.mdx index fc964c88e7e8f0..b16d7bd4ef6683 100644 --- a/docs/platforms/javascript/guides/gatsby/index.mdx +++ b/docs/platforms/javascript/guides/gatsby/index.mdx @@ -4,6 +4,7 @@ sdk: "sentry.javascript.gatsby" description: "Learn how to set up Sentry in your Gatsby application, capture your first errors and traces, and view them in Sentry." categories: - browser + - browser-only --- diff --git a/docs/platforms/javascript/guides/gcp-functions/index.mdx b/docs/platforms/javascript/guides/gcp-functions/index.mdx index e0f596e4b15f26..bd38aac3a3af4d 100644 --- a/docs/platforms/javascript/guides/gcp-functions/index.mdx +++ b/docs/platforms/javascript/guides/gcp-functions/index.mdx @@ -6,6 +6,7 @@ fallbackGuide: javascript.node categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/hapi/index.mdx b/docs/platforms/javascript/guides/hapi/index.mdx index dea3d17c6d4984..d7196e2d78d278 100644 --- a/docs/platforms/javascript/guides/hapi/index.mdx +++ b/docs/platforms/javascript/guides/hapi/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/hono/index.mdx b/docs/platforms/javascript/guides/hono/index.mdx index 3f33430ae056e0..e8c0afc71400a1 100644 --- a/docs/platforms/javascript/guides/hono/index.mdx +++ b/docs/platforms/javascript/guides/hono/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.hono fallbackGuide: javascript.node categories: - server + - server-only --- The `@sentry/hono` SDK supports Hono 4+ across multiple runtimes: Cloudflare Workers, Node.js, Bun, and Deno. It works as Hono middleware, so you can drop it into your existing app with minimal setup. diff --git a/docs/platforms/javascript/guides/koa/index.mdx b/docs/platforms/javascript/guides/koa/index.mdx index 3d936b3ed63626..f8c201fc2708ab 100644 --- a/docs/platforms/javascript/guides/koa/index.mdx +++ b/docs/platforms/javascript/guides/koa/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/mastra/index.mdx b/docs/platforms/javascript/guides/mastra/index.mdx index dc2aeb4ef0fd64..49b9a2f2ff1223 100644 --- a/docs/platforms/javascript/guides/mastra/index.mdx +++ b/docs/platforms/javascript/guides/mastra/index.mdx @@ -6,6 +6,7 @@ fallbackGuide: javascript.node icon: mastra categories: - server + - server-only keywords: - mastra - ai diff --git a/docs/platforms/javascript/guides/nestjs/index.mdx b/docs/platforms/javascript/guides/nestjs/index.mdx index 97ff1b26cc27f5..ee93a54aa4b66a 100644 --- a/docs/platforms/javascript/guides/nestjs/index.mdx +++ b/docs/platforms/javascript/guides/nestjs/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.nestjs fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/nitro/index.mdx b/docs/platforms/javascript/guides/nitro/index.mdx index ab7e7d2f2fc7d0..640cdabc1f22d2 100644 --- a/docs/platforms/javascript/guides/nitro/index.mdx +++ b/docs/platforms/javascript/guides/nitro/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.nitro fallbackGuide: javascript.node categories: - server + - server-only --- diff --git a/docs/platforms/javascript/guides/node/index.mdx b/docs/platforms/javascript/guides/node/index.mdx index e398bdf2b3a2dc..8ddfa3aaa6287a 100644 --- a/docs/platforms/javascript/guides/node/index.mdx +++ b/docs/platforms/javascript/guides/node/index.mdx @@ -5,6 +5,7 @@ sdk: sentry.javascript.node categories: - server - serverless + - server-only --- diff --git a/docs/platforms/javascript/guides/react/index.mdx b/docs/platforms/javascript/guides/react/index.mdx index 563e05794b8bea..389f76c83b9a70 100644 --- a/docs/platforms/javascript/guides/react/index.mdx +++ b/docs/platforms/javascript/guides/react/index.mdx @@ -4,6 +4,7 @@ description: "Learn how to set up Sentry in your React application, capture your sdk: sentry.javascript.react categories: - browser + - browser-only --- diff --git a/docs/platforms/javascript/guides/solid/index.mdx b/docs/platforms/javascript/guides/solid/index.mdx index 278f1f33c60e7c..227c27209cba9b 100644 --- a/docs/platforms/javascript/guides/solid/index.mdx +++ b/docs/platforms/javascript/guides/solid/index.mdx @@ -4,6 +4,7 @@ sdk: sentry.javascript.solid description: Learn how to manually set up Sentry in your Solid app and capture your first errors. categories: - browser + - browser-only --- diff --git a/docs/platforms/javascript/guides/svelte/index.mdx b/docs/platforms/javascript/guides/svelte/index.mdx index c56e4be59153ed..edabae96ac14d2 100644 --- a/docs/platforms/javascript/guides/svelte/index.mdx +++ b/docs/platforms/javascript/guides/svelte/index.mdx @@ -4,6 +4,7 @@ description: "Learn how to manually set up Sentry in your Svelte app and capture sdk: sentry.javascript.svelte categories: - browser + - browser-only --- diff --git a/docs/platforms/javascript/guides/tanstackstart-react/config.yml b/docs/platforms/javascript/guides/tanstackstart-react/config.yml index b5c5386441759a..0c21c3b322df40 100644 --- a/docs/platforms/javascript/guides/tanstackstart-react/config.yml +++ b/docs/platforms/javascript/guides/tanstackstart-react/config.yml @@ -1,6 +1,3 @@ title: TanStack Start React description: Learn how to set up and configure Sentry in your TanStack Start React application using the installation wizard, capturing your first errors, and viewing them in Sentry. sdk: sentry.javascript.tanstackstart-react -categories: - - server - - browser diff --git a/docs/platforms/javascript/guides/vue/index.mdx b/docs/platforms/javascript/guides/vue/index.mdx index 68633e46fdd640..1d1a966f93a450 100644 --- a/docs/platforms/javascript/guides/vue/index.mdx +++ b/docs/platforms/javascript/guides/vue/index.mdx @@ -4,6 +4,7 @@ description: "Learn how to manually set up Sentry in your Vue app and capture yo sdk: sentry.javascript.vue categories: - browser + - browser-only --- diff --git a/docs/platforms/javascript/guides/wasm/index.mdx b/docs/platforms/javascript/guides/wasm/index.mdx index 31d9daca306057..7bcc43e5e01f6d 100644 --- a/docs/platforms/javascript/guides/wasm/index.mdx +++ b/docs/platforms/javascript/guides/wasm/index.mdx @@ -5,6 +5,7 @@ description: "Learn how to manually set up Sentry in your JavaScript application keywords: ["wasm", "webassembly"] categories: - browser + - browser-only --- diff --git a/src/types/platform.tsx b/src/types/platform.tsx index 3adc84df08ec6a..5681036f3978c2 100644 --- a/src/types/platform.tsx +++ b/src/types/platform.tsx @@ -167,4 +167,11 @@ export type PlatformSupportLevel = 'production' | 'community'; /** * Possible types of categories. */ -export type PlatformCategory = 'browser' | 'desktop' | 'mobile' | 'server' | 'serverless'; +export type PlatformCategory = + | 'browser' + | 'browser-only' + | 'desktop' + | 'mobile' + | 'server' + | 'server-only' + | 'serverless'; From e5978f2f935824ab556594e712bf1bcb3913118a Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Fri, 18 Sep 2026 12:47:40 +0200 Subject: [PATCH 2/2] docs(javascript): categorize Effect as browser + server Effect is a general-purpose TypeScript library that runs in both the browser and on a server, so it is a dual-runtime guide like the meta-frameworks: it carries both `browser` and `server` and neither `browser-only` nor `server-only`. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/platforms/javascript/guides/effect/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/guides/effect/index.mdx b/docs/platforms/javascript/guides/effect/index.mdx index a33cd8ea8befea..4880fba48e5334 100644 --- a/docs/platforms/javascript/guides/effect/index.mdx +++ b/docs/platforms/javascript/guides/effect/index.mdx @@ -3,8 +3,8 @@ title: Effect sdk: sentry.javascript.effect description: Learn how to set up and configure Sentry in your Effect application, capture your first errors, and view them in Sentry. categories: + - browser - server - - server-only ---