Rollbar Dart Monorepo

Proactively discover, predict, and resolve errors in real-time with Rollbar’s error monitoring platform. Start tracking errors today!

---

Attention:

As of April 2024, Rollbar will not be actively updating this repository and plans to archive it. We encourage our community to fork this repo if you wish to continue its development. While Rollbar will no longer be engaging in active development, we remain committed to reviewing and merging pull requests, particularly those about security updates. If an actively maintained fork emerges, please let us know, and we will gladly link to it from our documentation.

This repository contains the rollbar_dart package and the rollbar_flutter plugin.

For rollbar-dart, see its README.

For rollbar-flutter, see its README.

rollbar-dart rollbar-flutter are currently in Beta. We are looking for beta-testers and feedback

Key benefits of using Rollbar for Dart are:

• Automatic error grouping: Rollbar aggregates Occurrences caused by the same error into Items that represent application issues. Learn more about reducing log noise.
• Advanced search: Filter items by many different properties. Learn more about search.
• Customizable notifications: Rollbar supports several messaging and incident management tools where your team can get notified about errors and important events by real-time alerts. Learn more about Rollbar notifications.

Documentation

For complete usage instructions and configuration reference, see our rollbar-dart and rollbar-flutter SDK docs.

Release History & Changelog

See our Releases page for a list of all releases and changes.

Vendoring

Since Rollbar will no longer be publishing package updates to pub.dev, it's recommended that you "vendor" the Rollbar packages into your project so that you can have full control over package versions, pull in fixes from the community, etc. For example, the rollbar_dart package on pub.dev currently has an old http dependency, even though this has already been updated on the main branch.

To vendor this package in your project, it's recommended to add it as a git submodule. Typically you'll want to fork the repo so that you can make changes there, and use your fork for the submodule URL, like so:

git submodule add https://github.com/<YOUR_USERNAME>/rollbar-flutter.git vendor/rollbar-flutter

Next, remove rollbar_flutter: ^X.X.X from the dependencies: block in your pubspec.yaml, and add the following:

dependencies:
  ...

  # vendored packages
  rollbar_flutter:
    path: vendor/rollbar-flutter/rollbar_flutter

Help / Support

If you run into any issues, please email us at [email protected].

For bug reports, please open an issue on GitHub.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Run tests and static analysis (build_tools/check.sh)
6. If all the checks pass, create new Pull Request

Publishing packages

The official packages are published as rollbar_dart and rollbar_flutter.

Publishing is straightforward using pub, but due to quirks of how ignore files work, the script build_tools/publish.sh should always be used to make sure only the necessary files are included, and that the right tool versions are used for publishing.

Eg.:

./build_tools/publish.sh rollbar_dart
./build_tools/publish.sh rollbar_flutter

License

rollbar-dart and rollbar-flutter are free software released under the MIT License. See LICENSE for details.