Jonas Hübotter

Apps Open Source Contact

NotificationsRails

The most powerful (cross-platform) notifications handler & pusher API for Rails

Notifications Rails

Gem Version Travis

The most powerful notification solution for Rails. Notifications Rails simplifies the handling, rendering, user-integration and cross-platform pushing of notifications through its simple API.

It integrates with the Native gem to allow you to create a cross platform Rails app.


Table of Contents


Philosophy

Notifications Rails has been built with modularity in mind. It currently consists of four components each of which bringing one essential functionality to the notification-integration in your Rails app.

NotificationHandler: Create and modify your notifications through a simple API.

NotificationRenderer: Render your notifications on multiple platforms by specifying notification types.

NotificationPusher: Push your notifications to various services. Including Email, ActionCable, OneSignal.

NotificationSettings: Integrates with your authentication solution to craft a personalized user notification platform.

You may just add the components you actually need, or instead use this gem to bundle everything for a complete notification solution.


Installation

Notifications Rails works with Rails 5 onwards. You can add it to your Gemfile with:

gem 'notifications-rails'

And then execute:

$ bundle

Or install it yourself as:

$ gem install notifications-rails

If you always want to be up to date fetch the latest from GitHub in your Gemfile:

gem 'notifications-rails', github: 'jonhue/notifications-rails'

Testing

Tests are written with RSpec.

  1. Fork this repository

  2. Clone your forked git locally

  3. Install dependencies

    $ bundle install

  4. Run tests

    $ bundle exec rspec

  5. Run RuboCop

    $ bundle exec rubocop


Release

  1. Change the gem version here

  2. Publish to https://rubygems.org

    $ sh release.sh <version>


To do

We use GitHub projects to coordinate the work on this project.

To propose your ideas, initiate the discussion by adding a new issue.


Contributing

We hope that you will consider contributing to Notifications Rails. Please read this short overview for some information about how to get started:

Learn more about contributing to this repository, Code of Conduct

Semantic Versioning

Notifications Rails follows Semantic Versioning 2.0 as defined at http://semver.org.

Ruby

6 ⭐️

Updated 16 days ago