feat: Overhaul Cloudflare docs

- Move various snippets into includes
- Cover the 'release' attribute on all worker snippets
- General normalization

Author: dcramer

docs/platforms/javascript/guides/cloudflare/frameworks/astro.mdx

@@ -3,6 +3,8 @@ title: Cloudflare Astro Framework Guide
 description: "Learn how to add Cloudflare instrumentation to your Astro app."
 ---
 
+## Install
+
 If you're running your Astro app on Cloudflare Pages, you can use the Sentry Astro SDK in combination with the Sentry Cloudflare SDK to add Sentry instrumentation.
 
 First, install the Sentry Astro SDK in your application. We recommend [setting up the Astro SDK manually](/platforms/javascript/guides/astro/manual-setup/) and manually initializing the SDK. Make sure you have a `sentry.client.config.js` file created, but do not add a `sentry.server.config.js` file.
@@ -11,27 +13,9 @@ After installing the Sentry Astro SDK, you can now install the Sentry Cloudflare
 
 <PlatformContent includePath="getting-started-install" />
 
-To use the SDK, you'll need to set either the `nodejs_als` or `nodejs_compat` compatibility flags in your `wrangler.jsonc`/`wrangler.toml` config. This is because the SDK
-needs access to the `AsyncLocalStorage` API to work correctly.
-
-```jsonc {tabTitle:JSON} {filename:wrangler.jsonc}
-{
-  "compatibility_flags": [
-    "nodejs_als",
-    // "nodejs_compat"
-  ],
-}
-```
-
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-compatibility_flags = ["nodejs_als"]
-# compatibility_flags = ["nodejs_compat"]
-```
-
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-compatibility_flags = ["nodejs_compat"]
-# compatibility_flags = ["nodejs_als"]
-```
+## Setup
+
+<PlatformContent includePath="getting-started-config" />
 
 Then create a `functions` directory and add a `_middleware.js` file to it with the following code:
 

docs/platforms/javascript/guides/cloudflare/frameworks/hono.mdx

@@ -5,75 +5,15 @@ description: "Learn how to add Cloudflare instrumentation to your Hono app."
 
 This guide explains how to set up Sentry in your Hono application running on Cloudflare Workers.
 
-## Setup
-
-To use the SDK, you'll need to set either the `nodejs_als` or `nodejs_compat` compatibility flags in your `wrangler.jsonc`/`wrangler.toml` config. This is because the SDK
-needs access to the `AsyncLocalStorage` API to work correctly.
-
-```jsonc {tabTitle:JSON} {filename:wrangler.jsonc}
-{
-  "compatibility_flags": [
-    "nodejs_als",
-    // "nodejs_compat"
-  ],
-}
-```
-
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-compatibility_flags = ["nodejs_als"]
-# compatibility_flags = ["nodejs_compat"]
-```
-
-You will also want to add the `CF_VERSION_METADATA` binding:
-
-```jsonc {tabTitle:JSON} {filename:wrangler.jsonc}
-{
-  // ...
-  "version_metadata": {
-    "binding": "CF_VERSION_METADATA"
-  },
-}
-```
+## Install
 
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-version_metadata = { binding = "CF_VERSION_METADATA" }
-```
+<PlatformContent includePath="getting-started-install" />
 
