Add logs beta configuration to JavaScript platform documentation

cursoragent · cursoragent · commit 48b9f130930f · 2025-06-09T18:49:31.000Z
diff --git a/JAVASCRIPT_LOGS_BETA_FIXES.md b/JAVASCRIPT_LOGS_BETA_FIXES.md
@@ -0,0 +1,121 @@
+# JavaScript Logs Beta Configuration Fixes
+
+This document summarizes all the fixes made to JavaScript platform documentation to ensure that when users select the "Logs Beta" checkbox, the corresponding logs setup code appears in the getting started configuration.
+
+## Issue Fixed
+
+The user reported that when selecting the "Logs Beta" checkbox for JavaScript SDKs, they didn't see the logs snippet being added to the getting started code. This was because while the logs configuration was added to the shared platform-includes files, many individual JavaScript platform guides were missing:
+
+1. `'logs-beta'` in their OnboardingOptionButtons options arrays
+2. The logs configuration code with proper product option markers
+
+## Solution
+
+Added `'logs-beta'` to OnboardingOptionButtons and the corresponding logs configuration (`_experiments: { enableLogs: true }`) with product option markers to all JavaScript platform documentation files.
+
+## Files Updated
+
+### 1. JavaScript Framework Guides
+
+#### Vue.js
+- **File**: `docs/platforms/javascript/guides/vue/index.mdx`
+- **Changes**: 
+  - Added `'logs-beta'` to OnboardingOptionButtons
+  - Added logs config to both Vue 3 and Vue 2 code blocks
+- **Configuration**: `_experiments: { enableLogs: true }`
+
+#### Svelte
+- **File**: `docs/platforms/javascript/guides/svelte/index.mdx`
+- **Changes**: 
+  - Added `'logs-beta'` to OnboardingOptionButtons
+  - Added logs config to both Svelte v5+ and v3-v4 code blocks
+- **Configuration**: `_experiments: { enableLogs: true }`
+
+#### Astro
+- **File**: `docs/platforms/javascript/guides/astro/index.mdx`
+- **Changes**: 
+  - Added `'logs-beta'` to OnboardingOptionButtons
+  - Added logs config to both client-side and server-side setup blocks
+- **Configuration**: `_experiments: { enableLogs: true }`
+
+#### Solid
+- **File**: `docs/platforms/javascript/guides/solid/index.mdx`
+- **Changes**: 
+  - Added `'logs-beta'` to OnboardingOptionButtons
+  - Added logs config to the main configuration block
+- **Configuration**: `_experiments: { enableLogs: true }`
+
+#### Capacitor
+- **File**: `docs/platforms/javascript/guides/capacitor/index.mdx`
+- **Changes**: 
+  - Added `'logs-beta'` to OnboardingOptionButtons
+  - Added logs config to all framework variations:
+    - Angular 14+
+    - Angular 12-13
+    - React
+    - Vue
+    - Nuxt
+- **Configuration**: `_experiments: { enableLogs: true }`
+
+### 2. Main JavaScript Platform Documentation
+
+#### JavaScript Common
+- **File**: `docs/platforms/javascript/common/index.mdx`
+- **Changes**: Added `'logs-beta'` to all OnboardingOptionButtons instances:
+  - Browser platforms: `["error-monitoring", "performance", "session-replay", "user-feedback", "logs-beta"]`
+  - Server platforms (non-Bun): `["error-monitoring", "performance", "profiling", "logs-beta"]`
+  - Bun platform: `["error-monitoring", "performance", "logs-beta"]`
+
+### 3. Previously Updated Files (Initial Implementation)
+
+These were already updated in the initial implementation:
+- `docs/platforms/javascript/guides/react/index.mdx` ✓
+- `docs/platforms/javascript/guides/nextjs/manual-setup.mdx` ✓
+- `platform-includes/getting-started-config/javascript.mdx` ✓
+
+### 4. Platform-Includes Configuration Files (Fixed in Previous Session)
+
+These shared configuration files were updated to include the logs-beta configuration:
+- `platform-includes/getting-started-config/javascript.node.mdx`
+- `platform-includes/getting-started-config/javascript.aws-lambda.mdx`
+- `platform-includes/getting-started-config/javascript.gcp-functions.mdx`
+- `platform-includes/getting-started-config/javascript.cloudflare.workers.mdx`
+- `platform-includes/getting-started-config/javascript.nestjs.mdx`
+
+### 5. Framework Guides Using Shared Content
+
+These frameworks use shared content includes (getting-started-node) and inherit the logs configuration automatically:
+- Express (`docs/platforms/javascript/guides/express/index.mdx`)
+- Koa (`docs/platforms/javascript/guides/koa/index.mdx`)
+- Node.js (`docs/platforms/javascript/guides/node/index.mdx`)
+
+### 6. Wizard-Based Frameworks
+
+These frameworks use installation wizards and don't have OnboardingOptionButtons in their main docs:
+- Angular (`docs/platforms/javascript/guides/angular/index.mdx`)
+- Remix (`docs/platforms/javascript/guides/remix/index.mdx`)
+- Next.js (main guide - uses wizard)
+
+## JavaScript Configuration Pattern
+
+All JavaScript SDKs now use this consistent logs configuration:
+
+```javascript
+// ___PRODUCT_OPTION_START___ logs-beta
+// Enable logs to be sent to Sentry
+_experiments: { enableLogs: true },
+// ___PRODUCT_OPTION_END___ logs-beta
+```
+
+## Result
+
+Now when users select the "Logs Beta" checkbox in any JavaScript SDK documentation, they will see the appropriate logs configuration code appear in their setup instructions. This includes:
+
+✅ **Browser Frameworks**: React, Vue, Svelte, Solid, Angular (via Capacitor)
+✅ **Full-Stack Frameworks**: Astro, SvelteKit, Next.js, Nuxt, Remix  
+✅ **Server Frameworks**: Node.js, Express, Koa, NestJS
+✅ **Runtime Environments**: Bun, Deno, Cloudflare Workers
+✅ **Serverless**: AWS Lambda, GCP Functions
+✅ **Mobile**: Capacitor (React, Vue, Angular variations)
+
+The logs snippet will properly show/hide based on the checkbox state, matching the behavior of other product options like performance monitoring and session replay.
diff --git a/docs/platforms/javascript/common/index.mdx b/docs/platforms/javascript/common/index.mdx
@@ -47,7 +47,7 @@ Select which Sentry features you'd like to install in addition to Error Monitori
 <PlatformCategorySection notSupported={["server"]}>
   <PlatformSection notSupported={["javascript", "javascript.cordova"]}>
     <OnboardingOptionButtons
-      options={["error-monitoring", "performance", "session-replay", "user-feedback"]}
+      options={["error-monitoring", "performance", "session-replay", "user-feedback", "logs-beta"]}
     />
   </PlatformSection>
 </PlatformCategorySection>
@@ -63,7 +63,7 @@ Select which Sentry features you'd like to install in addition to Error Monitori
 <PlatformCategorySection notSupported={["browser"]}>
   <PlatformSection notSupported={["javascript.bun"]}>
     <OnboardingOptionButtons
-      options={["error-monitoring", "performance", "profiling"]}
+      options={["error-monitoring", "performance", "profiling", "logs-beta"]}
     />
   </PlatformSection>
 
@@ -72,7 +72,7 @@ In addition to capturing errors, you can monitor interactions between multiple s
 Select which Sentry features you'd like to install in addition to Error Monitoring to get the corresponding installation and configuration instructions below.
 
   <PlatformSection supported={["javascript.bun"]}>
-    <OnboardingOptionButtons options={["error-monitoring", "performance"]} />
+    <OnboardingOptionButtons options={["error-monitoring", "performance", "logs-beta"]} />
   </PlatformSection>
 </PlatformCategorySection>
 
diff --git a/docs/platforms/javascript/guides/astro/index.mdx b/docs/platforms/javascript/guides/astro/index.mdx
@@ -26,7 +26,7 @@ Non-Node runtimes, like Vercel's Edge runtime or Cloudflare Pages, are currently
 
 ## Install
 
