Primeros pasos
Instalación vía CDN
El script CDN es la forma más rápida de prototipar con Tailwind. Genera las utilidades en runtime escaneando tu marcado. Para producción, prefiere la build con PostCSS o CLI para purgar las clases sin usar y publicar un bundle CSS diminuto.
<!-- Quick start: drop this in <head> -->
<script src="https://cdn.tailwindcss.com"></script>
<!-- Tailwind scans class names in your HTML and generates styles on the fly -->
<h1 class="text-3xl font-bold text-blue-600">Hello Tailwind</h1>Configuración del proyecto (CLI)
El array content es crítico — Tailwind solo genera las clases que encuentra en esos archivos (tree-shaking). Olvidar una ruta es la causa número 1 de los bugs de 'falta mi clase'. Usa --watch durante el desarrollo.
# Install Tailwind as a project dependency
npm install -D tailwindcss
npx tailwindcss init
# tailwind.config.js — tell Tailwind where your templates live
/** @type {import('tailwindcss').Config} */
module.exports = {
content: ["./src/**/*.{html,js,jsx,ts,tsx}"],
theme: { extend: {} },
plugins: [],
};
# Build CSS
npx tailwindcss -i ./src/input.css -o ./dist/output.css --watchDirectivas del CSS de entrada
Las directivas @tailwind inyectan las tres capas de Tailwind en orden: base (resets), components, utilities. @layer te deja añadir tu propio CSS a la capa de cascada correcta. @apply incrusta estilos de utilidades en una regla personalizada.
/* src/input.css — the three layers Tailwind uses */
@tailwind base; /* normalize/reset + base element styles */
@tailwind components; /* component classes you register */
@tailwind utilities; /* the utility classes themselves */
/* Add custom CSS after the directives */
@layer base {
h1 { @apply text-2xl; }
}Modelo mental utility-first
La filosofía de Tailwind: construir interfaces componiendo clases de utilidad pequeñas y de un solo propósito en lugar de inventar nombres de clases semánticos. Esto mantiene el CSS plano, evita el código muerto y hace los diseños consistentes mediante una escala compartida de espaciado/color.
<!-- Instead of naming custom classes, compose utilities -->
<button class="bg-blue-600 hover:bg-blue-700 text-white
font-medium py-2 px-4 rounded-lg shadow
transition-colors duration-200">
Save
</button>
<!-- Equivalent to writing CSS: .btn { background, padding, radius... } -->
<!-- But each utility maps to a single, predictable declaration. -->Configuración y extensión del tema
Usa theme.extend para añadir a los valores por defecto de Tailwind sin reemplazarlos. Definir una clave en el nivel superior de theme (no en extend) reemplaza por completo esa escala. Los colores personalizados como brand-500 generan bg-brand-500, text-brand-500, border-brand-500, etc.
// tailwind.config.js
module.exports = {
content: ["./src/**/*.{html,tsx}"],
theme: {
extend: {
colors: {
brand: { 500: "#06B6D4", 600: "#0891B2" },
},
fontFamily: {
sans: ["Inter", "system-ui", "sans-serif"],
},
spacing: { 128: "32rem" },
},
},
plugins: [],
};Colores
Colores de texto, fondo y borde
Las utilidades de color siguen el patrón {propiedad}-{color}-{tono}. Los tonos van de 50 (el más claro) a 950 (el más oscuro). Propiedades comunes: text-, bg-, border-, ring-, fill-, stroke-, from-/to-/via- (degradados).
<p class="text-red-500">Red text</p>
<div class="bg-blue-100">Light blue background</div>
<span class="border border-gray-300">Gray border</span>
<button class="bg-emerald-500 hover:bg-emerald-600">Emerald</button>Modificadores de opacidad
Añade /{opacidad} a cualquier utilidad de color para fijar su canal alfa. Usa color-mix o rgba por debajo y funciona para text, bg, border, ring, etc. Es la forma más limpia de teñir sin definir nuevas entradas de paleta.
<div class="bg-black/50">50% black overlay</div>
<p class="text-blue-600/75">75% opacity blue text</p>
<div class="border-gray-900/10">10% gray border</div>
<button class="bg-indigo-500 hover:bg-indigo-500/90">Slight fade</button>Degradados
Usa bg-gradient-to-{dirección} con las paradas de color from-, via- y to-. Las direcciones incluyen t (arriba), b, l, r, tr, tl, br, bl. Para degradados radial/conic (v3.3+) usa bg-gradient-radial (exige plugin o valor arbitrario).
<div class="bg-gradient-to-r from-purple-500 to-pink-500">
Left to right gradient
</div>
<div class="bg-gradient-to-tr from-yellow-400 via-red-500 to-pink-600">
Three-stop diagonal gradient
</div>
<div class="bg-gradient-to-b from-sky-400 to-sky-900">Vertical</div>Colores personalizados y arbitrarios
Los valores arbitrarios entre corchetes te permiten usar cualquier color de CSS sin editar la configuración — genial para casos puntuales. Para colores usados repetidamente, defínelos en theme.extend.colors para que obtengan soporte de modificador de opacidad y nombrado consistente.
<!-- Arbitrary hex/rgb value -->
<div class="bg-[#1da1f2]">Twitter blue</div>
<p class="text-[rgb(255,0,0)]">Red</p>
<!-- Custom color from your theme -->
<button class="bg-brand-600">My brand color</button>
<!-- Current color / transparent -->
<div class="bg-transparent border border-current">Transparent</div>Visión general de la paleta
La paleta de Tailwind reemplaza el 'gray' genérico con cuatro familias neutras: slate (azul frío), gray, zinc, neutral y stone (cálido). Elige una para tu proyecto entero para unos neutros consistentes. Cada color tiene 11 tonos (50, 100, ..., 950).
<!-- Tailwind ships 22 color families, each 50-950 -->
<!-- slate gray zinc neutral stone red orange amber yellow -->
<!-- lime green emerald teal cyan sky blue indigo violet -->
<!-- purple fuchsia pink rose -->
<p class="text-slate-900">Primary text</p>
<p class="text-slate-500">Secondary text</p>
<p class="text-slate-400">Muted text</p>
<!-- Use slate/zinc/neutral/stone instead of plain gray -->
<!-- They have subtler blue/warm tones than old gray-*. -->Tipografía
Tamaño y peso de fuente
text-{tamaño} se mapea a una escala basada en rem (text-base = 1rem). font-{peso} cubre 100-900. Los valores arbitrarios como text-[42px] también funcionan. El interlineado escala automáticamente con el tamaño de texto salvo que lo sobrescribas con leading-*.
<p class="text-xs">12px</p>
<p class="text-sm">14px</p>
<p class="text-base">16px (default)</p>
<p class="text-lg">18px</p>
<p class="text-2xl">24px</p>
<p class="text-7xl">72px</p>
<p class="font-thin">100</p>
<p class="font-normal">400</p>
<p class="font-medium">500</p>
<p class="font-semibold">600</p>
<p class="font-bold">700</p>
<p class="font-black">900</p>Interlineado y espaciado de letras
leading-* fija line-height (numérico = rem, con nombre = relativo). tracking-* fija letter-spacing. Emparéja uppercase + tracking-wider + text-xs para etiquetas y antetítulos estilo versalitas — un modismo de Tailwind muy común.
<p class="leading-none">Line height 1</p>
<p class="leading-tight">1.25</p>
<p class="leading-normal">1.5 (default)</p>
<p class="leading-loose">2</p>
<p class="leading-6">1.5rem fixed</p>
<p class="tracking-tight">-0.025em</p>
<p class="tracking-normal">0</p>
<p class="tracking-wide">0.025em</p>
<p class="tracking-widest">0.1em</p>
<!-- Uppercase + tracking for labels -->
<span class="uppercase tracking-wider text-xs font-bold">Label</span>Alineación y decoración del texto
text-{left,center,right,justify} alinea el contenido en línea. underline/line-through/no-underline alternan text-decoration; decoration-{1-4} fija el grosor, underline-offset-{n} lo posiciona. El patrón hover:underline es el estándar para los enlaces de navegación.
<p class="text-left">Left</p>
<p class="text-center">Center</p>
<p class="text-right">Right</p>
<p class="text-justify">Justified long paragraph...</p>
<a class="underline">Underlined</a>
<a class="line-through">Strikethrough</a>
<a class="no-underline hover:underline">Hover underline</a>
<a class="decoration-2 underline-offset-4">Thicker underline, offset</a>Familias de fuentes y fuentes arbitrarias
Tres stacks de fuente vienen por defecto: sans (UI del sistema), serif, mono. Añade más en theme.extend.fontFamily (por ejemplo, display, body). Para fuentes arbitrarias puntuales usa font-['Nombre']. Recuerda hacer @import o <link> de la fuente web real en tu CSS/HTML.
<p class="font-sans">Default sans-serif stack</p>
<p class="font-serif">Serif stack</p>
<p class="font-mono">Monospace</p>
<!-- Arbitrary font family -->
<p class="font-['Georgia']">Georgia</p>
<!-- After configuring theme.extend.fontFamily -->
<p class="font-display">Custom display font</p>Desbordamiento y truncamiento de texto
truncate = overflow-hidden text-ellipsis whitespace-nowrap (una línea + elipsis). line-clamp-{1-6} acota a N líneas (usa -webkit-line-clamp). Para el ajuste de flujo libre usa break-words o break-all para controlar la rotura de palabras largas.
<!-- Single-line ellipsis -->
<p class="truncate w-64">
Very long text that will be cut off with an ellipsis at the end...
</p>
<!-- Clip without ellipsis -->
<p class="overflow-clip w-32">Long text clipped</p>
<!-- Multi-line clamp (2 lines) -->
<p class="line-clamp-2">
Multi-line paragraph that gets clamped after two lines
with an ellipsis, useful for card previews and previews.
</p>Espaciado
Padding y margen
Las utilidades de espaciado usan una única escala basada en 4px: 1 = 0.25rem = 4px. p* / m* para la totalidad de los lados, px/py para los pares de eje, pt/pr/pb/pl o mt/mr/mb/ml por lado. mx-auto centra horizontalmente los elementos de bloque.
<!-- p-* = padding, m-* = margin -->
<div class="p-4">16px all sides</div>
<div class="px-4 py-2">16px horizontal, 8px vertical</div>
<div class="pt-2 pr-4 pb-2 pl-4">Per side (top/right/bottom/left)</div>
<div class="m-8">32px margin all sides</div>
<div class="mx-auto">Center a block (auto L/R margin)</div>
<div class="mt-0 mb-4">No top margin, 16px bottom</div>La escala de espaciado
Una única escala gobierna el padding, el margen, el gap, el width, el height y más — esta consistencia es el superpoder de Tailwind. Usa valores negativos (-mt-2) para solapes y tirones. Los valores arbitrarios p-[13px] escapan a la escala cuando hacen falta pero deberían ser raros.
<!-- The default scale (in px) -->
0 = 0px 1 = 4px 2 = 8px 3 = 12px 4 = 16px
5 = 20px 6 = 24px 8 = 32px 10 = 40px 12 = 48px
16 = 64px 20 = 80px 24 = 96px 32 = 128px 48 = 192px
<!-- Negative margins -->
<div class="-mt-4">Pulls up by 16px</div>
<div class="-ml-2">Pulls left by 8px</div>
<!-- Arbitrary values -->
<div class="p-[13px] mt-[7px]">Custom sizes</div>Espacio entre hijos
space-x-* / space-y-* añade margen entre hermanos (no alrededor) — perfecto para pilas verticales y filas de badges. Ojo: space-x usa margin-left, así que no combina bien con flex justify; para flex prefiere la utilidad gap-* (ver Flexbox).
<div class="space-y-4">
<div>Item 1</div>
<div>Item 2</div>
<div>Item 3</div>
</div>
<!-- Adds 16px margin-top to every child except the first -->
<div class="space-x-2 flex">
<span>A</span><span>B</span><span>C</span>
</div>
<!-- Adds 8px margin-left to every child except the first -->Width y height
w-* / h-* usan la escala de espaciado más fracciones (1/2, 1/3, 2/3, 1/4...), screen/ full, y tamaños con nombre (xs..7xl para max-width). max-w-{tamaño} acota el ancho — envuelve el contenido de la página en max-w-md mx-auto para longitudes de línea legibles. w-fit / w-max usan el tamaño intrínseco.
<div class="w-16 h-16">64x64 box</div>
<div class="w-1/2 h-full">50% width, full height</div>
<div class="w-screen h-screen">Full viewport</div>
<div class="w-96">24rem fixed</div>
<div class="max-w-md mx-auto">Capped width, centered</div>
<div class="min-h-screen">At least full viewport tall</div>
<!-- Modern: fit-content, intrinsic sizing -->
<div class="w-fit">Shrinks to content</div>Gap para flex y grid
gap-* es la forma moderna de espaciar los hijos de flex/grid — reemplaza al antiguo enfoque de márgenes space-x/space-y. Fja gap para ambos ejes, o gap-x/gap-y individualmente. Usa la misma escala de espaciado que padding/margin.
<div class="flex gap-4">
<div>A</div><div>B</div><div>C</div>
</div>
<!-- 16px between flex children, no margin hacks needed -->
<div class="grid grid-cols-3 gap-2 gap-y-4">
<div>1</div><div>2</div><div>3</div>
<div>4</div><div>5</div><div>6</div>
</div>
<!-- gap = both axes; gap-x / gap-y for per-axis -->Flexbox
Contenedor flex básico
flex fija display:flex; inline-flex fija display:inline-flex. flex-col cambia el eje principal a vertical — combinado con gap es la forma más limpia de construir pilas verticales. La dirección por defecto es row (horizontal).
<div class="flex">
<div>A</div><div>B</div><div>C</div>
</div>
<div class="inline-flex gap-2">
<span>Badge</span><span>Badge</span>
</div>
<!-- Vertical stack = flex-col (often cleaner than space-y) -->
<div class="flex flex-col gap-4">
<div>Row 1</div>
<div>Row 2</div>
</div>Justify y align
justify-* controla el eje principal (horizontal en flex-row); items-* el eje transversal (vertical en flex-row). La combinación 'flex justify-center items-center' centra el contenido en ambas direcciones — el fragmento de Tailwind más usado para centrar.
<div class="flex justify-start"> <!-- left --></div>
<div class="flex justify-center"> <!-- center --></div>
<div class="flex justify-between"> <!-- spread --></div>
<div class="flex justify-around"> <!-- equal space around --></div>
<div class="flex justify-end"> <!-- right --></div>
<!-- Cross axis (perpendicular to main) -->
<div class="flex items-center"> <!-- vertically center --></div>
<div class="flex items-start"> <!-- top align --></div>
<div class="flex items-end"> <!-- bottom align --></div>
<div class="flex items-stretch"> <!-- fill height --></div>Flex grow, shrink y basis
flex-1 = flex:1 1 0% (crece para llenar, puede encoger, base 0). flex-none = no crece ni encoge (fijo). flex-grow-0 / flex-shrink-0 desactivan el crecimiento/encogimiento individualmente. basis-{n} fija el tamaño inicial antes de crecer.
<div class="flex">
<div class="flex-1">Grows to fill</div>
<div class="flex-none">Never shrinks (fixed)</div>
<div class="flex-initial">Default size, can shrink</div>
</div>
<div class="flex">
<div class="flex-grow-0 w-20">Fixed 80px</div>
<div class="flex-grow basis-0">Takes remaining</div>
</div>
<!-- Responsive: sidebar collapses on mobile -->
<div class="flex flex-col md:flex-row">
<aside class="md:w-64 md:flex-shrink-0">Sidebar</aside>
<main class="flex-1">Main</main>
</div>Flex wrap y order
flex-wrap deja que los hijos fluyan a nuevas líneas (nowrap por defecto desborda). order-{n} reordena los hijos visualmente sin cambiar el DOM — order-first/last son atajos. Útil para layouts responsivos donde quieres distinto orden visual por breakpoint.
<div class="flex flex-wrap gap-4">
<div class="w-40">Card</div>
<div class="w-40">Card</div>
<div class="w-40">Card</div>
<!-- Cards wrap to next line instead of overflowing -->
</div>
<div class="flex flex-wrap-reverse">Wrap backwards</div>
<div class="flex flex-nowrap">No wrapping (default)</div>
<!-- Reorder children -->
<div class="flex">
<div class="order-last">First in DOM, last visually</div>
<div class="order-first">Last in DOM, first visually</div>
<div class="order-2">Custom order</div>
</div>Patrones de centrado
flex items-center justify-center es el fragmento de centrado canónico — funciona para cualquier tamaño de contenido. El patrón de footer pegajoso (min-h-screen + flex-col + flex-1 en main) empuja el footer abajo incluso con poco contenido.
<!-- Center anything both axes (classic) -->
<div class="flex items-center justify-center h-screen">
<div>Dead center</div>
</div>
<!-- Sticky footer pattern -->
<div class="flex flex-col min-h-screen">
<header>Header</header>
<main class="flex-1">Content grows</main>
<footer>Footer</footer>
</div>
<!-- Space between with centered item -->
<div class="flex items-center justify-between">
<button>Left</button>
<h1 class="absolute left-1/2 -translate-x-1/2">Centered title</h1>
<button>Right</button>
</div>Grid
Grid básico
grid fija display:grid. grid-cols-{n} define un conteo fijo de columnas (1-12). auto-rows-fr hace cada fila de igual altura (1fr cada una). gap-* funciona igual que en flex para espaciar pistas.
<div class="grid grid-cols-3 gap-4">
<div>1</div><div>2</div><div>3</div>
<div>4</div><div>5</div><div>6</div>
</div>
<!-- Auto rows set the row height -->
<div class="grid grid-cols-2 auto-rows-fr gap-2">
<div>Equal-height rows</div>
<div>Equal-height rows</div>
</div>
<!-- Inline grid -->
<span class="inline-grid grid-cols-2 gap-1">...</span>Columnas responsivas
El patrón auto-fit + minmax es un truco responsivo potente: las columnas miden al menos 200px y se estiran para llenar la fila, envolviéndose automáticamente — sin media queries. Combínalo con grid-cols-* responsivos explícitos para más control.
<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4">
<!-- 1 column on mobile, 2 on small, 3 on large, 4 on xl -->
</div>
<!-- Auto-fit / minmax for card grids that wrap naturally -->
<div class="grid grid-cols-[repeat(auto-fit,minmax(200px,1fr))] gap-4">
<div>Card</div><div>Card</div><div>Card</div>
</div>Spans de columna y fila
col-span-{n} / row-span-{n} hacen que un ítem cubra varias pistas. col-start-{n} / col-end-{n} colocan ítems en líneas de cuadrícula explícitas. Juntos habilitan layouts complejos estilo revista sin media queries.
<div class="grid grid-cols-3 grid-rows-3 gap-2">
<div class="col-span-2">Spans 2 cols</div>
<div>1 col</div>
<div class="row-span-2">Spans 2 rows</div>
<div class="col-span-2 row-span-2">Big tile</div>
<div>1 col</div>
<div>1 col</div>
</div>
<!-- Explicit placement -->
<div class="col-start-2 col-end-4 row-start-1">
Placed at column 2-4, row 1
</div>Grid template areas vía valores arbitrarios
Los valores arbitrarios entre corchetes te permiten especificar cualquier sintaxis de grid-template: grid-cols-[200px_1fr_100px] crea tres pistas de ancho personalizado (los guiones bajos se vuelven espacios). Los grid-template-areas con nombre no son una utilidad integrada — defínelos en una clase personalizada o usa el layout vía spans de col/fila.
<div class="grid grid-cols-[200px_1fr] grid-rows-[auto_1fr_auto] gap-4
min-h-screen">
<aside class="row-span-3">Sidebar</aside>
<header>Header</header>
<main>Main</main>
<footer>Footer</footer>
</div>
<!-- Named template areas need custom CSS or plugin: -->
<style>
.app { grid-template-areas: "h h" "s m" "f f"; }
</style>Gap y alineación
justify-items-* / content-* controlan cómo se sientan los ítems dentro de sus celdas y cómo se sientan las pistas dentro del contenedor. place-items-center es la abreviatura de justify-items + items-content (ambos ejes). place-content-center centra el bloque de cuadrícula entero.
<div class="grid grid-cols-3 gap-4 gap-x-8 gap-y-2">
<!-- 32px col gap, 8px row gap -->
</div>
<!-- Align whole grid tracks -->
<div class="grid grid-cols-2 justify-items-center">
<div>Each item centered in its cell</div>
</div>
<div class="grid grid-cols-2 content-center h-64">
<div>Vertically centers the rows</div>
</div>
<div class="grid grid-cols-2 place-items-center">
<!-- Both axes at once -->
</div>Bordes
Ancho y color de borde
border fija 1px en la totalidad de los lados; border-{2,4,8} fijan el grosor. border-{t,r,b,l,x,y} apuntan a lados concretos. border-dashed/dotted/double fijan el estilo. Emparéjalo siempre con border-{color} — el color de borde por defecto de Tailwind es gray-200 (cambió desde gray-300 en v3).
<div class="border">1px all sides</div>
<div class="border-2">2px</div>
<div class="border-4 border-red-500">4px red</div>
<div class="border-t border-b">Only top & bottom</div>
<div class="border-l-4 border-emerald-500">Left accent bar</div>
<div class="border-x border-gray-300">Left & right</div>
<div class="border border-dashed border-gray-400">Dashed</div>
<div class="border border-dotted">Dotted</div>
<div class="border border-double">Double</div>Border radius
rounded-{none,sm,md,lg,xl,2xl,3xl,full} escalan el radio; rounded-full hace píldoras o círculos perfectos (cuando width = height). Por esquina: rounded-{tl,tr,bl,br}-{tamaño}, por lado: rounded-{t,b,l,r}-{tamaño}. Los círculos de avatar usan rounded-full + w/h iguales.
<div class="rounded">0.25rem</div>
<div class="rounded-md">0.375rem</div>
<div class="rounded-lg">0.5rem</div>
<div class="rounded-xl">0.75rem</div>
<div class="rounded-2xl">1rem</div>
<div class="rounded-full">Fully rounded (pill/circle)</div>
<div class="rounded-t-lg rounded-b-none">Top only</div>
<div class="rounded-l-full">Left side pill</div>
<div class="rounded-tr-2xl rounded-bl-2xl">Per-corner</div>Dividir entre hijos
divide-{x,y} añade bordes entre hermanos — mucho más limpio que estilizar cada hijo con border-t. divide-{color} y divide-{ancho} los personalizan. Emparéjalo con py/px en los hijos para un espaciado cómodo en listas y tablas.
<ul class="divide-y divide-gray-200">
<li class="py-2">Item 1</li>
<li class="py-2">Item 2</li>
<li class="py-2">Item 3</li>
</ul>
<!-- Adds a 1px top border to each child except the first -->
<div class="flex divide-x divide-gray-300">
<div class="px-4">Col 1</div>
<div class="px-4">Col 2</div>
<div class="px-4">Col 3</div>
</div>Ring (similar al contorno)
Los rings son contornos basados en box-shadow que no afectan al layout (a diferencia de los bordes) y se solapan bien. ring-{n} fija el ancho, ring-{color} el color, ring-offset-{n} añade un espacio entre elemento y ring. El patrón focus:ring es el estilo de foco accesible estándar.
<button class="ring-2 ring-blue-500 ring-offset-2">
Ring with offset
</button>
<input class="ring-2 ring-red-500 focus:ring-2 focus:ring-blue-500" />
<button class="ring-1 ring-inset ring-gray-300">Inset ring</button>
<!-- Focus ring pattern (accessibility) -->
<button class="focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2">
Accessible focus
</button>Outline
outline-* usa la propiedad CSS outline real (fuera de la caja de borde, sin impacto en el layout). Ring es lo preferido en Tailwind porque es un box-shadow por capas — varios rings pueden apilarse y ring-offset da un hueco limpio. Outline es útil cuando necesitas explícitamente el comportamiento del outline de CSS.
<input class="outline-none" /> <!-- Remove default -->
<input class="outline outline-2 outline-blue-500" />
<input class="outline-dashed outline-1 outline-gray-400" />
<input class="focus:outline-none focus:ring-2 focus:ring-blue-500"
type="text" />
<!-- Outline vs ring: outline is drawn outside border-box,
ring is a box-shadow (can stack, has offset) -->Fondos
Color y attachment del fondo
bg-{color} fija background-color, con /{opacidad} para el alfa. bg-fixed crea un efecto parallax (el fondo se queda quieto mientras el contenido se desplaza). bg-clip-{padding,border,content} controla hasta dónde se extiende el fondo bajo bordes/contenido.
<div class="bg-blue-500">Solid color</div>
<div class="bg-blue-500/50">50% opacity</div>
<div class="bg-fixed">Parallax (fixed on scroll)</div>
<div class="bg-local">Scrolls with content</div>
<div class="bg-scroll">Default</div>
<!-- Clip: padding-box, border-box, content-box -->
<div class="bg-clip-padding border-4 border-dashed">Padding clip</div>
<div class="bg-clip-border">Border clip</div>Imagen de fondo y degradado
Usa bg-[url('/ruta/a/img.jpg')] para background-image con URLs arbitrarias (entrecomilla la URL). bg-cover llena el elemento conservando la relación de aspecto; bg-contain encaja toda la imagen. bg-{center,top,bottom,left,right} y bg-{repeat,no-repeat,repeat-x,repeat-y} controlan el posicionamiento.
<div class="bg-gradient-to-r from-cyan-500 to-blue-500">
Horizontal gradient
</div>
<!-- Image with arbitrary value -->
<div class="bg-[url('/hero.jpg')] bg-cover bg-center h-64">
Hero with cover image
</div>
<!-- Repeat & position -->
<div class="bg-repeat-x bg-[url('/pattern.png')]">Repeat horizontally</div>
<div class="bg-no-repeat bg-top">No repeat, top aligned</div>Dirección y paradas del degradado
from-/via-/to- fijan las paradas de color del degradado; bg-gradient-to-{dirección} fija el ángulo. Las direcciones diagonales como to-br son comunes para degradados cálidos de hero. Los degradados radial/conic nativos exigen un plugin o valor arbitrario: bg-[radial-gradient(...)].
<!-- Directions: to-t, to-b, to-l, to-r, to-tr, to-tl, to-br, to-bl -->
<div class="bg-gradient-to-br from-amber-400 to-orange-600">
Bottom-right diagonal
</div>
<!-- Three-stop gradient -->
<div class="bg-gradient-to-r from-green-400 via-teal-500 to-blue-600">
Multi-stop
</div>
<!-- Radial (Tailwind v3.3+) -->
<div class="bg-gradient-radial from-pink-400 to-purple-700">
Radial (may need plugin)
</div>Tamaño y posición del fondo
bg-cover frente a bg-contain es la elección clave para imágenes hero y logos respectivamente. Cover llena la caja (recorta el exceso); contain encaja toda la imagen (puede mostrar espacio vacío). Combina bg-cover + bg-center para la imagen hero responsiva estándar.
<div class="bg-cover bg-center h-48 bg-[url('/img.jpg')]">
Cover: fills container, may crop
</div>
<div class="bg-contain bg-center h-48 bg-no-repeat bg-[url('/logo.png')]">
Contain: fits entire image, may letterbox
</div>
<div class="bg-top-left bg-[url('/img.jpg')] bg-cover">Top-left anchor</div>
<div class="bg-[center_top]">Custom position</div>Modos de mezcla del fondo
bg-blend-{modo} controla cómo se componen varias capas de fondo (imagen + color). multiply, screen, overlay, darken, lighten son comunes. Para oscurecer imágenes por legibilidad del texto, el enfoque más limpio es un overlay de degradado semitransparente encima (ejemplo derecho).
<div class="bg-blend-multiply bg-[url('/photo.jpg')] bg-blue-500">
Multiplies image with blue overlay
</div>
<!-- Common overlay pattern: dark gradient over image -->
<div class="relative">
<img src="/hero.jpg" class="w-full" />
<div class="absolute inset-0 bg-gradient-to-t from-black/70 to-transparent">
Overlay
</div>
</div>Sombras
Escala de box shadow
La escala de sombras (sm, por defecto, md, lg, xl, 2xl) da una elevación consistente en tu app. shadow-inner crea una sombra interna útil para huecos y estados pulsados. Las tarjetas típicamente usan shadow-md con hover:shadow-lg para un efecto de elevación.
<div class="shadow-sm">Subtle</div>
<div class="shadow">Default</div>
<div class="shadow-md">Medium</div>
<div class="shadow-lg">Large</div>
<div class="shadow-xl">Extra large</div>
<div class="shadow-2xl">Huge</div>
<div class="shadow-none">No shadow</div>
<!-- Inner shadow -->
<div class="shadow-inner">Pressed-in look</div>Sombras de color
shadow-{color} tiñe la box shadow con un color (usa la misma paleta de colores). Combinado con /{opacidad} crea efectos de brillo. Las sombras de color son una forma rápida de hacer botones y acentos más vibrantes y con marca.
<div class="shadow-lg shadow-blue-500/50">
Blue tinted shadow
</div>
<div class="shadow-xl shadow-cyan-500/30">
Cyan glow effect
</div>
<div class="shadow-md shadow-black/30">Darker default</div>
<button class="bg-emerald-500 shadow-lg shadow-emerald-500/50">
Colored button shadow
</button>Patrón de elevación al hover
hover:shadow-{mayor} combinado con transition-shadow es el patrón estándar de hover de tarjeta. Emparéjalo con hover:-translate-y-0.5 y active:translate-y-0 para dar a un botón una retroalimentación física de pulsación — un pulido de interacción pequeño pero satisfactorio.
<div class="bg-white rounded-xl shadow-md hover:shadow-xl
transition-shadow duration-300 p-6 cursor-pointer">
Card with hover lift
</div>
<!-- Combined with slight translate for tactile feel -->
<button class="shadow-md hover:shadow-sm active:shadow-sm
hover:-translate-y-0.5 active:translate-y-0
transition-all">
Tactile button
</button>Drop shadow (para SVG/texto)
drop-shadow usa el filter:drop-shadow() de CSS que sigue la forma real del elemento (genial para SVG y PNG con transparencia), a diferencia de box-shadow que solo sombrea la caja. drop-shadow-md sobre texto es una alternativa más suave a text-shadow.
<h1 class="drop-shadow-md">Text with shadow</h1>
<svg class="drop-shadow-lg">
<!-- SVG shape gets shadowed as a whole -->
</svg>
<!-- Combine with rotate for dramatic effects -->
<div class="rotate-3 drop-shadow-2xl">Tilted card</div>
<!-- Filter utilities affect the element as a whole image -->
<div class="blur-sm brightness-110">Image filters</div>Sombras arbitrarias y por capas
Para sombras fuera de la escala por defecto, usa la sintaxis de valor arbitrario shadow-[...]. Para sombras complejas por capas (las que parecen verdaderamente premium), es más limpio definirlas una vez en una clase CSS personalizada — las sombras de una sola capa de Tailwind no pueden igualar la profundidad multicapa.
<div class="shadow-[0_8px_30px_rgb(0,0,0,0.12)]">
Custom shadow via arbitrary value
</div>
<!-- Multiple layered shadows via custom CSS -->
<style>
.card-shadow {
box-shadow:
0 1px 2px rgba(0,0,0,0.04),
0 4px 8px rgba(0,0,0,0.06),
0 12px 24px rgba(0,0,0,0.08);
}
</style>
<div class="card-shadow">Layered elevation</div>Diseño responsivo
Breakpoints
Tailwind es mobile-first: los estilos base aplican en todas partes, los prefijos de breakpoint aplican en min-width. El orden importa — escribe las clases de menor a mayor (text-sm md:text-base lg:text-lg). Los breakpoints coinciden con anchos de dispositivo comunes y son configurables.
<!-- Default = mobile first, then min-width overrides -->
<!-- sm: 640px, md: 768px, lg: 1024px, xl: 1280px, 2xl: 1536px -->
<div class="text-sm md:text-base lg:text-lg">
Grows with viewport
</div>
<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4">
Responsive grid
</div>
<!-- Hide on small screens, show on large -->
<div class="hidden md:block">Desktop only</div>
<div class="block md:hidden">Mobile only</div>Flex/grid responsivos
El patrón flex-col md:flex-row es la columna vertebral de los layouts responsivos: apilado verticalmente en teléfonos, lado a lado en escritorio. Emparéjalo con grid-cols-* responsivos para cuadrículas de tarjetas. Diseña siempre primero el layout móvil y luego mejora hacia arriba.
<!-- Stack on mobile, row on desktop -->
<div class="flex flex-col md:flex-row gap-4">
<aside class="md:w-64">Sidebar</aside>
<main class="flex-1">Main</main>
</div>
<!-- 1 col mobile -> 2 col tablet -> 4 col desktop -->
<div class="grid grid-cols-1 sm:grid-cols-2 xl:grid-cols-4 gap-4">
<div>Card</div>
</div>
<!-- Sidebar that hides on mobile -->
<aside class="hidden lg:block lg:w-1/4">Sidebar</aside>Container y max width
container centra el contenido con max-widths responsivos en cada breakpoint (necesita centrado + padding añadidos a mano). El patrón manual 'max-w-7xl mx-auto px-4 sm:px-6 lg:px-8' es el envoltorio de página más común. Para artículos, acota a max-w-2xl/3xl por longitudes de línea legibles.
<div class="container mx-auto px-4">
<!-- Centers content and caps width at each breakpoint -->
</div>
<!-- Or manually cap width -->
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
Standard page wrapper
</div>
<article class="prose max-w-none lg:max-w-2xl mx-auto">
Article with readable line length
</article>Mostrar/ocultar por breakpoint
hidden md:block / block md:hidden es el patrón canónico para alternar elementos entre móvil y escritorio (por ejemplo, menú hamburguesa vs nav completo). print:block se muestra solo al imprimir. Los breakpoints arbitrarios como min-[1200px]: te permiten apuntar a anchos personalizados.
<!-- Mobile-only nav -->
<nav class="block md:hidden">Mobile menu</nav>
<!-- Desktop-only nav -->
<nav class="hidden md:flex">Desktop menu</nav>
<!-- Hide print-only content -->
<div class="hidden print:block">Only shows when printing</div>
<!-- Custom breakpoint -->
<div class="min-[1200px]:flex">Custom MQ</div>Tipografía y espaciado responsivos
Escala la tipografía y el espaciado en cada breakpoint para una jerarquía visual. Para tipografía verdaderamente fluida, usa clamp() vía valor arbitrario: text-[clamp(2rem,5vw,4rem)] — el titular crece suavemente con el viewport entre el mínimo y el máximo.
<h1 class="text-3xl sm:text-4xl md:text-5xl lg:text-6xl
font-bold leading-tight">
Fluid-ish heading
</h1>
<section class="px-4 sm:px-6 lg:px-12 py-8 md:py-12 lg:py-20">
Scales padding with viewport
</section>
<!-- True fluid type with clamp via arbitrary value -->
<h1 class="text-[clamp(2rem,5vw,4rem)]">
Smoothly scales with viewport
</h1>Modo oscuro
Habilitar el modo oscuro (estrategia de clase)
Por defecto Tailwind usa prefers-color-scheme (media). Fjar darkMode:'class' te permite alternar el modo oscuro añadiendo la clase 'dark' a un padre (típicamente <html>) — necesario para los selectores de tema. darkMode:'selector' (v3.4+) es similar pero soporta selectores personalizados.
// tailwind.config.js
module.exports = {
darkMode: "class", // default is "media" (prefers-color-scheme)
// ...
};
<!-- Toggle by adding/removing "dark" on <html> -->
<html class="dark">
<body class="bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100">
Auto-styled in dark
</body>
</html>Variantes dark
Antepón dark: a cualquier utilidad para aplicarla solo en modo oscuro. El patrón es escribir primero el estilo claro y luego las anulaciones dark:. Sé sistemático: emparéja cada bg-*, text-*, border-* con un equivalente dark:* para que nada se vea roto en modo oscuro.
<div class="bg-white dark:bg-gray-800
text-gray-900 dark:text-gray-100
border-gray-200 dark:border-gray-700">
Adapts to theme
</div>
<button class="bg-blue-600 dark:bg-blue-500
hover:bg-blue-700 dark:hover:bg-blue-600">
Themed button
</button>Script de alternancia de tema
Pon este script en línea en <head> antes de que la página se renderice para evitar el destello del tema equivocado (FOUC). Comprueba primero localStorage y luego recurre a la preferencia del sistema. El toggle solo alterna la clase y persiste la elección.
// Check stored preference or system preference on load
if (localStorage.theme === 'dark' ||
(!('theme' in localStorage) &&
window.matchMedia('(prefers-color-scheme: dark)').matches)) {
document.documentElement.classList.add('dark');
} else {
document.documentElement.classList.remove('dark');
}
// Toggle button handler
function toggleTheme() {
document.documentElement.classList.toggle('dark');
localStorage.theme = document.documentElement.classList.contains('dark')
? 'dark' : 'light';
}Solo preferencia del sistema
Si no necesitas un toggle manual, darkMode:'media' (el valor por defecto) sigue el ajuste del sistema operativo del usuario con JavaScript cero. Más simple, pero pierdes la capacidad de sobrescribir la preferencia. Úsalo en sitios de contenido donde respetar la elección del sistema basta.
// tailwind.config.js
module.exports = {
darkMode: "media", // follow prefers-color-scheme automatically
// ...
};
<!-- dark: utilities apply when OS is in dark mode -->
<div class="bg-white dark:bg-gray-900">
No toggle, just follows the OS
</div>
<!-- Force a specific theme by not using dark: at all
(the dark styles simply never apply) -->Buenas prácticas del modo oscuro
Un buen modo oscuro no es solo invertir colores: usa gris oscuro (gray-900) y no negro puro para fondos, blanco roto (gray-100) y no blanco puro para texto, atenúa ligeramente las imágenes y reduce o elimina las sombras. Los colores de marca saturados a menudo necesitan aclararse (blue-600 -> blue-500) en modo oscuro.
<!-- Don't just invert — lower contrast and saturation -->
<div class="bg-white dark:bg-gray-900 <!-- not black -->
text-gray-900 dark:text-gray-100 <!-- not pure white -->
shadow-lg dark:shadow-none"> <!-- shadows look off in dark -->
<!-- Dim images slightly in dark mode -->
<img class="dark:opacity-90 dark:brightness-90" src="/photo.jpg" />
<!-- Reduce border intensity -->
<div class="border-gray-200 dark:border-gray-800">...</div>Animaciones y transiciones
Transiciones
transition-{propiedad} define qué propiedades se animan; duration-{ms} fija el tiempo; ease-{in,out,in-out} fija la función de temporización. transition-colors es la más común (más barata que transition-all). Añade siempre transition antes del cambio hover:* o saltará.
<button class="bg-blue-500 hover:bg-blue-600
transition-colors duration-200">
Color transition
</button>
<div class="transition-all duration-300 ease-in-out
hover:scale-105 hover:shadow-lg">
Multi-property transition
</div>
<div class="transition-opacity duration-500 opacity-50 hover:opacity-100">
Fade in on hover
</div>Propiedades de transición
Prefiere transiciones específicas (transition-colors, transition-transform) sobre transition-all por rendimiento — all vigila cada propiedad y puede causar tirones. duration-* usa 75/100/150/200/300/500/700/1000ms. ease-out se siente natural para elementos de UI que aparecen.
<div class="transition-none">No animation</div>
<div class="transition-colors">bg/text/border-color</div>
<div class="transition-opacity">opacity only</div>
<div class="transition-shadow">box-shadow only</div>
<div class="transition-transform">scale/rotate/translate</div>
<div class="transition-all">Everything (heaviest)</div>
<!-- Duration & easing -->
<div class="duration-150">150ms</div>
<div class="duration-700">700ms</div>
<div class="ease-linear">Linear</div>
<div class="ease-in">Accelerate</div>
<div class="ease-out">Decelerate</div>Animaciones integradas
Tailwind trae cuatro animaciones de keyframe: spin (loader), ping (punto de notificación expandiéndose), pulse (fundido de opacidad — perfecto para skeleton loaders), bounce (juguetona). Para animaciones personalizadas, define keyframes en la configuración y referéncialas vía animate-[nombre].
<div class="animate-spin">Spinning loader</div>
<div class="animate-ping">Pulsing ping (notifications)</div>
<div class="animate-pulse">Fading pulse (skeleton loaders)</div>
<div class="animate-bounce">Bouncing arrow</div>
<!-- Skeleton loader pattern -->
<div class="animate-pulse bg-gray-200 rounded h-4 w-3/4"></div>
<div class="animate-pulse bg-gray-200 rounded h-4 w-1/2 mt-2"></div>Transform
scale-, rotate-, translate- y skew- se componen y animan suavemente con transition-transform. Usa origin-{center,top,bottom-left,...} para cambiar el origen de la transformación. Los adornos de hover de tarjeta (scale + leve rotate + elevación) se sienten premium cuando se mantienen sutiles.
<div class="hover:scale-110 transition-transform">Grow on hover</div>
<div class="hover:rotate-3">Tilt on hover</div>
<div class="hover:-translate-y-1">Lift on hover</div>
<div class="hover:skew-y-3">Skew on hover</div>
<!-- Combined -->
<div class="hover:scale-105 hover:-translate-y-1 hover:rotate-1
transition-transform duration-300">
Card flourish
</div>
<!-- Origin -->
<div class="origin-top-left rotate-12">Rotated from corner</div>Animaciones personalizadas vía configuración
Define keyframes y nombres de animación personalizados en theme.extend. El valor de la animación es abreviado: '{nombre} {duración} {temporización} {iteración}'. Una vez definida, animate-{nombre} se convierte en una utilidad normal. Mantén los keyframes pequeños — viajan en tu bundle de CSS.
// tailwind.config.js
module.exports = {
theme: {
extend: {
keyframes: {
wiggle: {
"0%, 100%": { transform: "rotate(-3deg)" },
"50%": { transform: "rotate(3deg)" },
},
},
animation: {
wiggle: "wiggle 1s ease-in-out infinite",
},
},
},
};
// Usage
<div class="animate-wiggle">Wiggling</div>Formularios
Campos de entrada
El patrón estándar de input: w-full para ancho completo, padding, border, rounded y un focus ring que elimina el outline por defecto. focus:border-transparent oculta el borde de foco nativo; focus:ring-2 dibuja un indicador de foco accesible claro. Estiliza siempre el estado disabled por claridad.
<input type="text"
class="w-full px-3 py-2 border border-gray-300 rounded-md
focus:outline-none focus:ring-2 focus:ring-blue-500
focus:border-transparent
placeholder-gray-400 text-gray-900"
placeholder="Enter your name" />
<input type="email" disabled
class="opacity-50 cursor-not-allowed" />
<textarea class="w-full rounded-md border-gray-300" rows="4"></textarea>Checkboxes y radios
text-{color} en checkboxes/radios fija el color de marcado (usa accent-color por debajo). focus:ring-* añade el indicador de foco de teclado. Para toggles personalizados, usa el patrón peer-* con un checkbox oculto que dirija el estilo, o un plugin como @tailwindcss/forms.
<label class="flex items-center gap-2">
<input type="checkbox" class="rounded border-gray-300
text-blue-600 focus:ring-blue-500" />
Accept terms
</label>
<label class="flex items-center gap-2">
<input type="radio" name="plan"
class="border-gray-300 text-blue-600 focus:ring-blue-500" />
Free plan
</label>
<!-- Custom toggle switch -->
<button role="switch" aria-checked="false"
class="relative w-11 h-6 rounded-full bg-gray-300
peer-checked:bg-blue-600 transition-colors">
<span class="absolute left-0.5 top-0.5 w-5 h-5 bg-white
rounded-full transition-transform peer-checked:translate-x-5">
</span>
</button>Select y opciones
El estilo del <select> nativo está limitado entre navegadores; para control total usa un componente de desplegable personalizado o una librería como Headless UI. El plugin @tailwindcss/forms da a cada elemento de formulario una línea base consistente y fácil de tematizar — vale la pena instalarlo para cualquier app con muchos formularios.
<select class="w-full px-3 py-2 border border-gray-300 rounded-md
bg-white text-gray-900 focus:ring-2 focus:ring-blue-500">
<option value="">Choose...</option>
<option value="us">United States</option>
<option value="cn">China</option>
</select>
<!-- Multiple select -->
<select multiple class="h-32">
<option>Tag 1</option>
<option>Tag 2</option>
</select>Layout del formulario
space-y-4 es la forma más limpia de espaciar las filas de un formulario — sin márgenes por campo. Emparéja cada input con un <label class='block text-sm font-medium mb-1'> para un estilo de etiquetas consistente. Envuélvelo en max-w-md para mantener el ancho del formulario legible en escritorio.
<form class="space-y-4 max-w-md">
<div>
<label class="block text-sm font-medium text-gray-700 mb-1">
Email
</label>
<input type="email" class="w-full ..." />
</div>
<div>
<label class="block text-sm font-medium text-gray-700 mb-1">
Password
</label>
<input type="password" class="w-full ..." />
</div>
<button type="submit" class="w-full bg-blue-600 text-white py-2 rounded">
Sign in
</button>
</form>Botones
Los botones merecen variantes active: (pulsado), disabled: (estado) y focus: (teclado) — no solo hover. active:bg-{más_oscuro} da retroalimentación física. disabled:opacity-50 disabled:cursor-not-allowed es el tratamiento estándar de deshabilitado. Mantén una altura consistente (por ejemplo, py-2) entre variantes de botón.
<button class="bg-blue-600 hover:bg-blue-700 active:bg-blue-800
text-white font-medium py-2 px-4 rounded-md
transition-colors focus:outline-none
focus:ring-2 focus:ring-blue-500 focus:ring-offset-2">
Primary
</button>
<button class="bg-white border border-gray-300 hover:bg-gray-50
text-gray-700 py-2 px-4 rounded-md transition-colors">
Secondary
</button>
<button class="text-blue-600 hover:text-blue-800 hover:underline">
Ghost link button
</button>
<button class="bg-red-600 hover:bg-red-700 disabled:opacity-50
disabled:cursor-not-allowed" disabled>
Disabled
</button>Tarjetas
Tarjeta básica
La tarjeta canónica: rounded + shadow + overflow-hidden (para que las esquinas de la imagen se recorten bien). object-cover en la imagen evita la distorsión. hover:shadow-lg con transition-shadow da el efecto de elevación. overflow-hidden es clave para los remates de imagen redondeados.
<div class="max-w-sm rounded-xl shadow-md overflow-hidden
bg-white hover:shadow-lg transition-shadow">
<img class="w-full h-48 object-cover" src="/photo.jpg" alt="" />
<div class="p-6">
<h3 class="text-xl font-semibold mb-2">Card title</h3>
<p class="text-gray-600">Card description goes here.</p>
<button class="mt-4 text-blue-600 font-medium hover:underline">
Learn more
</button>
</div>
</div>Cuadrícula de tarjetas
Para cuadrículas de tarjetas, usa el patrón auto-fill + minmax: las tarjetas miden al menos 280px y se estiran para llenar, envolviéndose automáticamente — sin media queries. Para conteos fijos de columnas en breakpoints conocidos, el enfoque responsivo grid-cols-* es más sencillo de razonar.
<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3
gap-6">
<div class="rounded-xl shadow p-6 bg-white">Card 1</div>
<div class="rounded-xl shadow p-6 bg-white">Card 2</div>
<div class="rounded-xl shadow p-6 bg-white">Card 3</div>
<div class="rounded-xl shadow p-6 bg-white">Card 4</div>
</div>
<!-- Auto-fit grid for variable width -->
<div class="grid gap-6
grid-cols-[repeat(auto-fill,minmax(280px,1fr))]">
<!-- Cards naturally wrap based on viewport -->
</div>Tarjeta interactiva (toda clicable)
Envolver toda la tarjeta en un <a> la hace totalmente clicable (mejor UX que un botón separado de 'Leer más'). El patrón group + group-hover te permite animar elementos hijos (el color del título, la posición de la flecha) cuando se pasa el ratón por el padre — potente para tarjetas interactivas.
<a href="/post" class="group block max-w-sm rounded-xl
shadow-md hover:shadow-xl transition-shadow bg-white">
<div class="p-6">
<h3 class="font-semibold group-hover:text-blue-600 transition-colors">
Card title
</h3>
<p class="text-gray-600 mt-2">Description...</p>
<span class="mt-4 inline-flex items-center text-blue-600">
Read more
<svg class="w-4 h-4 ml-1 group-hover:translate-x-1 transition-transform">
<!-- arrow icon path -->
</svg>
</span>
</div>
</a>Tarjeta con footer
Usa flex flex-col en la tarjeta y flex-1 en el body para que el footer se pegue abajo incluso cuando los cuerpos de las tarjetas tengan longitudes distintas — mantiene una fila de tarjetas alineada. El footer típicamente tiene metadatos y acciones con un bg sutil y un borde superior.
<div class="max-w-sm rounded-xl shadow bg-white flex flex-col">
<div class="p-6 flex-1">
<h3 class="text-lg font-semibold">Title</h3>
<p class="text-gray-600 mt-2">Body content...</p>
</div>
<div class="px-6 py-4 bg-gray-50 border-t border-gray-100
flex justify-between items-center">
<span class="text-sm text-gray-500">Aug 12, 2025</span>
<button class="text-sm text-blue-600 hover:underline">Share</button>
</div>
</div>Tarjeta de perfil / avatar
Avatar + nombre + acción es el patrón estándar de tarjeta-fila. Usa flex items-center gap-4 para alinearlos. Para los puntos de estado, position absolute abajo a la derecha con un ring que coincida con el bg de la tarjeta para 'recortar' el punto. Los avatares usan rounded-full + w/h iguales + object-cover.
<div class="flex items-center gap-4 p-4 rounded-xl shadow bg-white">
<img src="/avatar.jpg"
class="w-12 h-12 rounded-full object-cover" alt="" />
<div class="flex-1">
<p class="font-semibold">Alice Zhang</p>
<p class="text-sm text-gray-500">Software Engineer</p>
</div>
<button class="text-blue-600 text-sm font-medium">Follow</button>
</div>
<!-- Status indicator -->
<div class="relative">
<img class="w-10 h-10 rounded-full" src="/avatar.jpg" />
<span class="absolute bottom-0 right-0 w-3 h-3
bg-green-500 rounded-full ring-2 ring-white"></span>
</div>Patrones de layout
Position
relative + absolute es el caballo de batalla: fija position:relative en un padre y position:absolute en un hijo para colocarlo con precisión. inset-0 = top/right/bottom/left:0 (llena al padre). sticky top-0 es esencial para encabezados pegajosos — necesita que el padre sea lo bastante alto para hacer scroll.
<div class="static">Default flow</div>
<div class="relative">
<div class="absolute top-0 right-0">Top-right of parent</div>
</div>
<div class="fixed bottom-4 right-4">Stuck to viewport</div>
<div class="sticky top-0">Sticks when scrolling</div>
<!-- Inset shorthand for all sides -->
<div class="absolute inset-0">Fills parent</div>
<div class="absolute inset-x-0 bottom-0">Full width, at bottom</div>Z-index y apilamiento
Tailwind ofrece z-0/10/20/30/40/50 más z-auto. Usa una convención consistente: 0 = base, 10 = desplegables, 20 = sticky, 30 = modals, 40 = overlays, 50 = toasts/tooltips. Los modals necesitan tanto un z-index alto COMO fixed inset-0 para cubrir el viewport.
<div class="z-0">Base layer</div>
<div class="z-10">Dropdowns</div>
<div class="z-20">Sticky headers</div>
<div class="z-30">Modals</div>
<div class="z-40">Overlays</div>
<div class="z-50">Tooltips, toasts</div>
<!-- Combine with relative/absolute/fixed -->
<div class="fixed inset-0 z-50 bg-black/50">Modal overlay</div>Display
block/inline-block/inline/hidden son los básicos. inline-block es útil para elementos que necesitan width/height pero deben quedar en línea. hidden los quita del layout por completo (frente a opacity-0 que conserva el espacio). Alterna con prefijos de breakpoint para mostrar/ocultar responsivamente.
<div class="block">Full-width block</div>
<div class="inline-block">Inline with set width/height</div>
<div class="inline">Flows inline</div>
<div class="hidden">Removed from layout</div>
<div class="flex">Flex container</div>
<div class="grid">Grid container</div>
<!-- Toggle on breakpoint -->
<div class="hidden md:block">Hidden on mobile</div>
<div class="block md:hidden">Hidden on desktop</div>
<!-- Tables, contents, list-item also available -->Overflow
overflow-hidden recorta el contenido (también se usa para que las esquinas redondeadas recorten a los hijos). overflow-auto añade barras de scroll solo cuando hacen falta; overflow-x-auto con whitespace-nowrap es el patrón estándar de scroll horizontal para filas de navegación y bloques de código.
<div class="overflow-hidden">Clips overflow</div>
<div class="overflow-auto">Scrollbars if needed</div>
<div class="overflow-scroll">Always scrollable</div>
<div class="overflow-visible">Default, overflows</div>
<!-- Per-axis -->
<div class="overflow-x-auto whitespace-nowrap">Horizontal scroll</div>
<div class="overflow-y-auto h-64">Vertical scroll area</div>
<!-- Hide scrollbars while keeping scroll (Webkit) -->
<div class="overflow-x-auto scrollbar-hide">...</div>Float y clear
Los floats están mayormente reemplazados por flexbox/grid para el layout, pero float-left + mr-4 sigue funcionando bien para que el texto envuelva imágenes. Para la mayoría de necesidades de dimensionado de imagen, object-cover (llena, puede recortar) u object-contain (encaja, puede dejar bandas) sobre un img con dimensiones fijadas es el enfoque moderno.
<img class="float-left mr-4 rounded" src="/photo.jpg" />
<p>Text wraps around the floated image on the right...</p>
<p class="clear-both">After the float</p>
<!-- Floats are mostly legacy; prefer flex/grid for layout.
Still useful for text wrapping around images. -->
<!-- Object fit for responsive images -->
<img class="w-full h-48 object-cover" src="/hero.jpg" />
<img class="w-24 h-24 object-contain" src="/logo.png" />Efectos y filtros
Backdrop blur (glassmorphism)
backdrop-blur-* desenfoca lo que hay detrás del elemento (no el elemento en sí) — combinado con un bg translúcido (bg-white/30) crea el efecto glassmorphism. Perfecto para modals, encabezados sticky sobre contenido y paneles esmerilados estilo iOS.
<div class="backdrop-blur-md bg-white/30 border border-white/20
rounded-xl p-6 shadow-lg">
Frosted glass card
</div>
<!-- Strengths -->
<div class="backdrop-blur-sm">Light blur</div>
<div class="backdrop-blur-md">Medium</div>
<div class="backdrop-blur-xl">Heavy</div>
<div class="backdrop-blur-2xl">Maximum</div>
<!-- Modal overlay with blur -->
<div class="fixed inset-0 bg-black/50 backdrop-blur-sm z-50">
Overlay with frosted bg
</div>Filtros de imagen
Las utilidades de filtro se mapean a funciones de filtro CSS: blur, brightness, contrast, grayscale, invert, sepia, saturate, hue-rotate. El patrón grayscale hover:grayscale-0 es un efecto popular para fotos de equipo e imágenes de producto — el color aparece al pasar el ratón.
<img class="blur-sm" src="/photo.jpg" />
<img class="blur-md" src="/photo.jpg" />
<img class="brightness-110" src="/photo.jpg" />
<img class="contrast-125" src="/photo.jpg" />
<img class="grayscale" src="/photo.jpg" />
<img class="invert" src="/photo.jpg" />
<img class="sepia" src="/photo.jpg" />
<img class="saturate-150" src="/photo.jpg" />
<!-- Combined + hover -->
<img class="grayscale hover:grayscale-0 transition-all duration-500"
src="/photo.jpg" />Mix blend mode
mix-blend-mode controla cómo se mezcla un elemento con lo que hay detrás. mix-blend-difference sobre texto blanco encima de una imagen crea un efecto de alto contraste legible sin importar la imagen subyacente — popular en secciones hero. Úsalo con moderación; puede parecer artificial.
<div class="mix-blend-multiply">Multiplies with bg</div>
<div class="mix-blend-screen">Lightens</div>
<div class="mix-blend-overlay">Contrast blend</div>
<div class="mix-blend-difference">Inverts colors</div>
<!-- Text over image with blend -->
<div class="relative">
<img src="/photo.jpg" />
<h1 class="absolute inset-0 flex items-center justify-center
text-white mix-blend-difference text-6xl font-bold">
Overlay text
</h1>
</div>Opacity
opacity-{0,25,50,75,100} (más 5/10/20/.../95) fija la opacidad del elemento — afecta al elemento Y a sus hijos. Para solo un fondo translúcido usa en su lugar bg-{color}/{opacidad}, que mantiene el texto totalmente opaco. opacity-0 oculta pero conserva el layout (frente a hidden que lo elimina).
<div class="opacity-100">Fully visible</div>
<div class="opacity-75">75%</div>
<div class="opacity-50">Half</div>
<div class="opacity-25">Mostly transparent</div>
<div class="opacity-0">Invisible (still takes space)</div>
<!-- Hover fade -->
<button class="opacity-100 hover:opacity-80 transition-opacity">
Fades on hover
</button>
<!-- vs bg-black/50: opacity affects the whole element
(including children), bg color/opacity only the background -->Cursor y selección de usuario
Emparéja siempre el cursor con el comportamiento: cursor-pointer para lo clicable, cursor-not-allowed para lo deshabilitado. select-none desactiva la selección de texto (útil para el chrome de UI y botones propensos a doble clic). resize-none en textareas evita el tirador de redimensionado por defecto cuando quieres un layout consistente.
<button class="cursor-pointer">Pointer on hover</button>
<div class="cursor-not-allowed opacity-50">Disabled</div>
<div class="cursor-move">Drag handle</div>
<div class="cursor-text">Text input area</div>
<!-- Selection -->
<p class="select-none">Cannot be selected</p>
<p class="select-text">Selectable text</p>
<p class="select-all">Selects all on click</p>
<!-- Resize handle -->
<textarea class="resize-none"></textarea>
<textarea class="resize-y"></textarea>Transiciones y transformaciones
Origen y escala de transform
origin-* fija el punto de origen de la transformación. scale-x-* / scale-y-* escalan independientemente por eje. transform-gpu fuerza la aceleración por GPU (translate3d) para animaciones más suaves — úsalo cuando veas tirones en elementos con muchas transformaciones como carruseles.
<div class="origin-center scale-110">Center origin (default)</div>
<div class="origin-top-left scale-90">Top-left origin</div>
<div class="origin-bottom rotate-45">Bottom origin, rotated</div>
<!-- Combined transforms -->
<div class="transform-gpu hover:scale-105 hover:rotate-3
transition-transform duration-300">
GPU-accelerated flourish
</div>
<!-- Independent scale axes -->
<div class="hover:scale-x-110">Stretches horizontally</div>
<div class="hover:scale-y-90">Squishes vertically</div>Translate y rotate
translate-{x,y}-{n} mueve el elemento usando la escala de espaciado (o usa /2 para 50% vía -translate-x-1/2). El patrón left-1/2 + -translate-x-1/2 centra perfectamente un elemento posicionado absolutamente sin importar su ancho — útil para tooltips y modals.
<div class="translate-x-4">16px right</div>
<div class="-translate-x-4">16px left</div>
<div class="translate-y-2">8px down</div>
<div class="rotate-45">45deg clockwise</div>
<div class="-rotate-12">12deg counter-clockwise</div>
<div class="rotate-180">Flipped</div>
<!-- Centering trick: absolute + translate -->
<div class="absolute left-1/2 top-1/2
-translate-x-1/2 -translate-y-1/2">
Perfectly centered
</div>Skew y transformaciones 3D
Skew inclina un elemento a lo largo de un eje — útil para sutiles efectos de paralelogramo. Las transformaciones 3D (perspective, rotate-y, rotate-x, transform-style-3d) exigen extensión de tema en el Tailwind por defecto pero habilitan efectos de volteo de tarjeta y parallax. La mayoría de proyectos usan solo transformaciones 2D.
<div class="skew-x-12">Skewed horizontally</div>
<div class="skew-y-6">Skewed vertically</div>
<div class="-skew-x-6">Counter skew</div>
<!-- 3D (needs perspective on parent) -->
<div class="perspective-1000">
<div class="rotate-y-12 transform-style-3d">Tilted in 3D</div>
</div>
<!-- Card flip pattern -->
<div class="preserve-3d group hover:rotate-y-180
transition-transform duration-700">
Flips on hover (needs config)
</div>Retardo y temporización de la transición
delay-{ms} retrasa el inicio de una transición — combínalo con retardos por hijo para crear entradas escalonadas (cada ítem empieza un poco más tarde). ease-out se siente natural para cosas que aparecen (desaceleran hasta colocarse), ease-in para las que desaparecen (aceleran alejándose).
<div class="transition-colors duration-300 delay-150
hover:bg-blue-500">
Starts after 150ms
</div>
<!-- Stagger children via inline delay style -->
<div class="flex gap-2">
<div class="transition-all delay-0 duration-500">A</div>
<div class="transition-all delay-100 duration-500">B</div>
<div class="transition-all delay-200 duration-500">C</div>
</div>
<!-- Easing -->
<div class="ease-in-out">Smooth</div>
<div class="ease-out">Decelerate (good for entrances)</div>
<div class="ease-in">Accelerate (good for exits)</div>Estados hover vs focus vs active
Considera siempre focus (usuarios de teclado) y active (pulsación de ratón) además de hover. focus-visible: aplica solo con foco de teclado (no con clic de ratón) — normalmente lo que quieres para los anillos de foco. group + group-hover: deja que el hover del padre dirija el estilo de los hijos — esencial para tarjetas y hovers complejos.
<button class="bg-blue-500
hover:bg-blue-600 <!-- mouse over -->
focus:bg-blue-700 <!-- keyboard focus -->
active:bg-blue-800 <!-- mouse down -->
focus:outline-none focus:ring-2 focus:ring-blue-300
transition-colors">
All states styled
</button>
<!-- Group hover: style children when parent hovered -->
<div class="group">
<button class="group-hover:scale-110 transition-transform">
Scales when parent hovered
</button>
</div>Dimensionado
Escala de width
w-* usa la escala de espaciado más fracciones (1/2, 1/3, 2/3, 1/4, 3/4, 1/5, ..., 1/12) para porcentajes. w-full = 100%, w-screen = 100vw, w-fit = ancho intrínseco, w-max = max-content. Usa w-full + max-w-{tamaño} para contenido responsivo que se acota a un ancho legible.
<div class="w-0">0</div>
<div class="w-px">1px</div>
<div class="w-1">0.25rem</div>
<div class="w-4">1rem (16px)</div>
<div class="w-16">4rem (64px)</div>
<div class="w-64">16rem</div>
<div class="w-96">24rem</div>
<!-- Fractions -->
<div class="w-1/2">50%</div>
<div class="w-1/3">33.33%</div>
<div class="w-2/3">66.67%</div>
<div class="w-full">100%</div>
<div class="w-screen">100vw</div>Height y viewport
h-screen = 100vh, que tiene problemas con la barra de direcciones del navegador móvil. Prefiere h-dvh (altura dinámica de viewport) para layouts de altura completa amigables con móvil — se ajusta cuando el chrome del navegador se muestra/oculta. min-h-screen es el estándar para layouts de footer pegajoso.
<div class="h-8">2rem</div>
<div class="h-64">16rem</div>
<div class="h-full">100% of parent</div>
<div class="h-screen">100vh (full viewport)</div>
<!-- Modern viewport units (v3.4+) -->
<div class="h-dvh">Dynamic viewport height (mobile-friendly)</div>
<div class="h-svh">Small viewport height</div>
<div class="h-lvh">Large viewport height</div>
<!-- min/max -->
<div class="min-h-screen">At least viewport tall</div>
<div class="max-h-96 overflow-y-auto">Capped scroll area</div>Min/max width
max-w-{xs,sm,md,lg,xl,2xl,...,7xl} se mapea a tamaños basados en rem ideales para el ancho de contenido. Envolver el contenido de la página en max-w-7xl mx-auto es estándar. min-w-0 es un truco crítico de flexbox — deja que los hijos flex encojan por debajo de su tamaño intrínseco para evitar el desbordamiento.
<!-- Max-width is the key to readable content -->
<article class="max-w-2xl mx-auto">
Caps article at ~42rem (readable line length)
</article>
<!-- Common max-widths -->
<div class="max-w-sm">384px</div>
<div class="max-w-md">28rem</div>
<div class="max-w-lg">32rem</div>
<div class="max-w-xl">36rem</div>
<div class="max-w-7xl">80rem</div>
<!-- min-width for inputs etc -->
<input class="min-w-0" /> <!-- prevent flex overflow -->
<div class="min-w-full">Always at least full width</div>Relación de aspecto
aspect-{ratio} mantiene una relación de aspecto fija sin importar el ancho — mucho más limpio que el viejo hack de padding-bottom. aspect-video es el estándar para incrustaciones de vídeo. Combínalo con object-cover para llenar la caja sin distorsión. Las relaciones arbitrarias como aspect-[21/9] también funcionan.
<div class="aspect-square">1:1 square</div>
<div class="aspect-video">16:9 widescreen</div>
<div class="aspect-[4/3]">4:3</div>
<div class="aspect-[21/9]">Ultrawide</div>
<!-- Responsive video embed -->
<div class="aspect-video w-full">
<iframe class="w-full h-full" src="..."></iframe>
</div>
<!-- Avatar / product image -->
<img class="aspect-square object-cover w-24" />Object fit y position
object-fit en <img> (y <video>) controla cómo la fuente llena su caja: cover (llena, recorta), contain (encaja, deja bandas), fill (estira), none (tamaño original). Emparéjalo con object-{posición} para controlar qué parte se conserva al recortar. object-cover + object-center es el valor por defecto para imágenes hero.
<img class="w-full h-48 object-cover" src="/hero.jpg" />
<!-- Fills the box, may crop. Best for hero images. -->
<img class="w-full h-48 object-contain" src="/logo.png" />
<!-- Fits entire image, may letterbox. Best for logos. -->
<img class="w-full h-48 object-fill" src="/img.jpg" />
<!-- Stretches to fill (distorts). Rarely what you want. -->
<img class="w-full h-48 object-none" src="/img.jpg" />
<!-- Keeps original size, may overflow. -->
<!-- Position -->
<img class="object-cover object-top" src="/portrait.jpg" />
<img class="object-cover object-center" src="/photo.jpg" />Interactividad y estado
Hover, focus y group
group convierte un elemento en fuente de estado; group-hover:* aplica un estilo a un hijo cuando se pasa el ratón por el padre. Crucial para tarjetas donde el hover sobre la tarjeta afecta a la vez a la imagen, el título y una acción oculta. Los grupos con nombre (group/card) permiten anidar.
<button class="hover:bg-blue-600">Hover state</button>
<input class="focus:ring-2 focus:ring-blue-500" />
<div class="active:scale-95">Press feedback</div>
<!-- group / group-hover: style children based on parent state -->
<div class="group">
<img class="group-hover:scale-110 transition-transform" />
<h3 class="group-hover:text-blue-600">Title</h3>
<p class="opacity-0 group-hover:opacity-100">Revealed on hover</p>
</div>Peer (estado de hermano)
peer marca un elemento como fuente de estado para sus HERMANOS (solo los hermanos posteriores, por defecto). peer-checked:* te permite estilizar hermanos según el estado de un checkbox/radio — impulsa toggles de solo CSS, botones de revelar contraseña y acordeones sin JavaScript.
<!-- Style a sibling based on an input's state -->
<input type="checkbox" id="c" class="peer" />
<label for="c" class="peer-checked:text-blue-600">
Styled when checkbox checked
</label>
<!-- Show/hide password -->
<input type="checkbox" id="show" class="peer hidden" />
<label for="show" class="peer-checked:hidden">Show</label>
<label for="show" class="hidden peer-checked:inline">Hide</label>
<!-- Toggle a panel -->
<input type="checkbox" class="peer hidden" />
<div class="hidden peer-checked:block">Toggleable panel</div>Focus-visible (solo teclado)
Usa focus-visible: en lugar de focus: para los anillos de foco — muestra el anillo solo para los usuarios de teclado (que lo necesitan) y lo oculta para los clics de ratón (que tienen su propia retroalimentación visual). Emparéjalo con focus:outline-none para suprimir el anillo por defecto del navegador.
<button class="focus:outline-none
focus-visible:ring-2 focus-visible:ring-blue-500">
No ring on mouse click, ring on keyboard focus
</button>
<!-- Why focus-visible: -->
<!-- - focus: applies on BOTH mouse click and keyboard
(annoying for mouse users)
- focus-visible: only on keyboard navigation
(the accessible choice for focus rings) -->Placeholder e input de archivo
placeholder-* estiliza el texto del marcador. file:* estiliza el pseudo-botón dentro de <input type='file'> — un elemento notoriamente difícil de estilizar, pero la variante file: de Tailwind lo vuelve manejable. El patrón de arriba da un botón limpio y con marca de subida de archivos.
<input class="placeholder-gray-400 placeholder-italic"
placeholder="Type here..." />
<!-- Style the file input button -->
<input type="file"
class="block w-full text-sm text-gray-500
file:mr-4 file:py-2 file:px-4
file:rounded-md file:border-0
file:text-sm file:bg-blue-50
file:text-blue-700
hover:file:bg-blue-100" />Marker y selección
marker:* estiliza las viñetas/números de listas. selection:* estiliza el resaltado cuando los usuarios seleccionan texto. first-letter:* / first-line:* habilitan capitulares y primeras líneas en versalitas — útil para diseños editoriales. Cada uno de estos pseudo-elementos tiene variantes dedicadas de Tailwind.
<ul class="marker:text-blue-500 list-disc pl-5">
<li>Blue bullet</li>
<li>Blue bullet</li>
</ul>
<!-- Style text selection -->
<p class="selection:bg-blue-200 selection:text-blue-900">
Select this text to see a blue highlight.
</p>
<!-- Global selection (in CSS) -->
::selection { background: #bfdbfe; color: #1e3a8a; }
<!-- First-line / first-letter -->
<p class="first-letter:text-5xl first-letter:font-bold
first-letter:float-left first-letter:mr-2
first-line:uppercase first-line:tracking-wide">
Drop cap paragraph.
</p>Valores arbitrarios y personalización
Valores arbitrarios
Los corchetes te permiten usar cualquier valor de CSS sin extender el tema — perfecto para casos puntuales. Los guiones bajos en los valores se convierten en espacios (así grid-cols-[200px_1fr] se vuelve '200px 1fr'). El abuso lleva a un diseño inconsistente; prefiere la extensión de tema para valores repetidos.
<!-- Any CSS value in square brackets -->
<div class="w-[300px] h-[200px] bg-[#1da1f2]">
Custom sizes and colors
</div>
<p class="text-[13px] leading-[1.6]">
Custom typography
</p>
<div class="grid-cols-[200px_1fr_100px]">
Custom grid template (underscores = spaces)
</div>
<div class="top-[117px]">
Custom positioning
</div>Propiedades arbitrarias
[propiedad:valor] define una propiedad CSS arbitraria — útil para propiedades de las que Tailwind no tiene utilidades (mask-type, hyphens, etc.). [--var:valor] fija una variable CSS que luego puedes referenciar en valores arbitrarios como p-[var(--tw)]. Potente para temas.
<!-- Define an arbitrary CSS property -->
<div class="[mask-type:luminance]">
Sets mask-type: luminance
</div>
<!-- Arbitrary property with Tailwind variable -->
<div class="[--scroll-offset:56px] top-[var(--scroll-offset)]">
Custom CSS variable
</div>
<!-- CSS variables + arbitrary values are powerful together -->
<div class="[--tw:1rem] p-[var(--tw)]">
Theme-driven custom value
</div>Variantes arbitrarias
Las variantes arbitrarias extienden el sistema de variantes de Tailwind: min-[1200px]: para breakpoints personalizados, aria-*: para estados ARIA, odd:/even: para rayado, has-[:checked]: para estilo relacional. La variante has-* (una característica reciente de CSS) es particularmente potente para estilizar padres según el estado de los hijos.
<!-- Arbitrary media query -->
<div class="min-[1200px]:flex">Custom breakpoint</div>
<!-- ARIA attribute variants -->
<button aria-pressed="true"
class="aria-pressed:bg-blue-600">
Toggle styled by ARIA state
</button>
<!-- nth-child -->
<li class="odd:bg-gray-50">Striped table row</li>
<li class="even:bg-white">Striped table row</li>
<!-- has: variant (Tailwind v3.4+) -->
<div class="has-[:checked]:bg-blue-50">
Highlights when it contains a checked input
</div>Extensión de tema
theme.extend añade a los valores por defecto; theme.{clave} los reemplaza. DEFAULT te deja usar el nombre base (bg-brand) más los tonos (bg-brand-dark). Añade espaciados, breakpoints, radios, etc. personalizados. Extender es casi siempre lo que quieres — reemplazar la paleta de colores elimina los valores por defecto de Tailwind.
// tailwind.config.js
module.exports = {
theme: {
extend: {
colors: {
brand: { light: "#5eead4", DEFAULT: "#14b8a6", dark: "#0f766e" },
},
spacing: { 18: "4.5rem" },
borderRadius: { xl: "1rem" },
screens: { tall: { raw: "(min-height: 800px)" } },
},
},
};
<!-- Now you can use: -->
<div class="bg-brand text-brand-light p-18 rounded-xl">
Custom themed utilities
</div>Plugins y @apply
Los plugins añaden utilidades o componentes nuevos (forms, typography y aspect-ratio son los oficiales). @apply te permite incrustar utilidades de Tailwind en CSS personalizado — útil cuando tienes una clase que usas idénticamente en docenas de lugares. No abuses de @apply; el enfoque utility-first suele ser más limpio.
// tailwind.config.js — register a plugin
const forms = require("@tailwindcss/forms");
module.exports = { plugins: [forms] };
/* Use @apply to compose utilities into custom CSS */
@layer components {
.btn-primary {
@apply bg-blue-600 text-white font-medium py-2 px-4
rounded-md hover:bg-blue-700 transition-colors;
}
}
<!-- Then use the custom class -->
<button class="btn-primary">Save</button>Patrones del mundo real
Modal / diálogo
Anatomía del modal: overlay fixed inset-0 (cubre el viewport), z-50 (por encima de cualquier otra capa), centrado flex para el panel, y el propio panel posicionado relative para que quede sobre el overlay. backdrop-blur añade pulido. Ofrece siempre un botón de cierre visible y ESC-para-cerrar por accesibilidad.
<div class="fixed inset-0 z-50 flex items-center justify-center">
<!-- Overlay -->
<div class="absolute inset-0 bg-black/50 backdrop-blur-sm"></div>
<!-- Panel -->
<div class="relative bg-white rounded-xl shadow-2xl
w-full max-w-md mx-4 p-6">
<h2 class="text-lg font-semibold mb-4">Modal title</h2>
<p class="text-gray-600">Modal body content.</p>
<div class="flex justify-end gap-2 mt-6">
<button class="px-4 py-2 text-gray-600">Cancel</button>
<button class="px-4 py-2 bg-blue-600 text-white rounded-md">OK</button>
</div>
</div>
</div>Toast / notificación
Los toasts se fijan a una esquina (abajo a la derecha es lo convencional), ancho acotado, con un borde izquierdo de color que indica el tipo (verde=éxito, rojo=error, amarillo=aviso, azul=info). Emparéjalo con una animación guiada por JS (entrada deslizante vía translate-x) y descarte automático tras unos segundos.
<div class="fixed bottom-4 right-4 z-50 max-w-sm
bg-white rounded-lg shadow-xl border-l-4 border-green-500
flex items-center gap-3 p-4">
<div class="text-green-500">
<svg class="w-5 h-5"><!-- check icon --></svg>
</div>
<div class="flex-1">
<p class="font-medium text-gray-900">Saved successfully</p>
<p class="text-sm text-gray-500">Your changes are live.</p>
</div>
<button class="text-gray-400 hover:text-gray-600">×</button>
</div>Badge y píldora
Los badges son píldoras inline-flex (rounded-full) o etiquetas (rounded). Usa bg-{color}-100 + text-{color}-800 para el estilo pastel suave. Añade un punto (w-1.5 h-1.5 rounded-full) para los indicadores de estado. Mantén text-xs font-medium para la escala de texto del badge.
<span class="inline-flex items-center px-2.5 py-0.5
rounded-full text-xs font-medium
bg-green-100 text-green-800">
Active
</span>
<span class="inline-flex items-center gap-1 px-2 py-0.5
rounded-full text-xs font-medium
bg-blue-100 text-blue-800">
<span class="w-1.5 h-1.5 rounded-full bg-blue-500"></span>
Online
</span>
<span class="inline-flex items-center px-2 py-0.5
rounded text-xs font-medium
bg-red-100 text-red-800">
Deprecated
</span>Estado vacío
Los estados vacíos necesitan: un icono en un círculo suave, un titular corto, un texto de apoyo y un CTA principal. Centra el contenido (text-center mx-auto), usa un padding generoso py-12 y apaga los colores (texto gray-400/500) para que el botón CTA atraiga la mirada. No muestres solo 'No hay datos'.
<div class="text-center py-12 px-4">
<div class="mx-auto w-16 h-16 rounded-full bg-gray-100
flex items-center justify-center mb-4">
<svg class="w-8 h-8 text-gray-400"><!-- icon --></svg>
</div>
<h3 class="text-lg font-medium text-gray-900">No items yet</h3>
<p class="mt-1 text-sm text-gray-500">
Get started by creating your first item.
</p>
<button class="mt-4 bg-blue-600 text-white px-4 py-2 rounded-md">
New item
</button>
</div>Skeleton de carga
Los skeleton loaders usan animate-pulse sobre un contenedor de bloques grises con la forma del contenido real. Iguala el layout y las proporciones del estado cargado para que no haya un salto brusco al llegar los datos. rounded-full + w-10 h-10 imita un avatar; anchos variables (w-3/4, w-1/2) imitan líneas de texto.
<div class="animate-pulse space-y-3">
<div class="h-4 bg-gray-200 rounded w-3/4"></div>
<div class="h-4 bg-gray-200 rounded w-1/2"></div>
<div class="space-y-2">
<div class="h-3 bg-gray-200 rounded"></div>
<div class="h-3 bg-gray-200 rounded"></div>
</div>
<div class="flex gap-4">
<div class="w-10 h-10 bg-gray-200 rounded-full"></div>
<div class="flex-1 space-y-2 py-1">
<div class="h-3 bg-gray-200 rounded"></div>
<div class="h-3 bg-gray-200 rounded w-5/6"></div>
</div>
</div>
</div>Fragmentos de Tailwind CSS relacionados
Copy-paste ready code for common tasks.
Utility Classes
Compose a button and card from atomic utilities.
Responsive Design
Apply per-breakpoint utilities with sm:, md:, and lg: prefixes.
Hover & Focus States
Style interactive states and group-hover with variant prefixes.
Flexbox & Grid
Center, distribute, and grid layouts with utilities.
Colors
Use the default palette, opacity modifiers, and gradients.
Spacing
Apply padding, margin, gap, and width/height from one scale.
Custom Configuration
Extend the theme with custom colors, fonts, and animations.
Dark Mode
Toggle themes with the dark: variant and class strategy.
Was this helpful?