MarsalaDS

Buscar

Páginas e componentes da documentação

Kpi Card

Receita líquida
R$ 128,4 mil
+12,5%vs. mês anterior

Uso

Card compacto para KPI: ícone do indicador (prop icon), valor grande e variação com seta/cor automáticas a partir de change.delta e polarity.

Quando usar

  • change.label + change.delta; polarity higher-is-better (padrão) ou lower-is-better (churn).
  • Ícone do card: prop icon (Hugeicons ou outro) — independente da seta de tendência.
  • period para contexto (ex.: vs. mês anterior).

Evite quando

  • Não use para conteúdo longo ou formulários — Card genérico.
  • Não duplique o valor na variação sem explicar o período.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/kpi-card

Exemplos

Variações comuns de uso.

Variação favorável

Receita líquida
R$ 128,4 mil
+12,5%vs. mês anterior

Variação desfavorável

Novos clientes
124
-18%vs. mês anterior

Só valor

Pedidos
842
Marsala Design System