Store Review

Ask StoreKit to show the App Store rating prompt at an appropriate moment

One.StoreReview.requestReview() asks StoreKit to consider showing the system rating prompt in the active iOS window scene. Call it after a meaningful app milestone, such as completing a useful task. The request has no arguments or manifest settings.

import { One } from 'one'

// after a useful task completes, at a moment that will not interrupt the user
await One.StoreReview.requestReview()

The promise resolves when the request reaches StoreKit. It does not report whether the prompt appeared, was dismissed, or received a rating. iOS decides whether to show it; do not use this method as the action for a “Rate us” button. Apple says development builds show the prompt for testing, TestFlight builds do not, and App Store builds follow system frequency rules. See Apple’s StoreKit request review guidance.

A request without an active window scene rejects with E_STORE_REVIEW_SCENE. Review requests are implemented on iOS; on Android and web, requestReview() does nothing. The iOS 27 simulator proves the development prompt and dismissal, while App Store display policy needs device and distribution proof.