<p align="center">
<a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
<img src="https://sentry-brand.storage.googleapis.com/sentry-wordmark-dark-280x84.png" alt="Sentry" width="280" height="84">
</a>
<a href="https://flutter.dev/docs/development/packages-and-plugins/favorites" target="_blank">
<img src="https://github.com/getsentry/sentry-dart/raw/main/.github/flutter_favorite.svg" width="100">
</a>
</p>
_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us [<kbd>**Check out our open positions**</kbd>](https://sentry.io/careers/)_
# Sentry SDK for Dart and Flutter
[](https://codecov.io/gh/getsentry/sentry-dart)
| Package | CI status | Likes | Downloads | Analysis |
| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| [](https://pub.dev/packages/sentry) | [](https://github.com/getsentry/sentry-dart/actions/workflows/dart.yml) | [](https://pub.dev/packages/sentry/score) | [](https://pub.dev/packages/sentry/score) | [](https://pub.dev/packages/sentry/score) |
| [](https://pub.dev/packages/sentry_flutter) | [](https://github.com/getsentry/sentry-dart/actions/workflows/flutter.yml) | [](https://pub.dev/packages/sentry_flutter/score) | [](https://pub.dev/packages/sentry_flutter/score) | [](https://pub.dev/packages/sentry_flutter/score) |
| [](https://pub.dev/packages/sentry_logging) | [](https://github.com/getsentry/sentry-dart/actions/workflows/logging.yml) | [](https://pub.dev/packages/sentry_logging/score) | [](https://pub.dev/packages/sentry_logging/score) | [](https://pub.dev/packages/sentry_logging/score) |
| [](https://pub.dev/packages/sentry_dio) | [](https://github.com/getsentry/sentry-dart/actions/workflows/dio.yml) | [](https://pub.dev/packages/sentry_dio/score) | [](https://pub.dev/packages/sentry_dio/score) | [](https://pub.dev/packages/sentry_dio/score) |
| [](https://pub.dev/packages/sentry_link) | [](https://github.com/getsentry/sentry-dart/actions/workflows/link.yml) | [](https://pub.dev/packages/sentry_link/score) | [](https://pub.dev/packages/sentry_link/score) | [](https://pub.dev/packages/sentry_link/score) |
| [](https://pub.dev/packages/sentry_file) | [](https://github.com/getsentry/sentry-dart/actions/workflows/file.yml) | [](https://pub.dev/packages/sentry_file/score) | [](https://pub.dev/packages/sentry_file/score) | [](https://pub.dev/packages/sentry_file/score) |
| [](https://pub.dev/packages/sentry_sqflite) | [](https://github.com/getsentry/sentry-dart/actions/workflows/sqflite.yml) | [](https://pub.dev/packages/sentry_sqflite/score) | [](https://pub.dev/packages/sentry_sqflite/score) | [](https://pub.dev/packages/sentry_sqflite/score) |
| [](https://pub.dev/packages/sentry_drift) | [](https://github.com/getsentry/sentry-dart/actions/workflows/drift.yml) | [](https://pub.dev/packages/sentry_drift/score) | [](https://pub.dev/packages/sentry_drift/score) | [](https://pub.dev/packages/sentry_drift/score) |
| [](https://pub.dev/packages/sentry_hive) | [](https://github.com/getsentry/sentry-dart/actions/workflows/hive.yml) | [](https://pub.dev/packages/sentry_hive/score) | [](https://pub.dev/packages/sentry_hive/score) | [](https://pub.dev/packages/sentry_hive/score) |
| [](https://pub.dev/packages/sentry_isar) | [](https://github.com/getsentry/sentry-dart/actions/workflows/isar.yml) | [](https://pub.dev/packages/sentry_isar/score) | [](https://pub.dev/packages/sentry_isar/score) | [](https://pub.dev/packages/sentry_isar/score) |
## Releases
This repo uses the following ways to release SDK updates:
- `Pre-release`: We create pre-releases (alpha, beta, RC,…) for larger and potentially more impactful changes, such as new features or major versions.
- `Latest`: We continuously release major/minor/hotfix versions from the `main` branch. These releases go through all our internal quality gates and are very safe to use and intended to be the default for most teams.
- `Stable`: We promote releases from `Latest` when they have been used in the field for some time and in scale, considering time since release, adoption, and other quality and stability metrics. These releases will be indicated on the releases page (https://github.com/getsentry/sentry-dart/releases/) with the `Stable` suffix.
## Usage
For detailed usage, check out the inner [dart](https://github.com/getsentry/sentry-dart/tree/main/packages/dart), [flutter](https://github.com/getsentry/sentry-dart/tree/main/packages/flutter), [logging](https://github.com/getsentry/sentry-dart/tree/main/packages/logging), [dio](https://github.com/getsentry/sentry-dart/tree/main/packages/dio), [file](https://github.com/getsentry/sentry-dart/tree/main/packages/file), [sqflite](https://github.com/getsentry/sentry-dart/tree/main/packages/sqflite), [drift](https://github.com/getsentry/sentry-dart/tree/main/packages/drift), [hive](https://github.com/getsentry/sentry-dart/tree/main/packages/hive) and [isar](https://github.com/getsentry/sentry-dart/tree/main/packages/isar) `README's` or our `Resources` section below.
## Resources
- [](https://docs.sentry.io/platforms/flutter/)
- [](https://docs.sentry.io/platforms/dart/)
- [](https://github.com/getsentry/sentry-dart/discussions)
- [](https://discord.gg/gB6ja9uZuN)
- [](https://stackoverflow.com/questions/tagged/sentry)
- [](https://x.com/intent/follow?screen_name=sentry)
- Check out product updates, deep dives, and tips on [the Sentry blog](https://blog.sentry.io/) and [our changelog](https://sentry.io/changelog/)
## Apple Privacy Manifest
Starting with [May 1st 2024](https://developer.apple.com/news/?id=3d8a9yyh), iOS apps are required to declare approved reasons to access certain APIs. This also includes third-party SDKs.
If you are using `sentry-flutter`, update to at least version `7.17.0` to get the updated `sentry-cocoa` native iOS/macOS SDK, supporting the privacy manifest.
All other used dependencies with file declarations are supported by Sentry packages.
Run [flutter pub upgrade](https://docs.flutter.dev/release/upgrade#upgrading-packages) to the latest compatible versions of all the dependencies.
## SDK Size Overhead
The Sentry SDKs for Dart and Flutter typically add approximately 1-1.5 MB to an app’s binary size. The exact impact may vary depending on the device architecture.