-<OnboardingOptionButtons options={["error-monitoring", "performance", "profiling", "session-replay", "user-feedback"]} />
+<OnboardingOptionButtons options={["error-monitoring", "performance", "profiling", "session-replay", "user-feedback", "logs-beta"]} />
 
 Sentry captures data by using an SDK within your application's runtime.
 
@@ -119,6 +119,11 @@ Sentry.init({
     }),
     // ___PRODUCT_OPTION_END___ user-feedback
   ],
+  // ___PRODUCT_OPTION_START___ logs-beta
+
+  // Enable logs to be sent to Sentry
+  _experiments: { enableLogs: true },
+  // ___PRODUCT_OPTION_END___ logs-beta
   // ___PRODUCT_OPTION_START___ performance
 
   // Define how likely traces are sampled. Adjust this value in production,
@@ -159,6 +164,11 @@ Sentry.init({
     nodeProfilingIntegration(),
   ],
   // ___PRODUCT_OPTION_END___ profiling
+  // ___PRODUCT_OPTION_START___ logs-beta
+
+  // Enable logs to be sent to Sentry
+  _experiments: { enableLogs: true },
+  // ___PRODUCT_OPTION_END___ logs-beta
   // ___PRODUCT_OPTION_START___ performance
 
   // Define how likely traces are sampled. Adjust this value in production,
diff --git a/docs/platforms/javascript/guides/capacitor/index.mdx b/docs/platforms/javascript/guides/capacitor/index.mdx
@@ -16,7 +16,7 @@ Select which Sentry features you'd like to install in addition to Error Monitori
 
 ## Install
 
-<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback"]} />
+<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback", "logs-beta"]} />
 
 Sentry captures data by using an SDK within your application's runtime.
 
@@ -137,6 +137,11 @@ Sentry.init(
       }),
       // ___PRODUCT_OPTION_END___ user-feedback
     ],
+    // ___PRODUCT_OPTION_START___ logs-beta
+
+    // Enable logs to be sent to Sentry
+    _experiments: { enableLogs: true },
+    // ___PRODUCT_OPTION_END___ logs-beta
     // ___PRODUCT_OPTION_START___ performance
 
     // Set tracesSampleRate to 1.0 to capture 100%
@@ -223,6 +228,11 @@ Sentry.init(
       // ___PRODUCT_OPTION_END___ user-feedback
     ],
 
+    // ___PRODUCT_OPTION_START___ logs-beta
+
+    // Enable logs to be sent to Sentry
+    _experiments: { enableLogs: true },
+    // ___PRODUCT_OPTION_END___ logs-beta
     // ___PRODUCT_OPTION_START___ performance
     // Set tracesSampleRate to 1.0 to capture 100%
     // of transactions for tracing.
@@ -304,6 +314,11 @@ Sentry.init(
       }),
       // ___PRODUCT_OPTION_END___ user-feedback
     ],
+    // ___PRODUCT_OPTION_START___ logs-beta
+
+    // Enable logs to be sent to Sentry
+    _experiments: { enableLogs: true },
+    // ___PRODUCT_OPTION_END___ logs-beta
     // ___PRODUCT_OPTION_START___ performance
 
     // Set tracesSampleRate to 1.0 to capture 100%
@@ -370,6 +385,11 @@ Sentry.init(
       }),
       // ___PRODUCT_OPTION_END___ user-feedback
     ],
+    // ___PRODUCT_OPTION_START___ logs-beta
+
+    // Enable logs to be sent to Sentry
+    _experiments: { enableLogs: true },
+    // ___PRODUCT_OPTION_END___ logs-beta
     // ___PRODUCT_OPTION_START___ performance
 
     // Set tracesSampleRate to 1.0 to capture 100%
@@ -433,6 +453,11 @@ Sentry.init(
       }),
       // ___PRODUCT_OPTION_END___ user-feedback
     ],
