Skip to content

oddbit/firebase-alerts

Repository files navigation

About

Empower your team with timely Firebase notifications sent directly to your preferred communication platform.

Key Features

  • Alerts: Receive immediate notifications, enabling rapid debugging and issue resolution.
  • Flexible Webhook Support: Easily integrates with popular platforms like:
    • Slack
    • Discord
    • Google Chat
  • Extensible: Readily build custom webhook plugins to connect with other notification channels.
  • Roadmap: We're actively evolving to make the alerts and notifications more helpful. See our roadmap for more info.
Platform App Distribution Crashlytics Performance
Google Chat
Slack
Discord
MS Teams

Screenshots

App Distribution Crashlytics Performance
Google Chat App Distribution New Device Google Chat Crashlytics Message Google Chat Performance Alert Message

Installation

Install the Firebase Alerts extension using the Firebase CLI or the Firebase console.

Install using CLI

You can install this extension from source by forking the repository and run the following command from your Firebase project root.

firebase ext:install oddbit/firebase-alerts
firebase deploy --only extensions

Read the PREINSTALL and POSTINSTALL instructions for further information and requirements.

Getting involved

If you're reading this, you're awesome!

We welcome your contributions! If you'd like to suggest new features or platforms: Open an issue on our GitHub repository after searching to find if your idea or feedback has already been posted.

Building webhook plugins

It's easy and fun to develop new webhook plugins. All you need to do is to declare your new plugin and create a new class that extends the abstract Webhook

Have a look at the existing plugin(s) under functions/src/webhook-plugins/ to see how an implementation can look like.

Create your new plugin alongside the existing plugins your-new-plugin.ts

export class YourNewPluginWebhook extends Webhook {
  // Implements Webhook
}

Registering the new plugin in the method webhookPluginFromUrl().