Data

StatCard

Metric display card with icon, trend indicator, and value.

Quick Preview

Total Revenue

$48,295

This month

+12.5%vs last month

Installation

npm install lucide-react

// Copy from
src/components/data/StatCard.tsx

Examples

Stats dashboard

Users

12,430

+8%this week

Revenue

$94K

+12%this month

Uptime

99.9%

Stable

Growth

23%

-2%vs target

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a data component named StatCard in React/Next.js.
Goal: recreate the same overall UI and behavior as the StatCard reference from a component gallery.
What it needs to communicate: Metric display card with icon, trend indicator, and value..

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Make data density readable with crisp spacing, hierarchy, and state styling.
- Use accessible labels, legends, and semantic structure when needed.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- title: string — required — Card label
- value: string | number — required — Metric value to display
- subtitle: string — Secondary text below value
- icon: React.ReactNode — Icon displayed in corner badge
- trend: 'up' | 'down' | 'neutral' — Trend direction
- trendValue: string — Trend percentage or value text
- trendLabel: string — Trend context label
- className: string — Additional CSS classes

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- Trend indicators
- Icon badge
- Accessible markup
- Flexible value types

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`title`*	`string`	-	Card label
`value`*	`string \| number`	-	Metric value to display
`subtitle`	`string`	-	Secondary text below value
`icon`	`React.ReactNode`	-	Icon displayed in corner badge
`trend`	`'up' \| 'down' \| 'neutral'`	-	Trend direction
`trendValue`	`string`	-	Trend percentage or value text
`trendLabel`	`string`	-	Trend context label
`className`	`string`	-	Additional CSS classes