+    // ___PRODUCT_OPTION_START___ logs-beta
+
+    // Enable logs to be sent to Sentry
+    _experiments: { enableLogs: true },
+    // ___PRODUCT_OPTION_END___ logs-beta
     // ___PRODUCT_OPTION_START___ performance
 
     // Set tracesSampleRate to 1.0 to capture 100%
diff --git a/docs/platforms/javascript/guides/solid/index.mdx b/docs/platforms/javascript/guides/solid/index.mdx
@@ -16,7 +16,7 @@ Select which Sentry features you'd like to install in addition to Error Monitori
 
 ## Install
 
-<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback"]} />
+<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback", "logs-beta"]} />
 
 Sentry captures data by using an SDK within your application's runtime.
 
@@ -75,6 +75,11 @@ if (!DEV) {
       }),
       // ___PRODUCT_OPTION_END___ user-feedback
     ],
+    // ___PRODUCT_OPTION_START___ logs-beta
+
+    // Enable logs to be sent to Sentry
+    _experiments: { enableLogs: true },
+    // ___PRODUCT_OPTION_END___ logs-beta
     // ___PRODUCT_OPTION_START___ performance
 
     // Set tracesSampleRate to 1.0 to capture 100%
diff --git a/docs/platforms/javascript/guides/svelte/index.mdx b/docs/platforms/javascript/guides/svelte/index.mdx
@@ -14,7 +14,7 @@ categories:
 Choose the features you want to configure, and this guide will show you how:
 
 <OnboardingOptionButtons
-  options={["error-monitoring", "performance", "session-replay", "user-feedback"]}
+  options={["error-monitoring", "performance", "session-replay", "user-feedback", "logs-beta"]}
 />
 
 <PlatformContent includePath="getting-started-features-expandable" />
@@ -68,6 +68,11 @@ Sentry.init({
     }),
     // ___PRODUCT_OPTION_END___ user-feedback
   ],
+  // ___PRODUCT_OPTION_START___ logs-beta
+
+  // Enable logs to be sent to Sentry
+  _experiments: { enableLogs: true },
+  // ___PRODUCT_OPTION_END___ logs-beta
   // ___PRODUCT_OPTION_START___ performance
 
   // Set tracesSampleRate to 1.0 to capture 100%
@@ -121,6 +126,11 @@ Sentry.init({
     }),
     // ___PRODUCT_OPTION_END___ user-feedback
   ],
+  // ___PRODUCT_OPTION_START___ logs-beta
+
+  // Enable logs to be sent to Sentry
+  _experiments: { enableLogs: true },
+  // ___PRODUCT_OPTION_END___ logs-beta
   // ___PRODUCT_OPTION_START___ performance
 
   // Set tracesSampleRate to 1.0 to capture 100%
diff --git a/docs/platforms/javascript/guides/vue/index.mdx b/docs/platforms/javascript/guides/vue/index.mdx
@@ -16,7 +16,7 @@ Select which Sentry features you'd like to install in addition to Error Monitori
 
 ## Install
 
-<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback"]} />
+<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback", "logs-beta"]} />
 
 Sentry captures data by using an SDK within your application's runtime.
 
@@ -72,6 +72,11 @@ Sentry.init({
     }),
     // ___PRODUCT_OPTION_END___ user-feedback
   ],
+  // ___PRODUCT_OPTION_START___ logs-beta
+
+  // Enable logs to be sent to Sentry
+  _experiments: { enableLogs: true },
+  // ___PRODUCT_OPTION_END___ logs-beta
   // ___PRODUCT_OPTION_START___ performance
 
   // Set tracesSampleRate to 1.0 to capture 100%
@@ -127,6 +132,11 @@ Sentry.init({
     }),
     // ___PRODUCT_OPTION_END___ user-feedback
   ],
+  // ___PRODUCT_OPTION_START___ logs-beta
+
+  // Enable logs to be sent to Sentry
+  _experiments: { enableLogs: true },
+  // ___PRODUCT_OPTION_END___ logs-beta
   // ___PRODUCT_OPTION_START___ performance
 
   // Set tracesSampleRate to 1.0 to capture 100%
