Release notes

Beta

This page documents Bugsee React Native SDK 7.x, which is in beta and can change between betas. The stable release is 6.x: see the 6.x documentation. Upgrading? See Migrating from 6.x to 7.x.

Release history for Bugsee React Native SDK 7.x: @bugsee/react-native and @bugsee/react-native-feedback, which are released together at the same version. Looking for the stable release? See the 6.x release notes. Upgrading from 6.x? See the migration guide.

Each release lists the native SDKs it is built on. Their own changes are in the native SDK release notes: Android and iOS 7.x.

7.0.0-beta3 (October 20 2026)

Fixes the package's shell scripts, which 7.0.0-beta1 and 7.0.0-beta2 published without the executable bit.

Fixes

• Release builds work without a chmod. scripts/bugsee-xcode.sh and scripts/hermesc-preserve-js.sh (and the two Node scripts next to them) are now published as executable. Android Release builds on macOS and Linux, and the bundle phase of a bare iOS app, no longer fail with "Permission denied". If you added the chmod +x workaround for 7.0.0-beta1 or 7.0.0-beta2, you can remove it after upgrading. The release process now packs with npm pack and fails if a file that is executable in the repository is not executable in the package.
• @bugsee/react-native-feedback requires @bugsee/react-native ^7.0.0-beta3.

Compatibility

• Android: Bugsee Android SDK 7.4.2, Bugsee Gradle plugin 4.0.8.
• iOS: Bugsee iOS SDK 7.0.0-beta7.
• @bugsee/cli 0.7.12.

7.0.0-beta2 (October 19 2026)

launch and relaunch take the options object as is.

Changes

• No serialize step. Bugsee.launch(token, options) and Bugsee.relaunch(options) accept the object from createDefaultLaunchOptions() directly. They still accept the plain map of com.bugsee.option.* keys, and BugseeLaunchOptions.serialize(options) still returns that map, so code written for 7.0.0-beta1 keeps working. See Configuration.

  import Bugsee, { createDefaultLaunchOptions } from '@bugsee/react-native';
  
  const options = createDefaultLaunchOptions();
  options.captureLogs = true;
  
  // 7.0.0-beta1: Bugsee.launch(token, BugseeLaunchOptions.serialize(options));
  Bugsee.launch(token, options);

• npm tags. The latest and beta tags both point at this beta, so a plain yarn add @bugsee/react-native installs it. Install with @beta to keep following betas once a stable 7.x release exists. See Installation.

• @bugsee/react-native-feedback requires @bugsee/react-native ^7.0.0-beta2.

Known issues

• The package's shell scripts (scripts/bugsee-xcode.sh, scripts/hermesc-preserve-js.sh) are published without the executable bit. Android Release builds on macOS and Linux, and the bundle phase of a bare iOS app, fail with "Permission denied" until you run chmod +x node_modules/@bugsee/react-native/scripts/*.sh. Fixed in 7.0.0-beta3. See Symbolication: Android and Symbolication: iOS.

Compatibility

• Android: Bugsee Android SDK 7.4.2, Bugsee Gradle plugin 4.0.8.
• iOS: Bugsee iOS SDK 7.0.0-beta7.
• @bugsee/cli 0.7.12.

7.0.0-beta1 (October 19 2026)

The first public beta of the rewritten React Native SDK. @bugsee/react-native replaces react-native-bugsee 6.x: it is a new package with a new API, built on the 7.x native SDKs. See Migrating from 6.x to 7.x.

Highlights

• Requirements: React Native 0.81 or later with the New Architecture, Hermes, iOS 15.0 or later, Android API 21 or later. See Overview.
• One package with the native SDKs. Autolinking adds the Android SDK with its NDK and OkHttp modules; on iOS the SDK comes through the package's Package.swift (React Native 0.87 and later) or its podspec. See Installation.
• One options namespace. Both platforms read the same com.bugsee.option.* keys, set through createDefaultLaunchOptions() or a plain map. In this beta, launch and relaunch take the plain map, so an options object is passed as BugseeLaunchOptions.serialize(options). See Configuration.
• Lifecycle: launch and relaunch resolve to whether the SDK started, attach() for Android auto-launch, getStatus(), onStatusChange() and onLifecycleEvent() with named events. See Lifecycle & status.
• Crash and error reporting: uncaught JavaScript errors, unhandled promise rejections, uncaught render errors through Bugsee.wrap(App), native crashes, logException(error, { domain }), logUnhandledException() and <ErrorBoundary>. See Crash & error reporting.
• Reports: showReportDialog(), upload(), createReport() and a report handler that reads and changes reports and adds attachments.
• Data capture: console logs with a native-side filter, network events with a filter and addNetworkEvent(), breadcrumbs, custom events and traces, attributes and a user identifier.
• Privacy: <BugseeSecure>, setSecureRectangles(), blackout, and filters for logs, network events and breadcrumbs. See Privacy.
• Performance monitoring: transactions and spans from JavaScript. See Performance monitoring.
• Notification relay: notify(). See Notification relay.
• Appearance: one camelCase surface for the report UI colors. See Appearance.
• Feedback in its own package, @bugsee/react-native-feedback. See Feedback.
• Expo config plugin for prebuild: the Bugsee Gradle plugin, the source-map hooks, the dSYM post-action, Android auto-launch and a custom endpoint. See Expo.
• Symbolication: JavaScript source maps matched by debug ID, the Android R8 mapping and native symbols through the Bugsee Gradle plugin, and iOS dSYMs, optionally with React Native's own. See Symbolication.

Known issues

• The package's shell scripts (scripts/bugsee-xcode.sh, scripts/hermesc-preserve-js.sh) are published without the executable bit. Android Release builds on macOS and Linux, and the bundle phase of a bare iOS app, fail with "Permission denied" until you run chmod +x node_modules/@bugsee/react-native/scripts/*.sh. Fixed in 7.0.0-beta3. See Symbolication: Android and Symbolication: iOS.

Compatibility

• Android: Bugsee Android SDK 7.4.2, Bugsee Gradle plugin 4.0.8.
• iOS: Bugsee iOS SDK 7.0.0-beta7, itself a beta.
• @bugsee/cli 0.7.12.