---
title: "Spotlight"
description: "Forward Sentry events to Spotlight for local debugging during development."
url: https://docs.sentry.io/platforms/react-native/integrations/spotlight/
---

# Spotlight | Sentry for React Native

*(Available in version 6.0.0 and above)*

*Import name: `Sentry.spotlightIntegration`*

The `spotlightIntegration` forwards Sentry events to [Spotlight](https://spotlightjs.com/), a local debugging tool that lets you inspect errors, traces, and other Sentry data during development.

##### Note

When using the `spotlight` option in `Sentry.init()`, the integration is only added in development (`__DEV__` mode). If you add the integration manually via the `integrations` array, it will be active in any environment.

## [Setup](https://docs.sentry.io/platforms/react-native/integrations/spotlight.md#setup)

Enable Spotlight by passing `spotlight: true` in your `Sentry.init()` options (recommended — this ensures it is only active in development):

**javascript**

```javascript
import * as Sentry from "@sentry/react-native";

Sentry.init({
  dsn: "___PUBLIC_DSN___",
  spotlight: true,
});
```

By default, the integration connects to a Spotlight Sidecar at `http://localhost:8969/stream`. If your Sidecar runs at a different URL, pass it directly:

**javascript**

```javascript
Sentry.init({
  dsn: "___PUBLIC_DSN___",
  spotlight: "http://my-host:8969/stream",
});
```

The integration auto-detects the dev server hostname when available, so it works with devices and emulators connected to your development machine.

## [How It Works](https://docs.sentry.io/platforms/react-native/integrations/spotlight.md#how-it-works)

When enabled, the integration intercepts envelopes before they are sent to Sentry and forwards them to the Spotlight Sidecar via HTTP. Events are still sent to Sentry as normal — Spotlight receives a copy for local inspection.
