Back to Skills

sentry-flutter-sdk

Full Sentry SDK setup for Flutter and Dart. Use when asked to "add Sentry to Flutter", "install sentry_flutter", "setup Sentry in Dart", or configure error monitoring, tracing, profiling, session replay, or logging for Flutter applications. Supports Android, iOS, macOS, Linux, Windows, and Web.

243stars30forksUpdated 7/27/2026

Security Assessment

Safe(94/100)
Security Score94/100

About sentry-flutter-sdk

This skill is an opinionated setup wizard for adding the Sentry SDK to Flutter and Dart applications. It solves the problem of correctly and completely instrumenting a Flutter app for observability, covering error monitoring, tracing, profiling, session replay, logging, metrics, and ecosystem integrations, while accounting for the many platform-specific limitations across Android, iOS, macOS, Linux, Windows, and Web. It targets sentry_flutter version 9.14.0 and newer and repeatedly directs the user to verify against the official Sentry documentation before implementing.

The workflow is phased. In a Detect phase it runs read-only inspection commands against the project (grep and cat over pubspec.yaml and the lib directory, ls of platform directories) to determine whether Sentry is already installed, which Dart SDK version is present, and which navigation, HTTP, database, state-management, GraphQL, and Firebase packages are in use, so it can recommend matching integrations. In a Recommend phase it leads with a concrete proposal rather than open-ended questions, distinguishing always-on core coverage from optional enhancements and being upfront about which features are unavailable on which platforms. Detailed reference files cover logging (the Sentry.logger API, the sentry_logging bridge to the Dart logging package, structured attributes, and log-to-trace correlation), session replay, error monitoring, profiling, metrics, tracing, and ecosystem integrations.

It is aimed at Flutter and Dart developers who want production-grade crash and performance monitoring wired in correctly. The DSN and configuration values shown are standard Sentry client setup, not secrets to exfiltrate, and the detection commands are strictly read-only inspection of the local project.

FAQ

Which SDK version and platforms does this target?

It reflects sentry_flutter 9.14.0 and newer (current stable as of February 2026) and supports Android, iOS, macOS, Linux, Windows, and Web. The skill advises verifying APIs against the official Sentry Flutter docs before implementing.

What are the platform limitations to know about?

Session Replay is iOS and Android only; Profiling is iOS and macOS only and in alpha; native crash capture is iOS, Android, and macOS, while Linux, Windows, and Web get Dart exceptions only; App Start metrics are mobile-only. The skill surfaces these upfront.

Does it change my project automatically?

It first runs read-only detection commands to understand your pubspec.yaml, existing Sentry init, navigation/HTTP/DB/state packages, and platform targets, then presents a concrete recommendation. Setup follows from that, so if Sentry is already present it skips install and jumps to feature configuration.

How is logging handled?

Structured logs require enableLogs (off by default) and sentry_flutter 9.5.0 or newer. You can emit logs directly via Sentry.logger at six severity levels, or bridge the Dart logging package via the sentry_logging integration, with configurable breadcrumb, log, and event levels.

All Files

8 files
references/logging.md11.8 KB
View
references/session-replay.md11.1 KB
View
references/error-monitoring.md8.3 KB
View
references/profiling.md8.3 KB
View
SKILL.md27.5 KB
View
references/ecosystem-integrations.md2.7 KB
View
references/metrics.md9.4 KB
View
references/tracing.md13.9 KB
View

Install sentry-flutter-sdk

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill