Manual integration guide

Integrate BugSnag into your Expo app without using the CLI.

This documentation is for version 6 of the BugSnag JavaScript notifier. We recommend upgrading to the latest release using our Upgrade guide. Documentation for the current release can be found here.


Install the @bugsnag/expo package with your preferred npm client, adding it to your dependencies:

# npm
npm install @bugsnag/expo

# yarn
yarn add @bugsnag/expo

If you’re using Expo SDK <33 you must use @bugsnag/expo 6.3.0. If you’re using Expo SDK <36 you must use @bugsnag/expo 6.4.4. If you’re using Expo SDK <37 you must use @bugsnag/expo 6.5.3.

Otherwise, please use the latest release.

Basic configuration

We recommend putting your API key in app.json and having BugSnag pick it up automatically. In this location the postPublish hook will pick up too.


  "extra": {
    "bugsnag": {
      "apiKey": "YOUR_API_KEY"
import bugsnag from '@bugsnag/expo'
const bugsnagClient = bugsnag()

Alternatively you can configure the client by providing your API key as a string:

import bugsnag from '@bugsnag/expo'
const bugsnagClient = bugsnag('YOUR_API_KEY')

To specify any additional configuration options, supply an object instead:

var bugsnagClient = bugsnag({
  otherOptions: value

See configuration options for more information.

Capturing React render errors

An error boundary component is included which you can use to wrap your application. When render errors happen, they will be reported to BugSnag along with any React-specific info that was available at the time.

To catch all render errors in your application and show a custom error screen to your users, follow this example:

const ErrorBoundary = bugsnagClient.getPlugin('react')

export default () =>
  <ErrorBoundary FallbackComponent={ErrorView}>
    <App />

class App extends React.Component {
  // Your main app component

class ErrorView extends React.Component {
  // This component will be displayed when an error boundary catches an error

See React’s documentation on Error Boundaries to find out more.

Post-publish hook

To notify BugSnag of releases, and to upload source maps so that you’ll see full stacktraces, we provide a postPublish hook specifically for Expo.

To tell Expo to use this hook in your application, insert the following into your app.json:

  "expo": {
    "extra": {
      "bugsnag": {
        "apiKey": "YOUR_API_KEY"
    "hooks": {
      "postPublish": [
          "file": "@bugsnag/expo/hooks/post-publish.js",
          "config": {

            For BugSnag On-premise, the endpoints for each of
            the hook's components will need to be set:

            "sourceMapUploader": { "endpoint": "" },
            "buildReporter": { "endpoint": "" }


Once this configuration is in place, every time you publish (expo publish) or build a standalone app (expo build:ios|android) your release will be reported to BugSnag, along with its source maps.