Skip to content

🛡️ Sentry

Link error tracking to your EAS project.

🔑 Create Sentry Project

1. Link via Expo Dashboard

  1. Go to expo.dev and login
  2. Navigate to your project
  3. Go to Settings → General
  4. Click "Link Sentry"
  5. This will automatically create a Sentry project or link existing one

2. Alternative: Manual Setup

If you prefer manual setup:

  1. Go to sentry.io
  2. Create free account
  3. Create new project
  4. Select React Native
  5. Name it the same as your EAS project

3. Get DSN

  1. In your Sentry project, go to Settings → Client Keys (DSN)
  2. Click "Configure manually"
  3. Copy your DSN and add it to your .env.local file:
EXPO_PUBLIC_SENTRY_DSN=https://your-dsn@sentry.io/project-id

4. Get Auth Token

  1. In Sentry, go to Settings → General Settings
  2. Scroll down to Personal Tokens
  3. Click "Create New Token"
  4. Token name: ExpoBase Token
  5. Scopes: Select project
  6. Click "Create Token"
  7. Copy the token and add it to your .env.local file:
SENTRY_AUTH_TOKEN=sntryu_your_auth_token

5. Configure Sentry Plugin

Add this plugin to your app.json:

{
  "expo": {
    "plugins": [
      [
        "@sentry/react-native/expo",
        {
          "url": "https://sentry.io/",
          "note": "Use SENTRY_AUTH_TOKEN env to authenticate with Sentry.",
          "project": "your-project-name",
          "organization": "your-organization-name"
        }
      ]
    ]
  }
}

Important: Replace your-project-name and your-organization-name with your actual Sentry project and organization names.

6. Disable Auto Upload (Development)

Add this to your .env.local file to disable auto upload during development:

SENTRY_DISABLE_AUTO_UPLOAD=true

⚙️ Configuration Ready

Sentry is already configured in ExpoBase! The integration includes:

  • Crash reporting
  • Error boundaries
  • Performance monitoring
  • Release tracking

✅ Environment Updated

Your .env.local should now include:

EXPO_PUBLIC_SENTRY_DSN=https://...
SENTRY_AUTH_TOKEN=sntryu_...
SENTRY_DISABLE_AUTO_UPLOAD=true

💡 Production Builds: For production builds, you'll need to add ALL your environment variables to expo.dev → Your Project → Settings → Environment variables.

🎯 Next Step

Continue to 💳 Stripe to configure payments.

Step 6/11 Complete ✅

Sentry linked to EAS project!

📚 Additional Resources

Official Documentation

  • 📖 Expo Sentry Guide - Complete guide to integrating Sentry with Expo for error tracking and performance monitoring