# StatCard

Render a headline metric with optional trend. Because big numbers look cool.

## Notes

- Use StatCard when the primary value should dominate the presentation.
- Pass href when the metric should link to a deeper report or destination.

## Properties

| Name | Type | Default | Description |
| ---- | ---- | ------- | ----------- |
| label (required) | `string` | - | Label for the stat. |
| value (required) | `string | number` | - | Primary value to display. |
| trend | `'up' | 'down' | 'neutral'` | - | Trend direction. |
| trendValue | `string` | - | Trend text label. |
| icon | `string` | - | Optional icon HTML. |
| href | `string` | - | Optional link URL. |
| class | `string` | - | Additional CSS classes. |

## Example

```astro
<StatCard label="Builds passing" value="24" trend="up" trendValue="+3 this week" />
```