-## Config
-
-Next, wrap your worker handler with the `withSentry` function. This will initialize the SDK and hook into the
-environment. Note that you can turn off almost all side effects using the respective options.
-
-```typescript {filename:index.ts}
-import { Hono, HTTPException } from "hono";
-import * as Sentry from "@sentry/cloudflare";
-
-// Wrap your Worker binding with Sentry to ensure tracing instrumentation is enabled,
-// and Sentry telemetry is flushed at the end of requests.
-export default Sentry.withSentry(
-  (env) => {
-    const { id: versionId } = env.CF_VERSION_METADATA;
-
-    return {
-      dsn: "___PUBLIC_DSN___",
-
-      release: versionId,
+## Setup
 
-      // Adds request headers and IP for users, for more info visit:
-      // https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/options/#sendDefaultPii
-      sendDefaultPii: true,
+<PlatformContent includePath="getting-started-config" />
 
-      // ___PRODUCT_OPTION_START___ performance
-      // Set tracesSampleRate to 1.0 to capture 100% of spans for tracing.
-      // Learn more at
-      // https://docs.sentry.io/platforms/javascript/configuration/options/#traces-sample-rate
-      tracesSampleRate: 1.0,
-      // ___PRODUCT_OPTION_END___ performance
-    }
-  },
-  app
-);
-```
+<PlatformContent includePath="getting-started-config" platform="javascript.cloudflare.workers" />
 
 <PlatformContent includePath="getting-started-config" platform="javascript.hono" />
 

docs/platforms/javascript/guides/cloudflare/frameworks/remix.mdx

@@ -5,7 +5,7 @@ description: "Learn how to add Cloudflare instrumentation to your Remix app."
 
 If you're running your Remix app on Cloudflare Pages, you can use the Sentry Remix SDK in combination with the Sentry Cloudflare SDK to add Sentry instrumentation.
 
-## 1. Installing Sentry Remix SDK
+## Install
 
 First, install the Sentry Remix SDK in your application. We recommend using the Sentry wizard to automatically install the SDK:
 
@@ -15,30 +15,15 @@ npx @sentry/wizard@latest -i remix
 
 If the setup through the wizard doesn't work for you, you can also [set up the Remix SDK manually](/platforms/javascript/guides/remix/manual-setup/).
 
-## 2. Installing Sentry Cloudflare SDK
-
 After installing the Sentry Remix SDK, delete the newly generated `instrumentation.server.mjs` file. This instrumentation is not needed when using the Cloudflare SDK.
 
 Now you can install the Sentry Cloudflare SDK. First, install the SDK with your package manager:
 
 <PlatformContent includePath="getting-started-install" />
 
-To use the SDK, you'll need to set either the `nodejs_als` or `nodejs_compat` compatibility flags in your `wrangler.jsonc`/`wrangler.toml` config. This is because the SDK
-needs access to the `AsyncLocalStorage` API to work correctly.
-
-```jsonc {tabTitle:JSON} {filename:wrangler.jsonc}
-{
-  "compatibility_flags": [
-    "nodejs_als",
-    // "nodejs_compat"
-  ],
-}
-```
+## Setup
 
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-compatibility_flags = ["nodejs_als"]
-# compatibility_flags = ["nodejs_compat"]
-```
+<PlatformContent includePath="getting-started-config" />
 
 Then create a `_middleware.js` file in your `functions` directory and add the following code:
 

docs/platforms/javascript/guides/cloudflare/frameworks/sveltekit.mdx

@@ -5,7 +5,7 @@ description: "Learn how to add Cloudflare instrumentation to your SvelteKit app.
 
 If you're running your SvelteKit app on Cloudflare Pages, you need to configure the SDK a little differently to the default setup. This guide will show you how to set up the Sentry SvelteKit SDK for Cloudflare Pages.
 
-## 1. Install the SDK
+## Install
 
 First, install the Sentry SvelteKit SDK in your application. We recommend using the Sentry wizard to automatically install the SDK:
 
@@ -21,28 +21,15 @@ If you installed the SDK before, make sure that `@sentry/sveltekit` version `9.2
 
 </Alert>
 
-## 2. Cloudflare configuration
+Now you can install the Sentry Cloudflare SDK. First, install the SDK with your package manager:
 
-To use the SDK, you'll need to set either the `nodejs_als` or `nodejs_compat` compatibility flags in your `wrangler.jsonc`/`wrangler.toml` config. This is because the SDK
-needs access to the `AsyncLocalStorage` API to work correctly.
+<PlatformContent includePath="getting-started-install" />
 
