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

# Leaderboards on Whip: compete for the high score

> Games and apps on Whip can keep a high-score leaderboard. Learn how your best score is tracked, when you're notified you've been beaten, and how to add one.

Apps on Whip — especially games — can keep a **high-score leaderboard**. It tracks your personal best on that app, ranks you against everyone else who plays it, and Whip sends you a notification if someone later beats your score. It's the friendly, competitive layer that turns a solo game into a rivalry with the whole community.

## How leaderboards work

<AccordionGroup>
  <Accordion title="It tracks your personal best" icon="target">
    A leaderboard remembers your best result on that app. Beat your own
    record and it updates; a worse run leaves your best untouched. So you can
    keep playing without fear of "ruining" a good score.
  </Accordion>

  <Accordion title="One board per app" icon="trophy">
    Each app has a single leaderboard. Even as the creator ships new
    [versions](/building/versions-and-history), scores roll into the same
    board — so the competition carries on across updates.
  </Accordion>

  <Accordion title="The app decides what a score is" icon="ruler">
    Points, fastest time, longest streak — the app defines what counts, and
    whether higher or lower wins. A speed-run can rank low-to-high; an arcade
    game high-to-low.
  </Accordion>

  <Accordion title="You're pinged when you're beaten" icon="bell">
    Set a great score and hold the top for a while? If someone later beats
    it, Whip sends you a [notification](/social/notifications) — your cue for
    a rematch.
  </Accordion>
</AccordionGroup>

<Note>
  A leaderboard is open to everyone who plays that public app — friends and
  strangers alike. Your entry is your own personal best. Playing an app you
  made doesn't game its stats, and your scores live on the board, not in
  anyone else's [private copy](/using/open-and-use-apps) of the app.
</Note>

## Add a leaderboard to your own app

You don't set anything up by hand — just ask for it while you build or [edit](/building/edit-your-app) in chat:

<Steps>
  <Step title="Describe the score" icon="message-circle">
    Tell Whip what to track: "add a high-score leaderboard for fastest
    lap time" or "keep a leaderboard of total points, highest first."
  </Step>

  <Step title="Whip wires it up" icon="wand-sparkles">
    The AI adds the board, the score submission, and the ranking display for
    you — no code, no setup.
  </Step>

  <Step title="Publish and let the rivalry begin" icon="rocket">
    Once you [publish](/sharing/publish-your-app), everyone who plays your
    app competes on the same board.
  </Step>
</Steps>

<Tip>
  Leaderboards pair beautifully with a great [highlight
  reel](/sharing/highlight-reels) — a clip of a nail-biting high score is the
  kind of thing people tap to play, then tap to remix.
</Tip>

## Related

<CardGroup cols={2}>
  <Card title="What apps can do" icon="rocket" href="/building/what-apps-can-do">
    Leaderboards are one of many superpowers — see the full toolkit.
  </Card>

  <Card title="Open and use apps" icon="play" href="/using/open-and-use-apps">
    How playing works, and why your data stays your own.
  </Card>
</CardGroup>