rsnext/examples/with-sentry
Nick Babcock 5629223407
Update examples to use React 17 (#26133)
[With next 11 requiring react 17](https://nextjs.org/blog/next-11#upgrade-guide), most of the examples
need to be updated, so the following snippet updated all the examples to
a compatible react version.

```bash
cd examples/
fd -g 'package.json' | xargs sed -r -i 's/"react": ".*"/"react": "^17.0.2"/
fd -g 'package.json' | xargs sed -r -i 's/"react-dom": ".*"/"react-dom": "^17.0.2"/'

# exclude experimental react version
git checkout with-reason-relay/package.json
```
2021-06-16 16:43:26 +00:00
..
pages Update example with-sentry (#24819) 2021-05-07 12:52:03 +00:00
.gitignore Added .gitignore to examples that are deployed to vercel (#15127) 2020-07-16 10:52:23 -04:00
next.config.js Update example with-sentry (#24819) 2021-05-07 12:52:03 +00:00
package.json Update examples to use React 17 (#26133) 2021-06-16 16:43:26 +00:00
README.md docs: add 'Open in StackBlitz' buttons to various examples (#25853) 2021-06-08 20:45:02 +00:00
sentry.client.config.js Update example with-sentry (#24819) 2021-05-07 12:52:03 +00:00
sentry.properties Update example with-sentry (#24819) 2021-05-07 12:52:03 +00:00
sentry.server.config.js Update example with-sentry (#24819) 2021-05-07 12:52:03 +00:00

Sentry

This is an example showing how to use Sentry to catch & report errors on both client + server side, using the official Sentry SDK for Next.js.

  • _app.js renders on both the server and client
  • _error.js is rendered by Next.js while handling certain types of exceptions for you. It is overridden so those exceptions can be passed along to Sentry
  • Each API route is handled with withSentry
  • next.config.js automatically configures the app to use Sentry through withSentry

Preview

Preview the example live on StackBlitz:

Open in StackBlitz

Deploy your own

Once you have access to your Sentry DSN, deploy the example using Vercel:

Deploy with Vercel

Check out Sentrys Vercel Integration.

How To Use

Execute create-next-app with npm or Yarn to bootstrap the example:

npx create-next-app --example with-sentry with-sentry-app
# or
yarn create next-app --example with-sentry with-sentry-app

Configuration

You can configure your app automatically or do the manual setup. Both ways lead to having your custom config files (next.config.js, sentry.client.config.js, sentry.server.config.js, and sentry.properties); so you can delete them from the example, they are here to illustrate how an example app looks like.

Deploy on Vercel

You can deploy this app to the cloud with Vercel (Documentation).

Deploy Your Local Project

To deploy your local project to Vercel, push it to GitHub/GitLab/Bitbucket and import to Vercel.

Important: When you import your project on Vercel, make sure to click on Environment Variables and set them to match your .env.local file.

Deploy from Our Template

Alternatively, you can deploy using our template by clicking on the Deploy button below.

Deploy with Vercel

Sentry Integration

Sentrys Vercel Integration connects your Sentry and Vercel projects to automatically upload source maps and notify Sentry of release deployment. Learn more about this integration in Sentrys full documentation.