rocketinsights/pigeon

iOS and Android push notifications for Elixir

HTTP2-compliant wrapper for sending iOS and Android push notifications.

Pigeon v2.0 is in release candidate status. See the latest stable 1.6 on Hex or the 1.6 branch on GitHub for installation.

Installation

Add :pigeon and as a mix.exs dependency:

def deps do
  [
    {:pigeon, "~> 2.0.0-rc.0"}
  ]
end

Getting Started

Check the module documentation for your push notification service.

• Pigeon.ADM - Amazon Android.
• Pigeon.APNS - Apple iOS.
• Pigeon.FCM - Firebase Cloud Messaging v1 API.
• Pigeon.LegacyFCM - Firebase Cloud Messaging Legacy API.

Creating Dynamic Runtime Dispatchers

Pigeon can spin up dynamic dispatchers for a variety of advanced use-cases, such as supporting dozens of dispatcher configurations or custom connection pools.

See Pigeon.Dispatcher for instructions.

Writing a Custom Dispatcher Adapter

Want to write a Pigeon adapter for an unsupported push notification service?

See Pigeon.Adapter for instructions.

Contributing

Testing

Unit tests can be run with mix test or mix coveralls.html.

Formatting

This project uses Elixir's mix format for formatting. Add a hook in your editor of choice to run it after a save. Be sure it respects this project's .formatter.exs.

Commits

Git commit subjects use the Karma style.

License

Copyright (c) 2015-2021 Codedge LLC (https://www.codedge.io/)

This library is MIT licensed. See the LICENSE for details.