Skip to content

Latest commit

 

History

History
163 lines (101 loc) · 5.42 KB

README.md

File metadata and controls

163 lines (101 loc) · 5.42 KB

expo-push-notification-helper

All Contributors

Build Status

Code Quality

This package helps you make expo push notification for React Native easy to use.

Installation

Add expo-push-notification-helper to your project by executing

$  npm install expo-push-notification-helper
or
$ yarn add expo-push-notification-helper

You're all set!

Usage

To initialize expo-push-notification-helper import the "initnotify"
//import the initnotify into your project
import { initnotify } from 'expo-push-notification-helper';

//and then use like so
         initnotify();

it's advicable to do this at your top level file.

can also use the callback function. Which returns true on success and false if unsuccessful.
this will also automatically create three channels for your app, "default", "reminders", "chat-messages" .
//import the initnotify into your project
import { initnotify } from 'expo-push-notification-helper';

//and then use like so
         initnotify().then((data)=>{
              if(data){
                //get token
              }else{
                //request for permission
              }
         });

To get expo token of device import the "getToken"
this must be used in a async/await .
//import the getToken into your project
import { initnotify, getToken } from 'expo-push-notification-helper';

//and then use like so

      initnotify().then( async(data)=>{
          if(data){
                console.log(await getToken());
            }else{
              alert('please grant this app notification permission in settings.')
            }
       
        })



To create a new channel import the "newChannel"
//import the newChannel into your project 
import {  newChannel } from 'expo-push-notification-helper';

//and then use like so 
    newChannel("GroupMessage");
on default your channel will be created sound being false but you can change that by adding true as a second input

To send push notification import the "notify"

//import the notify into your project 
import { notify } from 'expo-push-notification-helper';

//and then use like so 
      notify(token, "new message", "hello there how are you doing", "default")
Not you must supply the channel."

Props

all expo-push-notification-helper props

Name Use callback note
initnotify() initialize package, this will ask for notification permission. true, false this will also automatically create three channels for your app, "default", "reminders", "chat-messages" .
getToken() get expo token of device null must be called in async/await
newChannel(name, isSound) create new notification channel true, false isSound is a boolean
notify( token, title, body, channel ) send push notification null without providing a channel. channel will be set to default by default

Contributing

Have a new feature you'd love to add to this project? Make a Send me a pull request! Just follow the guidelines. Thank you!

don't forget to star, like and share :)

Licensing


This project is licensed under MIT license.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Tomás Vélez Núñez

💻

Ujjal Acharya

📖

Oluwatobi Shokunbi

💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!