> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinbankroll.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviews

> Ask for a thumbs up or down with promptReview() — at the moment your app knows is right.

Bankroll asks players what they think of your app with a small card over it:
thumbs up, thumbs down, or dismiss. Your app decides **when**. Call
`promptReview()` at the moment a player has formed a view and is between
actions — right after their first completed round is a good one.

```ts theme={null}
import { bankroll } from "@joinbankroll/sdk";

void bankroll.promptReview(); // right after the first completed round
```

## What happens

Bankroll draws the card, records the answer, and reads it. Your app gets
nothing back: `promptReview()` resolves with no value as soon as the host has
taken the request, whether or not a card appears. With either vote the
player may add a sentence; the words go to Bankroll.

## How often it shows

Bankroll limits how often any one player sees the card, so calling often
costs nothing. Call it once, at the right moment. Do not call it on load, and
do not await it in your game loop.

## It never rejects

Like [`haptics()`](/build/haptics), this call **never rejects**: in a plain
browser, under a Bankroll host too old to carry it, or on any bridge failure,
it resolves having done nothing. Gate nothing on it.

## Verified apps only

The card appears only for [verified](/build/verified) apps. An unverified app
gets the same resolve and no card.

## Nothing to declare

Reviews move no money and read no data, so there is no manifest claim, no
consent line, and no re-consent for users who connected before it existed.

Requires a Bankroll host that carries the method. The SDK feature-detects it,
so there is no version number for you to check.
