¿Qué hace money-data?
Cómo mostrar el dinero para que la gente lo lea bien a la primera. Estas reglas se aplican tanto a aplicaciones de consumo como a herramientas B2B densas. Provienen de estándares de tipografía y visualización de datos aplicados estrictamente al dinero, además de prácticas documentadas en Wise, Monzo, Stripe, Coinbase, Robinhood, Apple e IBM Carbon.
Combina esta habilidad con critical-core (riesgo, emoción, lenguaje visual) y money-flows (las acciones que mueven el dinero).
Cómo usar esta habilidad
- Nombra el trabajo de cada número. ¿Es un saldo, una cantidad a pagar, un delta, una tasa, una proyección, una referencia? El trabajo decide el formato, la precisión, el color y la posición.
- Carga la referencia que necesites (a continuación) antes de escribir código o especificar un componente. Usa los valores exactos; no improvises formatos.
- Escribe los estados, no solo el camino feliz. Cada superficie de dinero tiene estados de carga, desactualizado, pendiente, fallido, vacío y oculto.
- Ejecuta la lista de verificación al final antes de entregar cualquier cosa.
| Referencia | Cárgala para |
|---|---|
references/numbers-and-identifiers.md | Formato de moneda, unidades menores, redondeo, notación compacta, números negativos, cifras tabulares, enmascaramiento de números de cuenta, unidades y dosis |
references/color-and-gain-loss.md | Color positivo/negativo según la configuración regional, pares seguros para daltonismo, contraste para marcas, tokens semánticos |
references/charts.md | Selector de gráficos, líneas base, rangos de tiempo, proyecciones e incertidumbre, sparklines, exploración, accesibilidad de gráficos, límites de gamificación |
references/progress-and-status.md | Umbrales de carga, mapas de estado de pagos y transferencias, estado de tarjetas, disputas y KYC, metas de ahorro y medidores de crédito |
references/records-and-dashboards.md | Filas de transacciones, limpieza de comercios, recibos, estados de cuenta, paneles de control B2B, cuadrículas de datos financieros, registros de auditoría, conciliación |
Los tokens de diseño originales para todo lo anterior se encuentran en /tokens en la raíz del repositorio.
Las reglas que más importan
Cada regla lleva un tipo de fuente: [REG] ley o estándar, [RES] investigación publicada, [PRAC] práctica empresarial documentada, [INF] síntesis crítica de UX.
- Formatea con la plataforma, nunca a mano. Usa
Intl.NumberFormat(web),NumberFormatter/FormatStyle(Apple),NumberFormat/DecimalFormat(Android). Manejan la posición del símbolo, los separadores y las unidades menores de cada moneda (JPY no tiene, KWD tiene tres). [PRAC] - Cada cantidad lleva su moneda. No hay números desnudos en productos multimoneda. Usa el código ISO (USD) cuando el símbolo es ambiguo ($ solo puede significar USD, CAD, AUD, MXN y otros). [INF]
- Cifras tabulares para cualquier número que cambie o esté en una columna (
font-variant-numeric: tabular-nums). Las cifras proporcionales tiemblan a medida que los valores cambian. [PRAC] - Notación compacta solo en ejes y resúmenes de tarjetas. Nunca en un saldo, monto de pago, tarifa o cualquier cosa sobre la que la persona vaya a actuar. [INF]
- Las partes suman el total, o la pantalla dice que se aplica redondeo. [INF]
- Positivo y negativo son tokens semánticos resueltos por configuración regional o ajuste, no verde y rojo codificados. Rojo significa subida en los mercados de China continental, Japón y Taiwán. Siempre combina el color con un signo (+/−) y un glifo. [RES/PRAC]
- Las marcas de los gráficos alcanzan un contraste de 3:1 con los colores adyacentes (WCAG 1.4.11), y ningún significado depende solo del color (WCAG 1.4.1). [REG]
- Las barras comienzan en cero. Las líneas pueden no hacerlo. Las barras truncadas exageran las diferencias. [RES]
- Nunca muestres una sola línea para un futuro incierto. Las proyecciones de ahorros, jubilación, amortización de préstamos o pronósticos utilizan un gráfico de abanico o de bandas. Un estudio del Banco de Inglaterra de 2026 (n≈1600) encontró que los gráficos de abanico transmitían mejor la expectativa y la incertidumbre y protegían la confianza después de un error. [RES]
- Cada gráfico tiene una vista de tabla y un resumen en una línea de titular. La exploración tiene un equivalente de teclado y lector de pantalla. [PRAC]
- Indica la línea base de cada delta. "+2.4% hoy (desde el cierre de ayer)". [PRAC]
- El progreso es honesto. Asigna los estados del backend a 3–5 etapas simples con marcas de tiempo. "Enviado" no es "llegado". Las ETA se etiquetan como estimaciones. El dinero devuelto tiene su propio estado no final. [PRAC]
- Muestra que un toque se registró de inmediato. Las advertencias "No presiones dos veces" fallan; un estado instantáneo de "procesando" con el botón deshabilitado funciona. [RES]
- Enmascara los identificadores por defecto (•••• 4421), revélalos bajo demanda con reautenticación para números completos. [PRAC]
- Pendiente está etiquetado y explicado, y nunca se agrega o elimina silenciosamente del saldo disponible. [INF]
- No hay mecánicas de recompensa en gráficos de inversión, crédito o gasto (confeti en operaciones, revelaciones de rasca y gana, clasificaciones de popularidad). Robinhood pagó $7.5M a Massachusetts en 2024 por estas prácticas. [REG]
Especificaciones rápidas
Jerarquía de cantidades. En una pantalla de saldo o pago, la cantidad es el texto más grande, en cifras tabulares, con la moneda en el mismo peso visual o un paso más claro. Los dígitos decimales pueden ser más pequeños pero nunca con un contraste inferior a 4.5:1.
Etiqueta delta. +£12.40 (+0.8%) hoy → signo, absoluto, relativo, período. Token de color + glifo de flecha + signo. El cero se muestra como £0.00 (0.0%) sin signo y con color neutro (signDisplay: "exceptZero").
Chip de estado. Icono + palabra + color, nunca solo color. Usa verbos que la gente entienda: Pendiente, Pagado, Fallido, Reembolsado, Devuelto. Evita códigos internos (AUTHORISED, SETTLED).
Antes de entregar, verifica
- Cada cantidad formateada por la API de la plataforma para la configuración regional del usuario, con moneda
- Cifras tabulares en todos los números cambiantes o en columnas
- Sin notación compacta en cantidades sobre las que se va a actuar
- Ganancia/pérdida usa tokens semánticos + signo + glifo; probado con un simulador de daltonismo
- Barras desde cero; proyecciones como bandas; líneas base indicadas
- Cada gráfico tiene un titular, una vista de tabla y acceso por teclado
- Cada estado tiene estados de carga, pendiente, fallido, devuelto y desactualizado con marcas de tiempo
- Identificadores enmascarados; la revelación es deliberada
- El modo de saldo oculto (privacidad) funciona en todas las superficies de dinero
- El texto se escala al 200% sin truncar cantidades
Lee los enlaces de origen dentro de cada referencia antes de confiar en un punto regulatorio para un producto en producción.