Saltar al contenido

Viniendo de Tailwind

TaishoDS Core es un sistema de diseño sin framework, con su propio vocabulario de clases. Esta guía muestra qué clase de TaishoDS Core equivale a cada clase de Tailwind, en qué se parecen los dos vocabularios y en qué no, y el camino para pasar de uno al otro sin romper el proyecto en el medio.

Las diez trampas más comunes

Estas clases se escriben igual en los dos sistemas y miden otra cosa. Ninguna da error: la página sólo sale distinta.

Clase En Tailwind En TaishoDS Equivalente
p-416 px4 pxp-16
px-624 px6 pxpx-24
gap-416 px4 pxgap-16
mt-832 px8 pxmt-32
w-64256 px64 pxw-256
h-1248 px12 pxh-48
size-832 px8 pxsize-32
w-96384 px96 pxninguno (la escala llega a 256)
blur-sm8 px4 pxblur-md
leading-1040 px de interlineadoel número es el tamaño de texto al que acompaña (el interlineado es 14 px)leading-32

taisho migrate --from tailwind traduce estos números solo, salvo w-96, que no tiene equivalente y queda en su reporte. taisho check --other-scale los marca en lo que se escribe a mano, en los elementos con la llave ts.


Antes de la tabla: las medidas

Es lo primero que se rompe al migrar. En Tailwind el número de una medida es un paso de 4px (w-64 = 16rem = 256px con 1rem = 16px); en TaishoDS es el valor en px (ts-w-64 = 64px). Por eso la tabla se arma por el valor en px y no por el número, y la columna `nota` de cada medida dice los dos.

Tailwind Mide TaishoDS
w-6416rem = 256pxw-256
w-164rem = 64pxw-64
p-41rem = 16pxp-16
mt-20.5rem = 8pxmt-8

En la segunda fila, w-16 en Tailwind y w-16 no miden lo mismo. Si se copia el número, el layout sale chico. Lo que se copia es la medida, no el número: por eso la tabla de más abajo está armada por el valor en píxeles y no por el número de la clase.

No hay un reemplazo mecánico por número

Copiar la clase de Tailwind tal cual (p-4) cambia las medidas en silencio y no da error: en el sistema es otra cantidad. Hay que usar la tabla de equivalencias.

Qué cambia además de las medidas

El vocabulario es cerrado