-```jsonc {tabTitle:JSON} {filename:wrangler.jsonc}
-{
-  "compatibility_flags": [
-    "nodejs_als",
-    // "nodejs_compat"
-  ],
-}
-```
-
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-compatibility_flags = ["nodejs_als"]
-# compatibility_flags = ["nodejs_compat"]
-```
+## Setup
 
-## 3. Update Your Server Hooks File
+<PlatformContent includePath="getting-started-config" />
 
-To use this SDK, update your `src/hooks.server.(ts|js)` file to use the `initCloudflareSentryHandle` method from the Sentry Cloudflare SDK and remove the `Sentry.init` call from `@sentry/sveltekit`.
+Next, update your `src/hooks.server.(ts|js)` file to use the `initCloudflareSentryHandle` method from the Sentry Cloudflare SDK and remove the `Sentry.init` call from `@sentry/sveltekit`.
 
 ```typescript diff {filename:hooks.server.(ts|js)}
 -import { handleErrorWithSentry, sentryHandle } from "@sentry/sveltekit";

docs/platforms/javascript/guides/cloudflare/index.mdx

@@ -9,110 +9,29 @@ categories:
   - serverless
 ---
 
-## Install
-
-<OnboardingOptionButtons
-  options={["error-monitoring", "performance", "profiling"]}
-/>
-
-In addition to capturing errors, you can monitor interactions between multiple services or applications by [enabling tracing](/concepts/key-terms/tracing/).
-
-Select which Sentry features you'd like to install in addition to Error Monitoring to get the corresponding installation and configuration instructions below.
 
-Sentry captures data by using an SDK within your application’s runtime.
-
-```bash {tabTitle:npm}
-npm install @sentry/cloudflare --save
-```
-
-```bash {tabTitle:yarn}
-yarn add @sentry/cloudflare
-```
-
-```bash {tabTitle:pnpm}
-pnpm add @sentry/cloudflare
-```
-
-## Configure
-
-Configuration should happen as early as possible in your application's lifecycle.
-
-To use the SDK, you'll need to set either the `nodejs_compat` or `nodejs_als` compatibility flags in your `wrangler.jsonc`/`wrangler.toml` config. This is because the SDK
-needs access to the `AsyncLocalStorage` API to work correctly.
-
-```jsonc {tabTitle:JSON} {filename:wrangler.jsonc}
-{
-  "compatibility_flags": [
-    "nodejs_als",
-    // "nodejs_compat"
-  ],
-}
-```
+You can use the Sentry Cloudflare SDK with popular frameworks running on Cloudflare:
 
-```toml {tabTitle:Toml} {filename:wrangler.toml}
-compatibility_flags = ["nodejs_als"]
-# compatibility_flags = ["nodejs_compat"]
-```
+- **[Astro](framesworks/astro/)** 
+- **[Hono](frameworks/hono/)**
+- **[Remix](framesworks/remix/)**
+- **[SvelteKit](framesworks/sveltekit/)**
 
-Then you can install the SDK and add it to your project:
+Take a look at your framework of choice, as there are likely additional instructions for setting up Sentry with it. For more framework-specific guidance, see the [frameworks section](frameworks/).
 
