Sentry Sdk Setup

1---2name: sentry-sdk-setup3description: Set up Sentry in any language or framework. Detects the user's platform and loads the right SDK skill. Use when asked to add Sentry, install an SDK, or set up error monitoring in a project.4license: Apache-2.05role: router6---7 8> [All Skills](../../SKILL_TREE.md)9 10# Sentry SDK Setup11 12Set up Sentry error monitoring, tracing, and session replay in any language or framework. This page helps you find the right SDK skill for your project.13 14## How to Fetch Skills15 16Use `curl` to download skills — they are 10–20 KB files that fetch tools often summarize, losing critical details.17 18    curl -sL https://skills.sentry.dev/sentry-nextjs-sdk/SKILL.md19 20Append the path from the `Path` column in the table below to `https://skills.sentry.dev/`. Do not guess or shorten URLs.21 22## Start Here — Read This Before Doing Anything23 24**Do not skip this section.** Do not assume which SDK the user needs based on their project files. Do not start installing packages or creating config files until you have confirmed the user's intent.25 261. **Detect the platform** from project files (`package.json`, `go.mod`, `requirements.txt`, `Gemfile`, `*.csproj`, `build.gradle`, etc.).272. **Tell the user what you found** and which SDK you recommend.283. **Wait for confirmation** before fetching the skill and proceeding.29 30Each SDK skill contains its own detection logic, prerequisites, and step-by-step configuration. Trust the skill — read it carefully and follow it. Do not improvise or take shortcuts.31 32---33 34## SDK Skills35 36| Platform | Skill | Path |37|---|---|---|38| Android | [`sentry-android-sdk`](../sentry-android-sdk/SKILL.md) | `sentry-android-sdk/SKILL.md` |39| browser JavaScript | [`sentry-browser-sdk`](../sentry-browser-sdk/SKILL.md) | `sentry-browser-sdk/SKILL.md` |40| Cloudflare Workers and Pages | [`sentry-cloudflare-sdk`](../sentry-cloudflare-sdk/SKILL.md) | `sentry-cloudflare-sdk/SKILL.md` |41| Apple platforms (iOS, macOS, tvOS, watchOS, visionOS) | [`sentry-cocoa-sdk`](../sentry-cocoa-sdk/SKILL.md) | `sentry-cocoa-sdk/SKILL.md` |42| .NET | [`sentry-dotnet-sdk`](../sentry-dotnet-sdk/SKILL.md) | `sentry-dotnet-sdk/SKILL.md` |43| Elixir | [`sentry-elixir-sdk`](../sentry-elixir-sdk/SKILL.md) | `sentry-elixir-sdk/SKILL.md` |44| Go | [`sentry-go-sdk`](../sentry-go-sdk/SKILL.md) | `sentry-go-sdk/SKILL.md` |45| NestJS | [`sentry-nestjs-sdk`](../sentry-nestjs-sdk/SKILL.md) | `sentry-nestjs-sdk/SKILL.md` |46| Next.js | [`sentry-nextjs-sdk`](../sentry-nextjs-sdk/SKILL.md) | `sentry-nextjs-sdk/SKILL.md` |47| Node.js, Bun, and Deno | [`sentry-node-sdk`](../sentry-node-sdk/SKILL.md) | `sentry-node-sdk/SKILL.md` |48| PHP | [`sentry-php-sdk`](../sentry-php-sdk/SKILL.md) | `sentry-php-sdk/SKILL.md` |49| Python | [`sentry-python-sdk`](../sentry-python-sdk/SKILL.md) | `sentry-python-sdk/SKILL.md` |50| Flutter and Dart | [`sentry-flutter-sdk`](../sentry-flutter-sdk/SKILL.md) | `sentry-flutter-sdk/SKILL.md` |51| React Native and Expo | [`sentry-react-native-sdk`](../sentry-react-native-sdk/SKILL.md) | `sentry-react-native-sdk/SKILL.md` |52| React | [`sentry-react-sdk`](../sentry-react-sdk/SKILL.md) | `sentry-react-sdk/SKILL.md` |53| Ruby | [`sentry-ruby-sdk`](../sentry-ruby-sdk/SKILL.md) | `sentry-ruby-sdk/SKILL.md` |54| Svelte and SvelteKit | [`sentry-svelte-sdk`](../sentry-svelte-sdk/SKILL.md) | `sentry-svelte-sdk/SKILL.md` |55 56### Platform Detection Priority57 58When multiple SDKs could match, prefer the more specific one:59 60- **Android** (`build.gradle` with android plugin) → `sentry-android-sdk`61- **Cloudflare** (`wrangler.toml` or `wrangler.jsonc`) → `sentry-cloudflare-sdk` over `sentry-node-sdk`62- **NestJS** (`@nestjs/core`) → `sentry-nestjs-sdk` over `sentry-node-sdk`63- **Next.js** → `sentry-nextjs-sdk` over `sentry-react-sdk` or `sentry-node-sdk`64- **Flutter** (`pubspec.yaml` with `flutter:` dependency or `sentry_flutter`) → `sentry-flutter-sdk`65- **React Native** → `sentry-react-native-sdk` over `sentry-react-sdk`66- **PHP** with Laravel or Symfony → `sentry-php-sdk`67- **Elixir** (`mix.exs` detected) → `sentry-elixir-sdk`68- **Node.js / Bun / Deno** without a specific framework → `sentry-node-sdk`69- **Browser JS** (vanilla, jQuery, static sites) → `sentry-browser-sdk`70- **No match** → direct user to [Sentry Docs](https://docs.sentry.io/platforms/)71 72## Quick Lookup73 74Match your project to a skill by keywords. Append the path to `https://skills.sentry.dev/` to fetch.75 76| Keywords | Path |77|---|---|78| android, kotlin, java, jetpack compose | `sentry-android-sdk/SKILL.md` |79| browser, vanilla js, javascript, jquery, cdn, wordpress, static site | `sentry-browser-sdk/SKILL.md` |80| cloudflare, cloudflare workers, cloudflare pages, wrangler, durable objects, d1 | `sentry-cloudflare-sdk/SKILL.md` |81| ios, macos, swift, cocoa, tvos, watchos, visionos, swiftui, uikit | `sentry-cocoa-sdk/SKILL.md` |82| .net, csharp, c#, asp.net, maui, wpf, winforms, blazor, azure functions | `sentry-dotnet-sdk/SKILL.md` |83| go, golang, gin, echo, fiber | `sentry-go-sdk/SKILL.md` |84| elixir, phoenix, plug, oban | `sentry-elixir-sdk/SKILL.md` |85| nestjs, nest | `sentry-nestjs-sdk/SKILL.md` |86| nextjs, next.js, next | `sentry-nextjs-sdk/SKILL.md` |87| node, nodejs, node.js, bun, deno, express, fastify, koa, hapi | `sentry-node-sdk/SKILL.md` |88| php, laravel, symfony | `sentry-php-sdk/SKILL.md` |89| python, django, flask, fastapi, celery, starlette | `sentry-python-sdk/SKILL.md` |90| flutter, dart, pubspec | `sentry-flutter-sdk/SKILL.md` |91| react native, expo | `sentry-react-native-sdk/SKILL.md` |92| react, react router, tanstack, redux, vite | `sentry-react-sdk/SKILL.md` |93| ruby, rails, sinatra, sidekiq, rack | `sentry-ruby-sdk/SKILL.md` |94| svelte, sveltekit | `sentry-svelte-sdk/SKILL.md` |95 96---97 98## Finding the DSN99 100If the user doesn't have their DSN, guide them to find it:101 1021. Open the Sentry project settings page: `https://sentry.io/settings/projects/`1032. Select the project1043. Click **"Client Keys (DSN)"** in the left sidebar1054. Copy the DSN106 107You can help the user open the page directly:108```bash109open https://sentry.io/settings/projects/        # macOS110xdg-open https://sentry.io/settings/projects/    # Linux111start https://sentry.io/settings/projects/        # Windows112```113 114> **Note:** The DSN is public and safe to include in source code. It is not a secret — it only identifies where to send events.115 116---117 118Looking for workflows or feature configuration instead? See the [full Skill Tree](../../SKILL_TREE.md).