No hay valores arbitrarios: p-[13px] o bg-[#1da1f2] no tienen equivalente. Cada clase existe porque su valor está en una escala, y las escalas son las del sistema (Tokens). Cuando hace falta un valor que no está, la salida es un token en tu config o una utilidad propia hecha de las que ya existen, no un valor suelto en el HTML. Los escalones que Tailwind tiene y TaishoDS no (p-28, opacity-5…) aparecen al final de la tabla con su motivo.

ts

Las variantes: las mismas, con una lista cerrada

Las variantes de estado más usadas existen y se escriben igual: hover:, focus:, focus-visible:, active:, disabled:, checked:, invalid:, group-* y peer-* (también con nombre, group/menu), aria-<estado>:, data-<nombre>: y print:, más las de pantalla y de contenedor. Se pueden encadenar (md:hover:), siempre en el mismo orden. La guía Variantes las explica una por una.

Hay diferencias que conviene saber. disabled: vale también para aria-disabled="true". data-<nombre>: sólo mira si el atributo está, no su valor, y aria-<estado>: acepta una lista cerrada de estados booleanos. Una variante con corchetes (data-[open]:, aria-[sort=up]:) no tiene equivalente, como pasa con los valores arbitrarios. Tampoco existen has-*, not-*, first:, odd:, focus-within:, motion-* ni supports-*. Y las variantes valen sobre utilidades, no sobre las clases de un componente.

Las variantes por ancho de pantalla tienen el mismo corte en píxeles en los dos lados: sm: 640px, md: 768px, lg: 1024px, xl: 1280px. Los topes max-sm: también valen, pero no hay rangos de los dos lados en una clase (md:max-xl:), y 2xl: se agrega con extend.screens en el config. Los detalles están en Responsive.

dark: tampoco existe, y no hace falta: el modo oscuro sale del tema (Theming), no de una variante en cada clase. Y space-x-* / space-y-* se reemplazan por gap en el contenedor flex o grid.

Lado lógico, no físico

pl-*, pr-*, ml-*, mr-*, left-*, right-*, text-left y text-right pasan al lado lógico (ps, pe, ms, me, start, end, align-start, align-end). En un idioma que se lee de derecha a izquierda se espejan solos; en Tailwind, no. Es un cambio de comportamiento y está bien: la fila de la tabla lo avisa en la columna «Qué cambia». Ver RTL.

Colores: el mismo nombre no es el mismo color

El nombre coincide, el color no: la paleta de TaishoDS sale de las semillas de tu tema (OKLCH), no de la de Tailwind. Conviene revisar el resultado a ojo. Sólo gray coincide por nombre; las demás familias de Tailwind (slate, zinc, neutral, stone…) no existen: tu paleta sale de las semillas de tu tema. Los prefijos cambian en uno solo: bg- y border- se escriben igual, y el color de texto es color- (porque text- es el tamaño).

Y la cascada

El CSS del sistema vive en capas (@layer base, components, utilities, states, utility-states, print). Una regla tuya sin capa le gana a la del sistema; si tu CSS también usa capas, decide el orden en que las declares. En modo scope la especificidad de una regla del sistema es la de una clase, la misma que la de una clase tuya, así que entre las dos decide el orden en el archivo.


La tabla de equivalencias

Hecha para Tailwind 4.x con su tema por defecto (1405 filas). La genera un comando a partir de las escalas del sistema, no está escrita a mano, y cada clase de TaishoDS que lista existe y cumple la gramática de nombres. Cuando la columna «Qué cambia» tiene una nota, el mismo resultado no es idéntico: conviene leerla antes de reemplazar. Cada familia está plegada.

Lo que no tiene equivalente

Clases de Tailwind Por qué no hay equivalente
inset-px, inset-0.5, inset-1, inset-1.5, inset-2, inset-2.5 … (26)inset: no hay clase en px ni paso de ritmo para este prefijo
inset-x-px, inset-x-0.5, inset-x-1, inset-x-1.5, inset-x-2, inset-x-2.5 … (26)inset-x: no hay clase en px ni paso de ritmo para este prefijo
inset-y-px, inset-y-0.5, inset-y-1, inset-y-1.5, inset-y-2, inset-y-2.5 … (26)inset-y: no hay clase en px ni paso de ritmo para este prefijo
p-28, px-28, py-28, pt-28, pb-28, ps-28 … (46)112px no está en la escala de medidas (sizing)
p-36, px-36, py-36, pt-36, pb-36, ps-36 … (46)144px no está en la escala de medidas (sizing)
p-44, px-44, py-44, pt-44, pb-44, ps-44 … (46)176px no está en la escala de medidas (sizing)
p-52, px-52, py-52, pt-52, pb-52, ps-52 … (46)208px no está en la escala de medidas (sizing)
p-60, px-60, py-60, pt-60, pb-60, ps-60 … (46)240px no está en la escala de medidas (sizing)
p-72, px-72, py-72, pt-72, pb-72, ps-72 … (46)288px no está en la escala de medidas (sizing)
p-80, px-80, py-80, pt-80, pb-80, ps-80 … (46)320px no está en la escala de medidas (sizing)
p-96, px-96, py-96, pt-96, pb-96, ps-96 … (46)384px no está en la escala de medidas (sizing)
rounded-4xl32px no está en la escala de radios
text-3xl30px no está en la escala de texto (10, 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 60, 72)
text-8xl96px no está en la escala de texto (10, 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 60, 72)
text-9xl128px no está en la escala de texto (10, 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 60, 72)
leading-3interlineado de 12px no está en la escala
leading-snug, leading-normal, leading-relaxed, leading-looseinterlineado sin unidad: sólo existen `none` y `tight`
opacity-5opacidad 5 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-10opacidad 10 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-15opacidad 15 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-20opacidad 20 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-25opacidad 25 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-35opacidad 35 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-45opacidad 45 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-55opacidad 55 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-65opacidad 65 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-85opacidad 85 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
opacity-95opacidad 95 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100)
duration-7575ms no está en la escala de duraciones
duration-700700ms no está en la escala de duraciones
duration-10001000ms no está en la escala de duraciones
ease-out, ease-in-outesa curva de easing no está en la escala
blur-md, backdrop-blur-mdblur de 12px no está en la escala
blur-xl, backdrop-blur-xlblur de 24px no está en la escala
blur-2xl, backdrop-blur-2xlblur de 40px no está en la escala
blur-3xl, backdrop-blur-3xlblur de 64px no está en la escala
shadow-2xs, shadow-xs, shadow-2xlesa sombra no existe en la escala de TaishoDS (sm, md, lg, xl)
static, line-clamp-5, line-clamp-6la clase de TaishoDS no está emitida (su vocabulario es más corto que el de Tailwind)
bg-white, text-white, bg-black, text-black, bg-current, text-current … (8)white, black, current e inherit no son colores del tema (el color sale de las semillas): para una superficie, `bg-background-100` o un gris de la escala (`bg-gray-100`…`bg-gray-1000`); para el texto, `color-gray-1000` o el color del tema
2xl:*el corte 2xl no está en las pantallas del Core; se agrega con extend.screens
p-[13px], w-[calc(100%-2rem)], bg-[#1da1f2]valores arbitrarios: el vocabulario es cerrado. La escotilla es un token del config (taisho.user.ts) o una utilidad propia en `utilities`
data-[open]:*, aria-[sort=up]:*, has-*:*, not-*:*, first:*, odd:* … (9)variantes fuera de la lista cerrada: las de estado que existen son hover, focus, focus-visible, active, disabled, checked, invalid, group-*, peer-*, aria-<estado>, data-<nombre> (sólo presencia) y print; para lo demás, una clase propia en tu CSS
dark:*no hay variante `dark:`: el oscuro sale del tema (`light-dark()`, `createTheme`), no de una clase por elemento
space-x-*, space-y-*no existen; se reemplazan por `gap-*` en el contenedor flex/grid
rotate-0, rotate-1, rotate-2, rotate-3, rotate-6, rotate-12 … (8)sólo existe `rotate-180`: no hay otros giros; para otro ángulo, una utilidad propia en `utilities`
border-solid, border-dashed, border-dotted, border-double, border-hiddenel estilo del borde no es una clase aparte: los bordes de TaishoDS son sólidos; para guiones o puntos, una utilidad propia en `utilities`
grayscale, grayscale-0, invert, invert-0, sepia, sepia-0no hay filtros de color: sólo `blur-*` y `backdrop-blur-*`; para otro filtro, una utilidad propia en `utilities`
bg-gradient-to-*, bg-linear-*no hay gradientes: el fondo es un color de la escala; para un gradiente, una utilidad propia en `utilities`
border-0, border-8, border-t, border-b, border-l, border-r … (8)el ancho `border-N` (1 a 4) dibuja los cuatro lados y `border-none` lo quita: no hay `border-0` ni `border-8`, ni un lado o un eje sin número; el de un solo lado (`border-t-N`) sólo fija el ancho y el trazo lo dibuja `border-t-<familia>-<n>`
transitionno hay una `transition` sola: se elige la propiedad (`transition-colors`, `transition-opacity`, `transition-shadow`, `transition-transform`, `transition-all`); `duration-*` y `ease-*` fijan la duración y la curva, y los componentes ya traen su transición; para otra propiedad, una utilidad propia en `utilities`
ring, ring-0, ring-8, ring-insetel anillo va de 1 a 4 (`ring-1`…`ring-4`): no hay `ring` sin número, `ring-0`, `ring-8` ni `ring-inset`; el anillo de foco lo pone el reset (`:focus-visible`) y cada componente
outline-hiddenno hay `outline-hidden`: para quitar el contorno, `outline-none`
mt-auto, mb-autosólo existen `m-auto`, `mx-auto`, `my-auto`, `ms-auto` y `me-auto`
md:max-xl:*, min-md:*no hay rangos: cada pantalla tiene su variante «desde» (`md:`) y su variante «hasta» (`max-md:`), pero no las dos a la vez en una clase

La tabla cubre las familias de arriba. Lo que no está en ninguna parte (transformaciones, la mayoría de los márgenes negativos) todavía no está cubierto, ni con fila ni con motivo: conviene no asumir que no existe y buscarlo en Utilidades.


Migrar paso a paso

Durante la migración, TaishoDS Core y Tailwind pueden estar cargados a la vez. Hay un orden que importa: Tailwind primero y TaishoDS después. Un elemento con la llave ts toma entonces el estilo de TaishoDS, y uno sin ella sigue con el de Tailwind. Al revés se rompe: p-16 mide 64px en Tailwind y 16px en TaishoDS, y las dos hojas definen esa clase. Por eso se migra elemento por elemento: al pasar uno, se cambian todas sus clases y se le pone la llave. Un fragmento de ejemplo, antes y después (cada clase sale de la tabla de arriba):

Tailwind
TaishoDS

1. TaishoDS se suma después de Tailwind

El Core se instala con la guía de Instalación y su hoja se carga después de la de Tailwind. Los elementos sin la llave ts no toman nada del sistema, salvo el reset, que es global (Nombres de clases).

Orden de las hojas
  • Se borra: nada todavía.
  • Se verifica: que la página sigue igual con las dos hojas de estilo cargadas.

2. Se pasa pantalla por pantalla

Se corre la herramienta (más abajo) o se reemplazan las clases de una pantalla con la tabla. Primero se cambian las medidas (el número no es el mismo), después los lados (físico a lógico) y los colores. Lo que no tiene fila queda para una clase propia o un token del config.

  • Se borra: las clases de Tailwind de esa pantalla, sin dejar ninguna.
  • Se verifica: la pantalla a ojo en claro y oscuro, y en un idioma de derecha a izquierda si se soporta. Conviene buscar con el editor que no quede ninguna clase de Tailwind en lo migrado, en especial las variantes de estado.

3. Se saca Tailwind

Cuando la herramienta ya no reporta nada y no queda ninguna clase de Tailwind en el proyecto, se saca del build y de las dependencias, y se corre npx taisho generate.

  • Se borra: Tailwind del build y de las dependencias.
  • Se verifica: que cada elemento con clases del sistema tenga la llave ts (si falta, no da error: no toma estilos).

Migrar con una herramienta

taisho migrate --from tailwind traduce las clases de Tailwind a las de TaishoDS con la misma tabla de esta página. Sin --write sólo reporta: no toca ningún archivo. Con --write aplica los cambios, así que conviene hacer commit antes.

Comando

Convierte lo que es claramente una lista de clases (class, className, clsx, cn, cva…), agrega la llave ts y nunca escribe tu config ni tu CSS: lo que hay que decidir ahí lo sugiere en el reporte. Sólo vale para Tailwind 4. Con Tailwind 3, primero se pasa a la 4 con la herramienta oficial de Tailwind: los mismos nombres valen otra cosa y la herramienta se niega a correr.

Así se ve el reporte sobre un proyecto de prueba, recortado a lo representativo:

Salida

Qué no se convierte y qué hacer

Qué queda sin convertir Qué hacer
Un elemento con una clase que choca (table, o tu propia card)Queda entero sin tocar, sin la llave ts: se renombra la clase propia o se escribe ese CSS en una hoja propia, y el resto del elemento se convierte a mano.
Un color de una familia que no está en tu tema (bg-blue-500)Se suma la semilla de esa familia en colors de la config y se vuelve a correr.
white, black, current, inheritNo son colores del tema: va bg-background-100, un gris de la escala (color-gray-1000) o el color del tema.
Un corte de pantalla fuera de la lista (2xl:)Se agrega con extend.screens en la config y se vuelve a correr.
Un valor arbitrario (w-[300px], data-[open]:)El vocabulario es cerrado: un token en el config o una utilidad propia en utilities.
@apply en tu CSSNo se reescribe. El reporte da la traducción; si es un solo selector, la utilidad propia en utilities que lo reemplaza.
dark:No existe: el modo oscuro sale del tema, no de una clase por elemento.
ring sin número, border de un solo lado, ! (important), first:No tienen equivalente directo; el reporte dice cuál es la salida de cada una.
Clases armadas en runtime, classList, tailwind-mergeNo se pueden traducir solas: se escribe la clase entera o se arma con un mapa de clases completas.

Los choques se resuelven primero: un elemento con uno queda sin tocar hasta que se resuelva. Después las clases «convertidas con otro valor»: el color y la sombra de TaishoDS no son los de Tailwind, cada una se revisa a ojo. La herramienta convierte una directiva class:p-4 de Svelte, pero la llave no puede ir en una directiva: si el elemento no tiene class, se le agrega un class="ts". Una segunda pasada con --write no vuelve a convertir lo que ya tiene la llave.

Con un asistente de IA

El servidor MCP que viene en el paquete (taisho mcp, explicado en Asistentes de IA) trae la herramienta translate_tailwind. Recibe marcado con clases de Tailwind y devuelve el marcado convertido, la lista de lo que convirtió (con una nota cuando el valor cambia) y lo que no pudo, con el motivo. Usa la misma tabla que taisho migrate, y conviene pasar el resultado por validate_markup. Los números no se traducen por nombre: p-4 son 16 px en Tailwind y 4 px en TaishoDS.

translate_tailwind