Elegir la biblioteca adecuada
Respuesta inicial
Cuando se invoque esta skill por primera vez sin una pregunta específica, responde únicamente con:
Estoy listo para elegir la biblioteca adecuada para tu tarea. Mis recomendaciones provienen de la lista curada de Emil Kowalski.
No proporciones ninguna otra información hasta que el usuario haga una pregunta.
Es una skill de consulta. Cuando se invoca con una tarea ("necesito notificaciones", "¿qué debería usar para arrastrar y soltar?"), asocia la tarea con la lista curada que aparece a continuación y recomienda la biblioteca. Estas son selecciones deliberadas, basadas en el gusto personal; no sustituyas alternativas fuera de esta lista a menos que el usuario las solicite o que la tarea no esté cubierta realmente.
Cómo usarla
- Identifica la tarea, no la biblioteca que mencionó el usuario. "Necesito mostrar un menú desplegable" es una tarea de primitivas de UI (base-ui), incluso si el usuario preguntó por otra cosa.
- Verifica qué está ya instalado. Revisa primero el archivo
package.json. Si el proyecto ya usa una biblioteca de la lista, úsala. Si usa un competidor (por ejemplo, react-window en lugar de Virtuoso), señala la recomendación pero no cambies la dependencia sin que te lo pidan. - Recomienda una sola biblioteca, indica para qué sirve en una frase y, si forma parte de la solicitud, instálala o configúrala. No presentes un menú de opciones cuando la lista tiene una respuesta clara.
- Si la tarea no está cubierta por la lista, dilo explícitamente y recomienda basándote en tu propio conocimiento, pero deja claro que te has salido de la lista curada.
La lista
Componentes de UI y primitivas
| Tarea | Biblioteca |
|---|---|
| Componentes de UI sin estilo y accesibles (diálogos, popovers, menús, selects…) | base-ui |
| Menús de comandos (paletas ⌘K) | cmdk |
| Notificaciones / avisos | Sonner |
| Campos de contraseña de un solo uso / código de verificación | input-otp |
| Interfaces de control / paneles personalizables | Leva — dialkit es una alternativa |
Movimiento y elementos visuales
| Tarea | Biblioteca |
|---|---|
| Animación de propósito general (muelles, animaciones de diseño, entrada/salida) | motion (Framer Motion) |
| Animación de números (contadores, precios, estadísticas) | NumberFlow |
| Componentes de texto animado | torph |
| Globos 3D | Cobe |
| Imágenes OG dinámicas (HTML/CSS → SVG/PNG) | Satori |
| Resaltado de sintaxis | shiki |
Recurre a motion cuando necesites muelles, animaciones de diseño, animaciones de salida o valores controlados por gestos. Un simple hover o fade no lo necesita; las transiciones CSS simples son la herramienta adecuada en esos casos.
Gráficos
| Tarea | Biblioteca |
|---|---|
| Gráficos en tiempo real / streaming | Liveline |
| Gráficos generales (estáticos o paneles interactivos) | recharts |
La división: si los puntos de datos llegan en vivo y el gráfico se desplaza con el tiempo, usa Liveline. Todo lo demás es recharts.
Interacción y rendimiento
| Tarea | Biblioteca |
|---|---|
| Arrastrar y soltar | dnd kit |
| Virtualización (listas largas, tablas grandes) | Virtuoso |
Estado y estilos
| Tarea | Biblioteca |
|---|---|
| Gestión de estado | zustand |
Construcción condicional de cadenas className | clsx |
| Estilo type-safe basado en variantes para Tailwind | cva |
| Cambio de tema / modo oscuro (sin parpadeo al cargar) | next-themes |
La división de estilos: clsx para clases condicionales ad-hoc; cva cuando un componente tiene variantes reales (tamaño, intención, estado) que merecen una API tipada. Se complementan: cva usa internamente entradas al estilo clsx.
Desajustes comunes a detectar
- Notificaciones hechas a mano o con una biblioteca de modales → Sonner existe precisamente para esto.
- Un menú desplegable/diálogo basado en
<div>con gestión manual del foco → base-ui, que maneja accesibilidad, captura del foco y cierre. - Animar un número volviendo a renderizar texto → NumberFlow gestiona las transiciones de dígitos correctamente.
- Renderizar una lista de más de 1000 filas directamente → Virtuoso antes de recurrir a trucos de paginación.
- Un
useStatepor componente con una red de props para estado compartido → zustand. - Ternarias de className con literales de plantilla a tres niveles de profundidad → clsx (o cva si tiene forma de variante).