---
name: sentry-project-setup
description: Set up Sentry for a new app or service by creating or picking the team and project, getting the DSN, and walking through SDK install, release tracking and source maps from Sentry's docs. Use when the user asks to add Sentry to a project, create a Sentry project, or get a DSN.
---

# Set up Sentry for an app

## Steps

1. Identify the platform from the user's repo or words, such as Next.js, Django, React Native or Go.
2. Check what exists with `find_teams`, `find_projects` and `find_dsns`, to avoid duplicate projects.
3. If a new project is needed, propose the team, project name and platform. After the user approves, create it with `create_team` (only if no team fits) and `create_project`, and adjust settings with `update_project` when asked. Use `create_dsn` only when the user wants a separate key, for example per environment.
4. Fetch the setup guide for that platform with `search_docs` and `get_doc`. Follow the current docs, not memory: SDK init, environment, release name, and source maps or debug symbols.
5. When the repo is open, propose the exact code and config changes. Keep the DSN in an environment variable, not hard-coded.
6. Verify by asking the user to trigger a test error, then confirm it arrived with `find_issues`.

## Report

The project, DSN location and the files changed, plus what remains, such as uploading source maps in CI.