explaingit

arashpayan/appirater

4,596Objective-CAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A small iOS library that automatically asks users to rate your app on the App Store, but only after they have launched it a set number of times or enough days have passed, so the prompt feels earned.

Mindmap

mindmap
  root((Appirater))
    What it does
      App Store rating prompts
      Timing and conditions logic
      Debug mode for testing
    Conditions supported
      Launch count
      Days since install
      Significant events
    How it works
      Drop-in Objective-C library
      Uses Apple native dialog on iOS 10.3
      MIT licensed
    Use cases
      Boost app ratings
      Time prompts naturally
      Test review flows
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add App Store rating prompts to an iPhone app that appear only after a user has launched it enough times or enough days have passed

USE CASE 2

Trigger a review request after a user completes a meaningful in-app action rather than on first launch

USE CASE 3

Test the rating dialog flow in debug mode without waiting for real launch counts or day thresholds to be met

Tech stack

Objective-CiOS

Getting it running

Difficulty · easy Time to first run · 30min

On iOS 10.3 and later, Apple limits how often the native rating dialog actually appears, regardless of your settings.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Appirater is a small library for iPhone apps that handles the logic of prompting users to leave a review on the App Store. Rather than popping up a review request immediately on install, it waits until certain conditions are met, such as the app being launched a set number of times, a certain number of days having passed, or the user completing a specific action inside the app that you define as significant. Once those conditions are met, it shows the prompt automatically. The library is written in Objective-C and is designed to be dropped into an existing iOS project. Setup involves a few lines of configuration code: you tell it your App Store ID, how many days to wait before showing the prompt, how many launches to require, and optionally how many significant in-app events should pass. A debug mode makes the prompt appear on every launch so you can test the experience without waiting for the real conditions to trigger. Starting with iOS 10.3, Apple introduced a built-in way for apps to request ratings directly inside the app. Appirater automatically uses that system when it is available on the device, meaning the actual dialog shown to users is Apple's native one. In that mode, Appirater still handles the timing and conditions logic, but Apple controls how often the dialog actually appears, which can result in fewer impressions than your settings might otherwise suggest. The library is released under the MIT license, which means you can use and modify it freely. The README points to Stack Overflow for support questions and notes that a MonoTouch binding exists for developers working outside of native Objective-C. The project has been around since 2009 and covers iOS 4.0 and later.

Copy-paste prompts

Prompt 1
How do I add Appirater to my iOS app to show an App Store rating prompt after 5 launches and 3 days?
Prompt 2
How does Appirater behave on iOS 10.3 and later where Apple controls the native rating dialog frequency?
Prompt 3
Show me how to configure Appirater to prompt users after they complete a specific in-app action instead of just counting launches
Prompt 4
How do I enable Appirater's debug mode to see the rating prompt every launch during testing?
Open on GitHub → Explain another repo

← arashpayan on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.