-You can either setup up the SDK for [Cloudflare Pages](#setup-cloudflare-pages) or [Cloudflare Workers](#setup-cloudflare-workers).
+If you're not using one of these frameworks, or are just looking for general instructions for Cloudflare usage, you're in the right place.
 
-### Setup (Cloudflare Pages)
+## Install
 
-To use this SDK, add the `sentryPagesPlugin` as [middleware to your Cloudflare Pages application](https://developers.cloudflare.com/pages/functions/middleware/).
+<PlatformContent includePath="getting-started-install" />
 
-We recommend adding a `functions/_middleware.js` for the middleware setup so that Sentry is initialized for your entire
-app.
+## Setup
 
-```javascript {filename:functions/_middleware.js}
-import * as Sentry from "@sentry/cloudflare";
-
-export const onRequest = [
-  // Make sure Sentry is the first middleware
-  Sentry.sentryPagesPlugin((context) => ({
-    dsn: "___PUBLIC_DSN___",
-
-    // Adds request headers and IP for users, for more info visit:
-    // https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/options/#sendDefaultPii
-    sendDefaultPii: true,
-
-    // ___PRODUCT_OPTION_START___ performance
-    // Set tracesSampleRate to 1.0 to capture 100% of spans for tracing.
-    // Learn more at
-    // https://docs.sentry.io/platforms/javascript/configuration/options/#traces-sample-rate
-    tracesSampleRate: 1.0,
-    // ___PRODUCT_OPTION_END___ performance
-  })),
-  // Add more middlewares here
-];
-```
+<PlatformContent includePath="getting-started-config" />
 
 ### Setup (Cloudflare Workers)
 
-To use this SDK, wrap your handler with the `withSentry` function. This will initialize the SDK and hook into the
-environment. Note that you can turn off almost all side effects using the respective options.
-
-```typescript {filename:index.ts}
-import * as Sentry from "@sentry/cloudflare";
-
-export default Sentry.withSentry(
-  (env) => ({
-    dsn: "___PUBLIC_DSN___",
-    // ___PRODUCT_OPTION_START___ performance
-    // Set tracesSampleRate to 1.0 to capture 100% of spans for tracing.
-    // Learn more at
-    // https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/options/#tracesSampleRate
-    tracesSampleRate: 1.0,
-    // ___PRODUCT_OPTION_END___ performance
-  }),
-  {
-    async fetch(request, env, ctx) {
-      return new Response("Hello World!");
-    },
-  } satisfies ExportedHandler<Env>
-);
-```
+<PlatformContent includePath="getting-started-config" platform="javascript.cloudflare.workers" />
 
 If you do not have access to the `onRequest` middleware API, you can use the `wrapRequestHandler` API instead. For example:
 
@@ -133,13 +52,41 @@ export const handle = ({ event, resolve }) => {
 };
 ```
 
-### Frameworks
+### Setup (Cloudflare Pages)
 
-You can use the Sentry Cloudflare SDK with popular frameworks running on Cloudflare:
+To use this SDK, add the `sentryPagesPlugin` as [middleware to your Cloudflare Pages application](https://developers.cloudflare.com/pages/functions/middleware/).
 
-- **[Hono](frameworks/hono/)** - A lightweight web framework for Cloudflare Workers
+We recommend adding a `functions/_middleware.js` for the middleware setup so that Sentry is initialized for your entire
+app.
 
-Take a look at your framework of choice, as there are likely additional instructions for setting up Sentry with it. For more framework-specific guidance, see the [frameworks section](frameworks/).
+```javascript {filename:functions/_middleware.js}
+import * as Sentry from "@sentry/cloudflare";
+
+export const onRequest = [
+  // Make sure Sentry is the first middleware
+  Sentry.sentryPagesPlugin((context) => {
+    const { id: versionId } = env.CF_VERSION_METADATA;
+
+    return {
+      dsn: "___PUBLIC_DSN___",
+
+      release: versionId,
+ 
+      // Adds request headers and IP for users, for more info visit:
+      // https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/options/#sendDefaultPii
+      sendDefaultPii: true,
+
+      // ___PRODUCT_OPTION_START___ performance
+      // Set tracesSampleRate to 1.0 to capture 100% of spans for tracing.
+      // Learn more at
+      // https://docs.sentry.io/platforms/javascript/configuration/options/#traces-sample-rate
+      tracesSampleRate: 1.0,
+      // ___PRODUCT_OPTION_END___ performance
+    }
+  }),
+  // Add more middlewares here
+];
+```
 
 ### Cloudflare Durable Objects