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-4 | 16 px | 4 px | p-16 |
| px-6 | 24 px | 6 px | px-24 |
| gap-4 | 16 px | 4 px | gap-16 |
| mt-8 | 32 px | 8 px | mt-32 |
| w-64 | 256 px | 64 px | w-256 |
| h-12 | 48 px | 12 px | h-48 |
| size-8 | 32 px | 8 px | size-32 |
| w-96 | 384 px | 96 px | ninguno (la escala llega a 256) |
| blur-sm | 8 px | 4 px | blur-md |
| leading-10 | 40 px de interlineado | el 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-64 | 16rem = 256px | w-256 |
| w-16 | 4rem = 64px | w-64 |
| p-4 | 1rem = 16px | p-16 |
| mt-2 | 0.5rem = 8px | mt-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
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.
// taisho.config.ts: la salida para lo que no está en la escala
import type { TaishoConfig } from '@taishods/core/generate';
const config: TaishoConfig = {
// …
utilities: { 'card-hero': ['p-double', 'radius-lg'] }, // una utilidad propia, compuesta de las existentes
};
export default config;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-4xl | 32px no está en la escala de radios |
| text-3xl | 30px no está en la escala de texto (10, 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 60, 72) |
| text-8xl | 96px no está en la escala de texto (10, 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 60, 72) |
| text-9xl | 128px no está en la escala de texto (10, 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 60, 72) |
| leading-3 | interlineado de 12px no está en la escala |
| leading-snug, leading-normal, leading-relaxed, leading-loose | interlineado sin unidad: sólo existen `none` y `tight` |
| opacity-5 | opacidad 5 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-10 | opacidad 10 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-15 | opacidad 15 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-20 | opacidad 20 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-25 | opacidad 25 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-35 | opacidad 35 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-45 | opacidad 45 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-55 | opacidad 55 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-65 | opacidad 65 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-85 | opacidad 85 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| opacity-95 | opacidad 95 no está en la escala (0, 30, 40, 50, 60, 70, 75, 80, 90, 100) |
| duration-75 | 75ms no está en la escala de duraciones |
| duration-700 | 700ms no está en la escala de duraciones |
| duration-1000 | 1000ms no está en la escala de duraciones |
| ease-out, ease-in-out | esa curva de easing no está en la escala |
| blur-md, backdrop-blur-md | blur de 12px no está en la escala |
| blur-xl, backdrop-blur-xl | blur de 24px no está en la escala |
| blur-2xl, backdrop-blur-2xl | blur de 40px no está en la escala |
| blur-3xl, backdrop-blur-3xl | blur de 64px no está en la escala |
| shadow-2xs, shadow-xs, shadow-2xl | esa sombra no existe en la escala de TaishoDS (sm, md, lg, xl) |
| static, line-clamp-5, line-clamp-6 | la 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-hidden | el 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-0 | no 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>` |
| transition | no 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-inset | el 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-hidden | no hay `outline-hidden`: para quitar el contorno, `outline-none` |
| mt-auto, mb-auto | só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):
<div class="flex items-center gap-3 p-4 ml-4 w-64 rounded-lg shadow-md md:hidden">
<span class="text-sm font-semibold text-left">Equipo</span>
</div><div class="ts flex items-center gap-12 p-16 ms-16 w-256 radius-lg shadow-md md:hidden">
<span class="ts text-14 weight-semibold align-start">Equipo</span>
</div>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).
<link rel="stylesheet" href="/tailwind.css" />
<link rel="stylesheet" href="/taisho.css" /> <!-- después de Tailwind -->- 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.
npx taisho migrate --from tailwind # reporta, no escribe
npx taisho migrate --from tailwind --write # aplicaConvierte 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:
taisho migrate --from tailwind (dry-run: no se escribió nada; con --write se aplica)
Tailwind 4.3.3 (node_modules); el mapa vale para 4.x.
Config: taisho.config.ts.
Conviene hacer commit antes de --write: el comando reescribe tus archivos.
Por convertir (5 archivos):
src/components/Boton.jsx 10 convertida(s), 5 llave(s) `ts`
src/components/Card.svelte 15 convertida(s), 6 llave(s) `ts`
src/index.html 33 convertida(s), 12 llave(s) `ts`
…
CHOQUES (1): nombres de Tailwind que en TaishoDS son otra cosa; el elemento que los lleva no se tocó (se renombra la clase propia o se escribe ese CSS en una hoja propia, y el resto se convierte a mano):
src/index.html:16 table [choque] `table` de Tailwind no es lo que `table` es en TaishoDS (un componente): el elemento no se tocó; …
Convertidas con otro valor (18 pares): la misma intención, no el mismo píxel o color; se revisa cada una:
shadow-lg → shadow-lg ×1 misma intención, otra sombra: la de TaishoDS incluye el anillo de 1px del material
src/components/Modal.vue:7
text-2xl → text-24 ×1 fluido: crece con el viewport hasta 24px. …
src/index.html:5
…
Sin convertir al 100 % (29): quedan como están, se resuelven a mano:
src/components/Card.svelte:4 bg-blue-500 [base] la familia `blue` no está en tu tema: se suma una semilla `blue` en `colors` y se vuelve a correr
src/components/Lista.tsx:10 2xl:hidden [variante] el corte `2xl:` no está en las pantallas del Core; se agrega con extend.screens
src/index.html:13 dark:bg-gray-900 [variante] `dark:` no existe: el oscuro sale del tema (`light-dark()`, `createTheme`), no de una clase por elemento
src/index.html:17 w-[300px] [base] `w-[300px]` lleva un valor arbitrario: el vocabulario es cerrado; …
…
Fuera de las clases (11): no se tocan, son de tu configuración, tu CSS o tu JS:
src/estilos.css:9 @apply rounded-lg bg-blue-500 px-4 py-2 text-white [apply] `@apply` no se reescribe. Traducción: `radius-lg bg-blue-500 px-16 py-8 text-white`; …
…
Resumen: 6 archivos revisados, 5 a modificar; 87 clase(s) a TaishoDS (22 con otro valor), 33 llave(s) `ts`, 1 choque(s), 29 sin convertir, 11 fuera de las clases, 1 ajena(s).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, inherit | No 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 CSS | No 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-merge | No 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 { "markup": "<div class=\"flex gap-2 p-4 bg-blue-500\">Hola</div>" }
← {
"output": "<div class=\"ts flex gap-8 p-16 bg-blue-500\">Hola</div>",
"converted": [
{ "line": 1, "from": "flex", "to": "flex", "exact": true },
{ "line": 1, "from": "gap-2", "to": "gap-8", "exact": true },
{ "line": 1, "from": "p-4", "to": "p-16", "exact": true }
],
"notConverted": [
{ "line": 1, "token": "bg-blue-500", "type": "base",
"reason": "la familia `blue` no está en tu tema: se suma una semilla `blue` en `colors` y se vuelve a correr" }
]
}