Leaderboard
Misc Pro
Climb a weekly league with tiered gems, the time left in the week and a ranked table. Finish a lesson and your row glides up past the promotion line while your rank rolls over.
More in Misc
View all 18Agent prompt
Paste into Claude Code, Cursor or Devin to rebuild this screen.
Recreate the "Leaderboard" screen in React Native using LumioUI.
Goal: Climb a weekly league with tiered gems, the time left in the week and a ranked table. Finish a lesson and your row glides up past the promotion line while your rank rolls over. Match the reference implementation's layout, behavior, and motion exactly — this is a production screen, not a mockup.
## Setup
Fastest path — install the screen plus its component deps:
```bash
npx @lumioui/cli add pro/misc-leaderboard
```
Or pull just the components: `npx @lumioui/cli add animated-number avatar icon pro/leaderboard text`
Native packages:
- react-native-reanimated@*
- react-native-safe-area-context@*
- react-native-svg@*
Stack assumptions: Expo SDK 54 / RN 0.81, Reanimated 4, NativeWind v4, TypeScript strict, Expo Go compatible.
## Components — how, where, when
### `animated-number` — Number that moves to each new value as a calm count-up or a roll where only the changed digits turn, set in type or in dot-matrix LEDs whose dots switch on in place. Screen readers announce just the final value, not every step.
- `<AnimatedNumber>` ×1 — The digit rolls in place (≤6px travel) once the climb has held.
### `avatar` — Circular profile image with fallback initials and a presence dot. An optional mode shows presence on the photo itself, bright when online and faded when away or offline.
- `<Avatar>` ×1
### `icon` — Icon set drawn on one consistent grid, sized and coloured from your theme. The heart, star and bookmark can fill in place inside their outline, then fade back out.
- `<Icon>` ×4
### `leaderboard` — Ranked list with an optional top-three podium, promotion and demotion lines and a pinned “you” row. When you overtake someone, your row rises as theirs steps down.
- `<Leaderboard>` ×1
### `text` — Themed type scale from caption to display that follows light and dark mode. Includes a pull-quote style with an accent rule and a quieter dimmed tone for secondary text.
- `<Text>` ×8
## Conventions (non-negotiable)
- Styling via NativeWind `className` with semantic tokens only: `bg-background`, `text-foreground`, `bg-card`, `text-card-foreground`, `bg-secondary`, `bg-muted`, `text-muted-foreground`, `bg-accent`, `bg-destructive`, `border-border`. Hard-coded colors only inside media overlays (`text-white`, `bg-black/N`).
- Motion via the token presets from `@lumioui/core` (`spring.press`, `spring.surface`, `spring.glide`, `timing.fast`, `timing.slow`, …) — no bespoke spring configs or durations.
- Gate transform motion behind `useReducedMotion()`; keep opacity/color feedback, drop travel and overshoot.
- Haptics via `useHaptic()`: `light` on press, `selection` on toggle/select, `warning` on invalid input. Never import expo-haptics directly.
- Press feedback via `usePressAnimation()` (~0.97 scale), not `activeOpacity` tricks.
- a11y: `accessibilityRole` + `accessibilityLabel` on every control, touch targets ≥44pt.
- Entrance choreography: staggered `Mount` wrappers (delay 0/60/120…) so regions land in sequence instead of popping in at once.
- Wrap the screen in `SafeAreaView`; keep dark mode working via the semantic tokens.
## Deliverable
One file: `screens/misc/leaderboard.tsx` exporting LeaderboardScreen. Preserve the props interface — the host app wires the callbacks (navigation, submit handlers) through them.
## Reference implementation
This is a LumioUI Pro item: its source is not published in the docs. Install it with a Pro license key
(set `LUMIO_LICENSE_KEY`; keys are on lumioui.com/account) and read the installed file as the reference:
```bash
npx @lumioui/cli add pro/misc-leaderboard
```
The source lands at `screens/misc/leaderboard.tsx`.
Screen: https://lumioui.com/screens/misc-leaderboard