https://github.com/oblador/react-native-store-review

Rate on App/Play Store directly in your React Native app
https://github.com/oblador/react-native-store-review

android appstore ios playstore rating react-native review

Last synced: 3 days ago
JSON representation

Rate on App/Play Store directly in your React Native app

• Host: GitHub
• URL: https://github.com/oblador/react-native-store-review
• Owner: oblador
• License: mit
• Created: 2017-03-27T21:06:02.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-26T12:48:13.000Z (9 months ago)
• Last Synced: 2024-06-18T13:57:00.792Z (23 days ago)
• Topics: android, appstore, ios, playstore, rating, react-native, review
• Language: Java
• Homepage:
• Size: 822 KB
• Stars: 738
• Watchers: 5
• Forks: 53
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Lists

• my-awesome-stars - oblador/react-native-store-review - Rate on App/Play Store directly in your React Native app (Java)

README

        
# react-native-store-review

This module exposes the native APIs to ask the user to rate the app in the iOS App Store or Google Play store directly from within the app (requires iOS >= 12.4 or Android 5.0 with Google Play store installed). 



## Installation

```bash

# Add dependency

yarn add react-native-store-review

# Link iOS dependency

pod install --project-directory=ios

# Compile project

react-native run-ios # or run-android

```

## Usage

The intention of this API is to ask the user to rate the app as a part of the user journey, typically as the user completes a task. **Since it's not possible to know if a dialog will be shown or not you should not call it as a result of tapping a button**, but rather as a side effect of an event happening in the app. 

```js

import * as StoreReview from 'react-native-store-review';

StoreReview.requestReview();

```

### Button

If you want to show a button or provide a fallback for OS versions not supporting these APIs, you can redirect the user to the respective stores to review the app there instead. 

```js

import { Linking, Platform } from 'react-native';

const APP_STORE_LINK = `itms-apps://apps.apple.com/app/id${IOS_APP_ID}?action=write-review`;

const PLAY_STORE_LINK = `market://details?id=${ANDROID_APP_ID}`;

const STORE_LINK = Platform.select({

  ios: APP_STORE_LINK,

  android: PLAY_STORE_LINK,

});

export const openReviewInStore = () => Linking.openURL(STORE_LINK)

```

## References

* [`SKStoreReviewController` for App Store](https://developer.apple.com/documentation/storekit/skstorereviewcontroller/requesting_app_store_reviews) 

* [`In-App Review API` for Google Play Store](https://developer.android.com/guide/playcore/in-app-review).

## Troubleshooting

### The dialog is not showing in the correct language on iOS

The strings in the dialog comes from the OS, if your translations are purely in JavaScript land you need to add meta data so iOS understand which languages you support, [see the official documentation](https://developer.apple.com/documentation/xcode/localization/adding_support_for_languages_and_regions).

### The dialog is not showing when I call `requestReview()`

##### (1)

For iOS you have to add LSApplicationQueriesSchemes as Array param to Info.plist and add itms-apps as one of params in this array to link appstore.

For example:

```js

LSApplicationQueriesSchemes

  itms-apps

```

##### or (2)

The dialog **is not showing while testing with TestFlight** but will be working normally once in production ([source](https://stackoverflow.com/questions/46770549/skstorereviewcontroller-requestreview-popup-is-not-showing-in-testflight-build/47048474#47048474)). Furthermore it will not work for enterprise apps as they are not available on the App Store, and Apple/Google will restrict the amount of times the API can be called to a few times per year in order prevent misuse.