React Native Springboard Shortcuts provides an easy way to create shortcuts to an application when developing in React Native.

The shortcuts can deeplink to a specific screen(s) inside your app. This library take advantage of the native side with a simple API for the JavaScript side. At the moment the library only supports shortcuts for Android devices, in the future we may add support for iOS as well.

• Android SDK version >= 25

$ npm install --save react-native-springboard-shortcuts

1. Open up android/app/src/main/java/[...]/MainApplication.java

• Add import com.alon.ReactNativeSpringboardShortcuts.RNSpringboardShortcutsPackage; to imports at the top of the file
• Add new RNSpringboardShortcutsPackage() to the list returned by the getPackages() method

2. Append the following lines to android/settings.gradle:

    include ':react-native-springboard-shortcuts'
    project(':react-native-springboard-shortcuts').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-springboard-shortcuts/lib/android')
   

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

    implementation project(":react-native-springboard-shortcuts")
   

import RNSpringboardShortcuts from 'react-native-springboard-shortcuts';

RNSpringboardShortcuts.isShortcutServiceAvailable((isAvailable: boolean) => {

  if (isAvailable) {
    const shortcut = {
      id: 'shortcut.id.example',
      shortLabel: 'Shortcut title',
      longLabel: 'Shortcut description',
      imageUrl: 'https://someImage.jpg',
      intentUri: `myApp://myCoolAppScreen`
    };

    RNSpringboardShortcuts.exists(shortcut.id).then(() => {
      // Exists
      RNSpringboardShortcuts.updateShortcut(shortcut);
    }).catch((_err: Error) => {
      // Does not exist
      RNSpringboardShortcuts.addShortcut(shortcut);
    });
   }
});

RNSpringboardShortcuts.isShortcutServiceAvailable((isAvailable: boolean) => {

});

RNSpringboardShortcuts.exists(shortcut.id).then(() => {
  // Exists
}).catch((_err: Error) => {
  // Does not exist
});

RNSpringboardShortcuts.addShortcut(shortcut);

RNSpringboardShortcuts.updateShortcut(shortcut);

RNSpringboardShortcuts.removeShortcut(shortcut.id);

RNSpringboardShortcuts.removeAllShortcuts();

This function will only work if you did NOT provide an intentUri to the shortcut. To use this method for handling shortcuts, copy it to componentDidMount function of a component/screen which loads at the start of your app.

RNSpringboardShortcuts.handleShortcut((shortcutId: string) => {

});