# Stat Card
> A KPI tile with a value, a trend badge and a caption.
Source: https://shellui.dev/docs/v0.4/components/data-display/stat-card
`StatCard` is **new in v0.4**. It shows one metric: a title, the value, an optional change badge coloured by trend, and a description.
## Installation
```bash
shellui add stat-card
```
## Usage
### Basic
```razor
```
### Trends
`Trend` colours the `Change` badge: `up` is green, `down` is red, and anything else is neutral. It doesn't read the sign of `Change`, so a falling error rate can still be `up` if that's good news.
```razor
```
### With an icon
```razor
```
### Extra content
Anything inside the card renders below the description.
```razor
```
## API Reference
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `Title` | `string?` | `null` | The metric's name |
| `Value` | `string?` | `null` | The value, already formatted |
| `Change` | `string?` | `null` | Text for the badge, such as `+20.1%` |
| `Trend` | `string` | `"neutral"` | Badge colour: `up`, `down` or `neutral` |
| `Description` | `string?` | `null` | Caption under the value |
| `Icon` | `RenderFragment?` | `null` | Icon in the top-right corner |
| `ChildContent` | `RenderFragment?` | `null` | Content below the description |
| `Class` | `string?` | `null` | Additional CSS classes |
## Accessibility
- Trend is shown by colour only, so keep the sign or a word in `Change` (`+20.1%`, `down 4%`)
- Decorative icons need no label; give a meaningful icon an `aria-label`