{"id":13484247,"url":"https://github.com/calonso/ruby-push-notifications","last_synced_at":"2025-05-16T08:03:03.579Z","repository":{"id":50325330,"uuid":"31062956","full_name":"calonso/ruby-push-notifications","owner":"calonso","description":"iOS, Android and Windows Phone Push Notifications made easy!!","archived":false,"fork":false,"pushed_at":"2019-10-16T13:33:35.000Z","size":178,"stargazers_count":399,"open_issues_count":3,"forks_count":33,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-10-30T01:10:33.354Z","etag":null,"topics":["android","ios","push-notifications","ruby","rubygem","windows-phone"],"latest_commit_sha":null,"homepage":"https://rubygems.org/gems/ruby-push-notifications","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/calonso.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-20T11:56:32.000Z","updated_at":"2024-10-18T08:07:40.000Z","dependencies_parsed_at":"2022-08-29T04:31:47.636Z","dependency_job_id":null,"html_url":"https://github.com/calonso/ruby-push-notifications","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calonso%2Fruby-push-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calonso%2Fruby-push-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calonso%2Fruby-push-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calonso%2Fruby-push-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/calonso","download_url":"https://codeload.github.com/calonso/ruby-push-notifications/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254258557,"owners_count":22040703,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","ios","push-notifications","ruby","rubygem","windows-phone"],"created_at":"2024-07-31T17:01:21.316Z","updated_at":"2025-05-16T08:03:03.542Z","avatar_url":"https://github.com/calonso.png","language":"Ruby","funding_links":[],"categories":["Mobile Development","Notifications"],"sub_categories":[],"readme":"# Ruby Push Notifications\n\n[![Build Status](https://travis-ci.org/calonso/ruby-push-notifications.svg)](https://travis-ci.org/calonso/ruby-push-notifications) [![Dependency Status](https://gemnasium.com/calonso/ruby-push-notifications.svg)](https://gemnasium.com/calonso/ruby-push-notifications) [![Code Climate](https://codeclimate.com/github/calonso/ruby-push-notifications/badges/gpa.svg)](https://codeclimate.com/github/calonso/ruby-push-notifications) [![Test Coverage](https://codeclimate.com/github/calonso/ruby-push-notifications/badges/coverage.svg)](https://codeclimate.com/github/calonso/ruby-push-notifications) [![Gem Version](https://badge.fury.io/rb/ruby-push-notifications.svg)](http://badge.fury.io/rb/ruby-push-notifications) [![Join the chat at https://gitter.im/calonso/ruby-push-notifications](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/calonso/ruby-push-notifications?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n### iOS, Android and Windows Phone Push Notifications made easy!\n\n## Features\n\n* iOS and Android support\n* Complete error and retry management\n* Easy and intuitive API\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n    gem 'ruby-push-notifications'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install ruby-push-notifications\n\n## Usage\n\n**Ruby Push Notifications** gem usage is really easy.\n\n1. After installing, require the gem\n2. Create one or more notifications\n3. Create the corresponding `pusher`\n4. Push!!\n5. Get feedback\n\nFor completely detailed examples:\n\n1. [Apple iOS example](https://github.com/calonso/ruby-push-notifications/tree/master/examples/apns.rb)\n2. [Google Android example (GCM)](https://github.com/calonso/ruby-push-notifications/tree/master/examples/gcm.rb)\n3. [Google Android example (FCM)](https://github.com/calonso/ruby-push-notifications/tree/master/examples/fcm.rb)\n4. [Windows Phone(MPNS) example](https://github.com/calonso/ruby-push-notifications/tree/master/examples/mpns.rb)\n5. [Windows Phone(WNS) example](https://github.com/calonso/ruby-push-notifications/tree/master/examples/wns.rb)\n\n## Pending tasks\n\nFeel free to contribute!!\n\n* Validate iOS notifications format and max size\n* Validate iOS tokens format\n* Validate GCM registration ids format\n* Validate GCM notifications format and max size\n* Split GCM notifications in parts if more than 1000 destinations are given (currently raising exception)\n* Integrate with APNS Feedback service\n* Validate MPNS notifications format\n* Validate MPNS data\n* Add other platforms (Amazon Fire...)\n\n## Contributing\n\n1. Fork it ( https://github.com/calonso/ruby-push-notifications/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n\n## Troubleshooting\n\n**If you see \"255 Unknown Error\" error code**\n\nThis error code is assigned when the connection to push notification server wasn't successful\n\u003ca href=\"https://github.com/calonso/ruby-push-notifications/blob/master/lib/ruby-push-notifications/apns/apns_pusher.rb#L56-L58\"\u003e255 UNKnown Error code\u003c/a\u003e\n\nChecking your connection configuration for example with APNS connection.\nWhen your pem file and token are development make sure you configure the pusher for sandbox mode\n``` RubyPushNotifications::APNS::APNSPusher.new('the certificate', true)) ```\n\nor when your pem file and token are production you should configure the pusher for production mode (Set the sandbox mode to false when creating your pusher)\n``` RubyPushNotifications::APNS::APNSPusher.new('the certificate', false)) ```\n\n## Changelog\n\nRefer to the [CHANGELOG.md](https://github.com/calonso/ruby-push-notifications/blob/master/CHANGELOG.md) file for detailed changes across versions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalonso%2Fruby-push-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalonso%2Fruby-push-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalonso%2Fruby-push-notifications/lists"}