# React

This is an example project showing how to use `@bugsnag/js` with a React project.

This project was bootstrapped with [`create-react-app`](https://github.com/facebook/create-react-app).

## Usage

Clone the repo and `cd` into the directory of this example:

```
git clone git@github.com:bugsnag/bugsnag-js.git
cd bugsnag-js/examples/js/react
```
Take a look at…
- [`src/index.js`](src/index.js) to see how to setup Bugsnag once for your application and how the `ErrorBoundary` is used
- [`src/components/BadButtons.js`](src/components/BadButtons.js) to see how the errors are triggered

### With docker

The project includes a `Dockerfile`. If you're familiar with docker, this is the easiest way to start the example. Otherwise, skip ahead to the [without docker](#without-docker) section.

```
docker build -t bugsnag-js-example-react . && \
docker run -p 5000:5000 -it bugsnag-js-example-react
```

__Note__: remember to replace `YOUR_API_KEY` in `src/lib/bugsnag.js` with your own!

### Without docker

Ensure you have a version of Node.js >=4 on your machine.

```
npm install
npm run serve
```
__Note__: remember to replace `YOUR_API_KEY` in `src/index.js` with your own!