Cómo migrar de TailwindCSS v3 a v4 en un proyecto con Shadcn

Descubre cómo actualizar tu proyecto de TailwindCSS v3 a v4, los cambios más importantes y consejos prácticos para hacerlo sin dolores de cabeza.

Facu Guardia

Cómo migrar de TailwindCSS v3 a v4 en un proyecto con Shadcn

¿Por qué migrar a TailwindCSS v4?

TailwindCSS v4 ya está aquí, y trae consigo mejoras significativas en rendimiento, configuración CSS-first y una mejor detección de fuentes.

Ahora es más rápido que el café del lunes por la mañana. ¡Hasta 8 veces más rápido en builds!

Además, olvídate de peleas con configuraciones infinitas: v4 hace magia directamente desde tu CSS.

Preparando el terreno para la migración

Primero, asegúrate de tener tu proyecto funcionando bien en v3.

  • Haz un backup. No seas ese dev que dice ¿Qué podría salir mal?.
  • Actualiza dependencias porque, bueno, la vida sigue y los paquetes también.
  • Luego, instala TailwindCSS v4: npm install tailwindcss@4.0.0.

¿Listo? Ahora corre npx tailwindcss upgrade y observa cómo Tailwind hace su magia.

Instalación de TailwindCSS v4

Cambios clave en TailwindCSS v4

Aquí vienen los fuegos artificiales:

  • Configuración CSS-first: Ahora configuras desde el CSS. Adiós tailwind.config.js, aunque aún puedes mantenerlo si eres nostálgico.
  • Rendimiento mejorado: Builds 8 veces más rápidas.
  • Container Queries: Ahora puedes diseñar en función del contenedor.
  • Nuevo sistema de colores: Adiós RGB aburrido, hola OKLCH. Colores más vivos.

Adaptando Shadcn a TailwindCSS v4

Si usas Shadcn (porque claro, eres cool), aquí hay algunos ajustes:

  • Actualiza app.css con las nuevas directivas @tailwind.
  • Cambia la gestión de modo oscuro. Ahora usamos @media (prefers-color-scheme).
  • Ajusta colores y fuentes con el nuevo sistema de variables CSS.
Integración de Shadcn con TailwindCSS v4

En fin, ¿vale la pena?

Migrar a TailwindCSS v4 es más fácil de lo que parece.

Con mejoras en rendimiento, nuevas utilidades y una configuración más simple, vale la pena dar el salto.

¿Ya hiciste la migración?