Suburb Report Card

Installation

pnpm dlx shadcn@latest add @cleverui/suburb-report-card

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

Usage

tsx

import { SuburbReportCard } from '@/components/ui/suburb-report-card'

Exampletsx

import { SuburbReportCard } from '@/components/ui/suburb-report-card'

export default function SuburbReportCardDemo() {
  return (
    <div className="mx-auto flex max-w-sm justify-center px-4 py-10 sm:px-6 sm:py-14">
      <SuburbReportCard
        suburb="Kew"
        context="VIC 3101 · Houses"
        medianPrice={2410000}
        pricePrefix="$"
        medianLabel="Median sale price"
        deltaPct={4.2}
        deltaLabel="past 12 months"
        rows={[
          { label: 'Median days on market', value: '24' },
          { label: 'Auction clearance', value: '71%' },
          { label: 'Sales this quarter', value: '38' },
          { label: 'Vendor discount', value: '2.1%' },
        ]}
        asOf="Data to Jun 2026 · agency reported"
      />
    </div>
  )
}

API reference

SuburbReportCard accepts the following props.

Prop	Type	Default	Description
`suburb`*	`string`	–	the heading, e.g. Kew
`context`	`string`	–	state and property-type line, e.g. VIC 3101 · Houses
`medianPrice`*	`number`	–	final median as a number, counts up once in view
`pricePrefix`	`string`	`'$'`	–
`medianLabel`	`string`	`'Median sale price'`	–
`deltaPct`	`number`	–	signed 12-month change, e.g. 4.2 or -1.8
`deltaLabel`	`string`	`'past 12 months'`	–
`rows`*	`SuburbReportRow[]`	–	–
`asOf`	`string`	–	preformatted provenance, never derived from Date in render

…plus everything from Omit< React.HTMLAttributes<HTMLElement>, 'onDrag' | 'onDragStart' | 'onDragEnd' | 'onAnimationStart' >: className, event handlers, aria attributes and the rest pass straight through.

Referenced types

Typestsx

export interface SuburbReportRow {
  label: string
  value: string
}

Related components

Agent Profile Card

An agent card that sells with proof, portrait placeholder, sold count and median days-on-market ticking up in tabular figures, suburbs served as chips, and an appraisal CTA.

Auction Results Strip

Last weekend's auction results as a ruled band, a clearance rate counting up once, then sold and passed-in rows with addresses leading and prices set in tabular figures.

Appraisal CTA Panel

The what's-your-place-worth conversion block, a single address field with a callback-only submit, a recent-sales proof line in tabular figures, and an agent trust row.

Commission Breakdown Sheet

Agent fees in full view, commission rate as the hero figure, itemised campaign costs in a ruled Tailwind ledger, and a payable-at-settlement note. React transparency block.

Off-Market Teaser

A coming-soon listing teaser in React, suburb leads while the address stays withheld behind a redaction bar, with a launch date line and a register-interest CTA. Tailwind tokens.

Open Home Schedule

A week of inspections set like a printed schedule, days as ruled groups, each open home with its address, a tabular time range, and an add-to-calendar affordance via callback.

Frequently asked questions

How do I install the Suburb Report Card component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/suburb-report-card`. 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 Suburb Report Card require?

Suburb Report Card uses motion and lucide-react on top of React and Tailwind CSS. You don't need to install them manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Suburb Report Card 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