should_review

Description:

should review

should_review #

This package helps determine if a user should be prompted to rate your app.
The behavior of this package was inspired by the stackoverflow answer at https://stackoverflow.com/a/11284580/2628500 and a couple extra ideas.
You can safely call the determining function Future<bool> shouldReview() of this package every time your app launches or at a particular point in your app to determine if you need to prompt for a review.
Features #

Determine if you need to prompt user for review based on number of days since first app launch, number of times launched.
Determine the above by a custom criteria. (In Progress)

Getting started #
Add the below to your pubspec.yaml file.
dependencies:
should_review: ^0.2.5
copied to clipboard
As this package doesn't actually prompt users for a review, you will need a plugin or a native implementation or other means to do that for you.
A good candidate is the in_app_review plugin.
Usage #
There are currently three ways or criteria with which you can use this package.

Using Days (Criteria.days) criteria (Using number of days since first app launch and subsequent set days interval after that has elapsed).
Using Times Launched (Criteria.timesLaunched) criteria (Using number of times app has been launched).
Using a custom criteria. e.g. made_purchase.

Using Days Criteria #
To determine whether to prompt a user for review based on days criteria which is actually the default criteria do the following.
import 'package:should_review/should_review.dart';

if (await ShouldReview.shouldReview()) {
// Prompt user for review.
ShouldReview.neverReview(); // This ensures the shouldReview function never returns true again.
}
copied to clipboard
or outright provide arguments while calling the function as below.
import 'package:should_review/should_review.dart';

if (await ShouldReview.shouldReview(
criteria: Criteria.days,
minDays: 5,
coolDownDays: 2,
)) {
// Prompt user for review.
ShouldReview.neverReview(); // This ensures the shouldReview function never returns true again.
}
copied to clipboard
NB: The shouldReview function can only return true once a day for all criteria.
Using Launch Times Criteria #
To determine whether to prompt a user for review based on launch times criteria do the following.
import 'package:should_review/should_review.dart';

if (await ShouldReview.shouldReview(
criteria: Criteria.launchTimes,
minLaunchTimes: 8,
coolDownLaunchTimes: 4,
)) {
// Prompt user for review.
ShouldReview.neverReview(); // This ensures the shouldReview function never returns true again.
}
copied to clipboard
NB: For the above to work as expected, there is one thing you have to put in place, which is the recordLaunch function.
The recordLaunch function must be called somewhere in your app that runs once the app is launched. Suitably in your lib\main.dart file or in the initState of your Dashboard widget for instance.
This enables the package record how many times the app was launched and use it while determining review possibility with the times launched criteria.
Using Custom Criteria #
If you want to use some other kinds of criteria like when a user performs an action a given number of times, you can use the Criteria.custom criteria and provide a key (e.g. made_purchase) for the action. For this to work as intended, you need to call the recordCustomCriteriaMet function with the same custom key (e.g. made_purchase) every time that action or criteria is met. See an example below.
import 'package:should_review/should_review.dart';

// Every time a purchase is made, the below is called.
ShouldReview.recordCustomCriteriaMet("made_purchase");

if (await ShouldReview.shouldReview(
criteria: Criteria.custom,
customCriteriaKey: "made_purchase",
minCustomCriteriaValue: 5,
coolDownCustomCriteriaInterval: 2,
)) {
// Prompt user for review.
ShouldReview.neverReview(); // This ensures the shouldReview function never returns true again.
}
copied to clipboard
NB: minCustomCriteriaValue and customCriteriaKey is required when criteria is set to Criteria.custom. Not providing the two values in this scenario will result in an error.
NB: The coolDown... parameters are nullable. passing null to them will ignore all cool down logic and return false all through.
Parameters #



Parameter
Description
Example
Default




criteria
The criteria to use for determining if you should prompt a user for review.
Criteria.days, Criteria.timesLaunched
Criteria.days


minDays
The minimum number of days since first app launch to prompt a user for review.
5, 8, 2
5


coolDownDays
The number of days after the minimum days has elapsed to prompt a user for review. In other words, if you provided 2 to this parameter, it means that every 2 days, the shouldReview function will return true if neverReview has not been called.
2, 3, 1
2


minLaunchTimes
The number of times the app has to be launched before the shouldReview function can return true.
8, 5
5


coolDownLaunchTimes
Same as coolDownDays but for the launch times criteria.
3, 5
4


minCustomCriteriaValue
The minimum value for the given a given custom criterion.
3, 10
null


coolDownCustomCriteriaInterval
Cool down interval value for custom criteria. Similar to coolDownDays and coolDownLaunchTimes.
2, 5
null


customCriteriaKey
Custom Criteria Key
made_purchase, advanced_a_level, etc.
null



Additional information #
For a practical example, see the package example section.
Contributing #
Pull requests are welcome.
Send pull requests to the develop branch.
For major changes, please open an issue first to discuss what you would like to change.
TODO #

✅ Determine if user should be prompted for a review based on a custom criteria.
❌ Determine if user should be prompted for a review based on aggregated custom criteria.
❌ Get next prompt date.
✅ Get number of times app launched.
❌ Get number of days since first launch.