Si ya piensas en filas y columnas, sigue haciéndolo. tw-bootstrap-grid añade a Tailwind el conocido grid de 12 columnas, con .row, .col-6, .offset-2 y .g-4, con soporte para RTL y sin imponer cómo deben verse tus componentes.
.row, .col, .col-auto y de .col-1 a .col-12, igual que en Bootstrap.
Gutters de tu tema
.g-*, .gx-* y .gy-* usan la escala de espaciado de Tailwind, así que encajan con el resto de tu diseño.
Offsets
De .offset-0 a .offset-12 para centrar una columna o dejar un hueco.
Columnas por fila
De .row-cols-1 a .row-cols-6 y .row-cols-auto dimensionan a todos los hijos con una sola clase en la fila.
Contenedores
.container y .container-fluid con un relleno que tiene en cuenta el gutter. Los anchos máximos vienen de los breakpoints de Tailwind.
Responsive y RTL
Todas las clases admiten los prefijos de breakpoint de Tailwind, como md:col-6, y se invierten correctamente con dir="rtl".
Solo se ocupa del layout: sin colores, sin componentes, sin resets. Añade a Tailwind en lugar de sustituir nada, así que puedes mezclar col-4 y flex en la misma página sin pensarlo dos veces.
Primeros pasos
Instalación
Tres pasos: instala el paquete, registra el plugin y empieza a usar las clases.
1Instala el paquete
npm install tw-bootstrap-grid
2Registra el plugin
Elige tu versión de Tailwind en la cabecera y el fragmento de abajo se adapta. Tailwind v4 registra los plugins en el CSS, v3 en el archivo de configuración.
El plugin se ejecuta dentro del compilador de Tailwind (PostCSS, Vite, Webpack, la CLI de Tailwind…). No funciona con el script Play CDN de Tailwind, que no puede cargar plugins desde npm.
Primeros pasos
Configuración
Los valores por defecto coinciden con Bootstrap, así que puedes saltarte esta página. Vuelve cuando quieras otros breakpoints o tamaños de gutter.
Breakpoints
El plugin no tiene breakpoints propios. Los prefijos como md:col-6 y el ancho máximo de .container vienen de Tailwind, así que al cambiar tus pantallas cambia también el grid.
Los gutters son el espacio entre columnas. Por defecto son 1.5rem en horizontal y 0 en vertical. Puedes definirlo una vez para todo, o por separado para contenedores y filas. En v3 pasas opciones al plugin, en v4 defines variables CSS.
Tailwind v4
main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";
:root {
/* used by containers and rows */
--bs-global-gutter-x: 1.5rem;
--bs-global-gutter-y: 0;
/* overrides for one of them only */
--bs-container-gutter-x: 1rem;
--bs-row-gutter-x: 2rem;
--bs-row-gutter-y: 1rem;
}
Orden de resolución del gutter
Prioridad
Variable CSS
Opción
Notas
1
--bs-row-gutter-x / --bs-container-gutter-x
rowGutters / containerGutters
Gana el valor más específico.
2
--bs-global-gutter-x
gutters
Valor de respaldo compartido por ambos.
3
1.5rem (x) y 0 (y)
valor por defecto integrado
Los mismos valores por defecto que usa Bootstrap.
Las variables CSS se leen en tiempo de ejecución, así que en cualquiera de las dos versiones también puedes redefinirlas en cualquier elemento para cambiar los gutters solo de esa sección. Para una sola fila, usa .g-*, .gx-* y .gy-*.
Desactiva los contenedores
¿Prefieres usar solo el container de Tailwind? Pon generateContainers en false y el plugin deja de generar .container-fluid y su relleno que tiene en cuenta el gutter. Las filas y las columnas no se ven afectadas.
Tailwind v4 puede pasar a un plugin valores simples como generateContainers: false;, pero no objetos anidados como gutters. Las variables CSS cubren ese caso y además se pueden redefinir por elemento.
Referencia
Clases
Todo lo que añade el plugin, en un solo lugar.
Layout
Clases de Layout
Clase
Qué hace
Notas
.container
width: 100%; centrado; relleno según el gutter
El ancho máximo viene de los breakpoints de Tailwind.
Se define en la .row y se aplica a todos los hijos.
.row-cols-auto
los hijos reciben width: auto
Los hijos se dimensionan según su contenido.
Gutters
Clases de Gutters
Clase
Qué hace
Notas
.g-*
--bs-gutter-x y --bs-gutter-y
Ambas direcciones.
.gx-*
--bs-gutter-x
Solo horizontal.
.gy-*
--bs-gutter-y
Solo vertical.
Todo es responsive
Añade un prefijo de breakpoint a cualquiera de las clases anteriores: md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.
¿Qué pasos de gutter existen?
.g-*, .gx-* y .gy-* se generan a partir de tu tema de espaciado. En v3 es cada clave de theme.spacing sin punto (así que g-4 sí, g-0.5 no). En v4 es la escala por defecto, de g-0 a g-96 y g-px.
La alineación y el orden vienen de Tailwind
El plugin no incluye sus propios justify-*, items-* ni order-*. Una .row es un contenedor flex normal, así que las utilidades de Tailwind funcionan directamente sobre ella.
Si vienes de Bootstrap
Migrar desde Bootstrap
El grid funciona como lo recuerdas. Tres cosas se ven distintas: cómo se escriben las clases responsive, los números de espaciado y los anchos de los breakpoints.
Lo que no cambia
La estructura: .container, .row, .col-*, .offset-*, .row-cols-*. Incluso las variables CSS mantienen su nombre, --bs-gutter-x y --bs-gutter-y, así que el CSS propio que las lee sigue funcionando.
Prefijo, no infijo
Bootstrap escribe col-md-6. Tailwind escribe md:col-6. Es el cambio que más vas a tocar, y un script puede hacerlo por ti.
Números distintos
Los números de gutter y de espaciado siguen la escala de Tailwind, así que el g-3 de Bootstrap es g-4 aquí. Los anchos de los breakpoints también difieren un poco.
La guía completa incluye las tablas de equivalencias, los cambios de tamaño de gutter, cómo igualar los breakpoints de Bootstrap y un comando que convierte tu código.
Todos los ejemplos son interactivos. Edita el HTML de la izquierda y la vista previa se actualiza mientras escribes. Si conoces el grid de Bootstrap (se abre en una pestaña nueva), te resultará familiar.
Un layout básico
Un .container centra tu contenido, una .row coloca las columnas una junto a otra y cada .col-* ocupa esa cantidad de las 12 partes disponibles. Dos columnas col-6 dividen la fila por la mitad.
Vista previa
HTML editable
Las columnas siempre saltan de línea. Lo que pase de 12 partes en una fila baja a la línea siguiente, algo muy útil para listas de tarjetas.
Columnas iguales y de ancho automático
Un .col sin más reparte el espacio que quede, así que tres de ellas son tres columnas iguales. .col-auto se dimensiona según su contenido y el .col vecino ocupa el resto.
Vista previa
HTML editable
Columnas responsive
Todas las clases admiten los prefijos de breakpoint de Tailwind. Empieza pensando en móvil con col-12 y cambia el ancho en pantallas mayores con sm:, md:, lg: y los demás. Usa los botones de ancho sobre la vista previa para ver cada breakpoint en acción.
Vista previa
768px · md · 0%
HTML editable
La vista previa es un viewport real. Muestra el ancho y el breakpoint en la esquina, y los botones de móvil, tableta y escritorio lo cambian, así que md: y lg: se aplican igual que en esa pantalla.
Gutters
Los gutters son los huecos entre columnas. .g-* define ambas direcciones, .gx-* solo la horizontal y .gy-* solo la vertical. Los números vienen de la escala de espaciado de Tailwind, así que g-4 es el mismo paso que p-4.
Vista previa
HTML editable
Pon las clases de gutter en la .row. Usa g-0 para quitar los huecos por completo.
Offsets
.offset-* desplaza una columna esa cantidad de partes. Es la forma rápida de centrar una columna o dejar un hueco. Los offsets también admiten prefijos de breakpoint, como lg:offset-3.
Vista previa
HTML editable
Los offsets usan margin-inline-start, así que empujan desde el lado correcto cuando la página va de derecha a izquierda. Prueba el botón RTL sobre la vista previa.
Columnas por fila
Cuando todas las columnas tienen el mismo tamaño, defínelo una vez en la fila en lugar de en cada hijo. .row-cols-1 a .row-cols-6 dan a cada hijo una parte igual, y .row-cols-auto los dimensiona según su contenido.
Vista previa
HTML editable
Combínalo con breakpoints para cambiar el número de columnas a medida que crece la pantalla, por ejemplo row-cols-2 lg:row-cols-3.
Anidamiento
Una columna puede contener su propia .row. La fila anidada empieza un grid nuevo de 12 partes dentro de la columna, así que puedes dividir un espacio tantas veces como necesites.
Vista previa
HTML editable
Alineación y orden
Una .row es un contenedor flex normal, así que las utilidades de flexbox de Tailwind funcionan sobre ella: items-*, justify-*, self-* y order-*. El plugin no las redefine.
Vista previa
HTML editable
Los cambios del estilo order-2 md:order-1 son un patrón habitual: apila en un orden en móvil y inviértelo en pantallas mayores.
De derecha a izquierda
Pon dir="rtl" en el contenedor, o en <html> para toda la página, y el grid fluye desde la derecha. Es la opción para árabe, persa, hebreo y otros idiomas RTL.
Vista previa
HTML editable
No hay nada que configurar. Los gutters de la fila son simétricos y los offsets usan propiedades lógicas, así que se invierten solos.
Conviene saber
De derecha a izquierda
Añade dir="rtl" y el grid se refleja solo. No hay nada que configurar.
Para toda la página
index.html
<html dir="rtl">
...
</html>
Para una sola sección
index.html
<div class="container" dir="rtl">
<div class="row">
<div class="col-6 offset-3">Starts from the right</div>
</div>
</div>
Por qué funciona sin más
Los offsets usan margin-inline-start, y los márgenes negativos de la fila y el relleno de las columnas son simétricos, así que se invierten solos. Usa el botón RTL en cualquier ejemplo de arriba para verlo.
Conviene saber
Preguntas frecuentes
Respuestas a las preguntas que más se repiten.
No. El container de Tailwind sigue aportando los anchos máximos por breakpoint. El plugin añade encima el centrado y un relleno que tiene en cuenta el gutter. Si prefieres no tenerlo, pon generateContainers en false.
Sí, esa es la idea. Una .row es un contenedor flex, así que items-center, justify-between, order-2, mt-4 y el resto se aplican a ella y a sus columnas como siempre.
Tailwind solo genera CSS para las clases que encuentra en tus archivos fuente. En tu propio proyecto eso es automático. En esta página los ejemplos editables pueden contener cualquier cosa, así que la demo genera de antemano todas las clases y breakpoints del plugin.
No. El script del CDN no puede cargar plugins desde npm. Usa una configuración de compilación como Vite, PostCSS, Webpack o la CLI de Tailwind.
Tailwind v3.4 y v4, con Node 18 o superior. El paquete incluye compilaciones ESM y CommonJS con tipos de TypeScript.
Los nombres de las clases son parecidos: col-md-6 pasa a ser md:col-6 y los números de gutter siguen la escala de Tailwind. La guía de migración tiene la equivalencia completa y un comando que convierte tu código.