PR Leaderboard

Installation

pnpm dlx shadcn@latest add @cleverui/pr-leaderboard

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx

import { PrLeaderboard } from '@/components/blocks/pr-leaderboard'

Exampletsx

'use client'

import { PrLeaderboard } from '@/components/blocks/pr-leaderboard'

export default function PrLeaderboardDemo() {
  return (
    <div className="py-8 sm:py-12">
      <PrLeaderboard
        eyebrow="Chalk up"
        heading="The record board"
        liftLabel="Back squat, all-time"
        note="Coach-verified. Video or it didn't happen."
        entries={[
          {
            name: 'Dana Cole',
            weight: '212.5 kg',
            detail: '@ 82 kg BW',
            date: 'Mar 2026',
            isNew: true,
          },
          {
            name: 'Marcus Reed',
            weight: '205 kg',
            detail: '@ 94 kg BW',
            date: 'Jan 2026',
          },
          {
            name: 'Ava Okonkwo',
            weight: '180 kg',
            detail: '@ 68 kg BW',
            date: 'Feb 2026',
          },
          {
            name: 'Jules Park',
            weight: '175 kg',
            detail: '@ 76 kg BW',
            date: 'Nov 2025',
          },
          {
            name: 'Sam Rivera',
            weight: '167.5 kg',
            detail: '@ 71 kg BW',
            date: 'Oct 2025',
          },
        ]}
      />
    </div>
  )
}

API reference

PrLeaderboard accepts the following props.

Prop	Type	Default	Description
`heading`	`string`	`'The record board'`	–
`eyebrow`	`string`	–	coach-voice kicker, e.g. CHALK UP
`liftLabel`*	`string`	–	which record, e.g. Back squat, all-time; renders uppercase under the heading
`entries`*	`PrLeaderboardEntry[]`	–	ranked by array order (rank renders from index, deterministic)
`newLabel`	`string`	`'New'`	real-text mark on fresh PR rows, rendered uppercase
`note`	`string`	–	verification footnote in plain sans

…plus everything from React.HTMLAttributes<HTMLElement>: className, event handlers, aria attributes and the rest pass straight through.

Referenced types

Typestsx

export interface PrLeaderboardEntry {
  name: string
  /** preformatted, e.g. 212.5 kg */
  weight: string
  /** e.g. @ 82 kg BW */
  detail?: string
  /** preformatted, e.g. Mar 2026, never derived from Date in render */
  date?: string
  /** renders the NEW mark */
  isNew?: boolean
}

Related components

Challenge Countdown Panel

A gym challenge block that starts the clock, bold condensed challenge name, an SSR-safe rolling countdown to a prop-driven start date, stakes line and spots left. React and Tailwind.

Class Timetable

A weekly timetable with gym-wall energy, bold condensed class names, mono start times, coach lines, five-dot intensity marks, and a spots-left state that makes you book now.

Coach Cred Strip

A certifications strip that treats coaching credentials as data, cert codes in mono with sr-only expansions, years and clients in tabular figures, and one lead-coach keyline.

Gym Stats Board

The gym's numbers board, members, classes a week, and PBs this month counting up in heavy tabular figures under bold condensed labels, with a plain-spoken honesty footnote.

Membership Tiers

Gym pricing in the coach's voice, bold uppercase tier names like FOUNDATION and SURGE, per-week prices in big tabular figures, commitment notes, and a ruled ledger with zero glow.

Program Block Card

A training-program card in the coach's voice, phase name in bold condensed caps, weeks and sessions per week as mono data, an outcome promise line, and five difficulty dots.

Frequently asked questions

How do I install the PR Leaderboard component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/pr-leaderboard`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does PR Leaderboard require?

PR Leaderboard uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme PR Leaderboard to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Preview & code