---
name: kpi_card
kind: component
lang: typescript
domain: ui
version: "1.0.0"
purity: impure
signature: "KPICard(props: KPICardProps): JSX.Element"
description: "Card de KPI con label, valor, delta porcentual con color semántico, icono y subtítulo. 3 tamaños."
tags: [kpi, card, metrics, dashboard, component, ui]
uses_functions: [cn_typescript_core]
uses_types: []
returns: []
returns_optional: false
error_type: ""
imports: [react]
tested: false
tests: []
test_file_path: ""
file_path: "frontend/functions/ui/kpi_card.tsx"
props:
  - name: label
    type: "string"
    required: true
    description: "Etiqueta del KPI"
  - name: value
    type: "string | number"
    required: true
    description: "Valor principal"
  - name: delta
    type: "{ value: number; isPositive: boolean }"
    required: false
    description: "Cambio porcentual con dirección"
  - name: icon
    type: "ReactNode"
    required: false
    description: "Icono decorativo"
  - name: size
    type: "'sm' | 'default' | 'lg'"
    required: false
    description: "Tamaño"
emits: []
has_state: false
framework: react
variant: [sm, default, lg]
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
source_license: "MIT"
source_file: "frontend/src/components/ui/kpi-card.tsx"
---

## Ejemplo

```tsx
<KPICard label="Revenue" value="$12,450" delta={{ value: 12.5, isPositive: true }} />
<KPICard label="Users" value={1234} size="lg" icon={<UsersIcon />} />
```