Skip to content

Icons

Icons reúne en un solo lugar todos los íconos disponibles para los componentes de Monkey. Al estar centralizados en una instancia única, se reutilizan en cualquier parte del diseño y garantizan una interfaz coherente y uniforme.

Los íconos refuerzan el significado de acciones, estados y secciones, y ayudan a escanear la interfaz más rápido. Icons asegura que todos compartan el mismo lienzo, el mismo peso de trazo y el mismo comportamiento de color, sin importar en qué componente aparezcan.

El diseñador debe llamar siempre al componente Icons y elegir el ícono por su nombre. No se insertan íconos sueltos ni se dibujan versiones propias dentro de un componente.

  1. Lienzo: 24 × 24 px
  2. Trazo: 1.75 px, convertido a forma
  3. Color: uno solo, heredado del contexto
  1. Lienzo base: cuadrado de 24 × 24 px. Todos los íconos se diseñan y se exportan sobre este lienzo.
  2. Trazo: el trazo inicial es de 1.75 px. En los íconos curados ese trazo ya está convertido a forma, así que al escalar el ícono el grosor crece en proporción y mantiene una apariencia coherente en todos los tamaños.
  3. Forma: terminaciones y uniones redondeadas, heredadas del estilo de Lucide.
  4. Color: un único color que el ícono toma de su contexto (el texto o el componente que lo contiene). Solo los íconos de marca conservan sus colores originales.
  • Llamá al componente Icons y elegí el ícono por su nombre, tal como figura en el catálogo de esta página.
  • Elegí un tamaño de la escala de íconos. Si ninguno encaja, podés usar un tamaño custom, siempre múltiplo de 4 px.
  • El color lo define el componente que contiene al ícono. En un botón, por ejemplo, el ícono toma el color del texto del botón.
  • Si necesitás un ícono que no está en el catálogo, pedilo al equipo de Design System para que se cure y se sume a la librería. Mientras tanto, el sistema lo toma directamente de Lucide.

Monkey usa la librería Lucide como base y suma íconos propios para conceptos del negocio que Lucide no cubre, como eCheq, CiDi o MODO.

Un ícono curado es un ícono de Lucide o propio que ya pasó por la revisión del sistema: lienzo de 24 × 24 px, trazo de 1.75 px convertido a forma y un único color. Los íconos del catálogo de esta página son los curados.

Base: 16 px (1 rem).

2xs
xs
sm
md
lg
xl
2xl
3xl
4xl
Nombre Valor Uso sugerido
2xs 10 px Indicadores mínimos junto a texto legal o captions.
xs 12 px Acompañar texto pequeño, badges y chips.
sm 16 px Íconos dentro de botones e inputs de tamaño estándar.
md 20 px Botones grandes, ítems de menú y listas.
lg 24 px Tamaño base. Navegación, headers y acciones independientes.
xl 32 px Destacados dentro de tarjetas y accesos rápidos.
2xl 36 px Accesos principales de un dashboard.
3xl 48 px Estados vacíos compactos y mensajes de confirmación.
4xl 64 px Estados vacíos, pantallas de éxito o error.
Custom Múltiplo de 4 px Lo elige el diseñador cuando ningún valor de la escala encaja.

El ícono no tiene estados propios. Hereda el estado del componente que lo contiene: cuando un botón pasa a Hover, Focus, Active o Disabled, el ícono cambia de color junto con el texto del botón.

Default
Hover / Activo
Disabled
  • Default: toma el color de texto del contenedor.
  • Hover / Active: cambia junto al texto o al fondo del componente; nunca por separado.
  • Focus: el indicador de foco lo dibuja el componente interactivo, no el ícono.
  • Disabled: baja su contraste junto al resto del componente.
  • Para reforzar el significado de una acción o de una etiqueta de texto.
  • En acciones universales que el usuario reconoce sin texto: buscar, cerrar, editar, eliminar, descargar.
  • Para diferenciar secciones de navegación, categorías o tipos de operación.
  • Para comunicar estados (éxito, advertencia, error, información) junto con color y texto.
  • Como único medio de comunicar algo importante: acompañalo de texto o de un nombre accesible.
  • Con significados ambiguos: si el ícono admite varias lecturas, usá un botón con texto.
  • Como decoración que compite con el contenido: menos íconos, mejor jerarquía.
  • Mezclando estilos: no combines íconos de otras librerías, rellenos distintos o trazos de otro grosor.
  • Recoloreando íconos de marca: los íconos de marca (etiqueta Marca en el catálogo) se usan siempre con sus colores originales.
  • Tamaño: cualquier valor de la escala o un tamaño custom múltiplo de 4 px.
  • Color: por defecto hereda el color del contexto. Se puede fijar con un token de color del sistema, por ejemplo el primario o los de estado (info, éxito, advertencia, error).
  • Ícono de marca: íconos con más de un color, como CiDi. Mantienen sus colores y no se adaptan al contexto.
  • Decorativo o con significado: si el ícono acompaña a un texto que ya dice lo mismo, es decorativo y se oculta al lector de pantalla. Si el ícono está solo y transmite información, necesita un nombre accesible.
Éxito
Advertencia
Error
Info
Marca

Siempre debemos tener un contraste mínimo de 3:1 entre el ícono y su fondo.

Principio Pauta Criterio Comentario
Distinguible 1.4.11 Non-text Contrast (Level AA) 3:1 Un buen contraste entre el ícono y el fondo es esencial para que se reconozca.
Operable 2.5.8 Target Size (Minimum) (Level AA) 24 × 24 px Si el ícono es accionable, su área interactiva debe medir al menos 24 × 24 px, aunque el ícono sea más chico.
  • Íconos decorativos: se ocultan al lector de pantalla para no repetir información.
  • Íconos con significado: anuncian un nombre claro de la acción, por ejemplo “Descargar comprobante” y no “flecha abajo”.
  • Íconos accionables: usá ActionIcon o Button, que ya resuelven el área mínima, el foco visible y el nombre accesible.

Buscá un ícono por su nombre y hacé click para copiarlo.

Propios de Monkey 41

Lucide curados 124

El historial de cambios de todos los componentes de Monkey se registra en la Sheet de ChangeLog.