Skip to content

Tailwind CSS Folha de referência

Framework CSS utility-first para desenvolvimento rápido de UI.

01

Primeiros Passos

Instalação via CDN

O script CDN é a forma mais rápida de prototipar com Tailwind. Ele gera utilitários em runtime ao escanear sua marcação. Para produção, prefira o build via PostCSS ou CLI para remover classes não usadas e entregar um pacote CSS minúsculo.

tailwind
<!-- 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>

Configuração do Projeto (CLI)

O array content é crítico — o Tailwind só gera as classes que encontra nesses arquivos (tree-shaking). Esquecer um caminho é a causa nº 1 de bugs do tipo 'minha classe sumiu'. Use --watch durante o desenvolvimento.

tailwind
# 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 --watch

Diretivas do CSS de Entrada

As diretivas @tailwind injetam as três camadas do Tailwind em ordem: base (resets), components, utilities. @layer permite adicionar seu próprio CSS na camada de cascata certa. @apply incorpora estilos utilitários numa regra personalizada.

tailwind
/* 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

A filosofia do Tailwind: construir UIs compondo classes utilitárias pequenas e de propósito único, em vez de inventar nomes de classes semânticos. Isso mantém o CSS plano, evita código morto e torna os designs consistentes por meio de uma escala compartilhada de espaçamento/cor.

tailwind
<!-- 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. -->

Configuração e Extensão do Tema

Use theme.extend para acrescentar aos padrões do Tailwind sem substituí-los. Definir uma chave no nível superior de theme (sem extend) substitui aquela escala por inteiro. Cores personalizadas como brand-500 geram bg-brand-500, text-brand-500, border-brand-500, etc.

tailwind
// 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: [],
};
02

Cores

Cores de Texto, Fundo e Borda

Os utilitários de cor seguem o padrão {propriedade}-{cor}-{tonalidade}. As tonalidades vão de 50 (mais clara) a 950 (mais escura). Propriedades comuns: text-, bg-, border-, ring-, fill-, stroke-, from-/to-/via- (gradientes).

tailwind
<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 Opacidade

Acrescente /{opacity} a qualquer utilitário de cor para definir o canal alfa. Isso usa color-mix ou rgba por baixo dos panos e funciona para texto, bg, border, ring, etc. É a forma mais limpa de dar um tom sem definir novas entradas de paleta.

tailwind
<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>

Gradientes

Use bg-gradient-to-{direção} com pontos de cor from-, via- e to-. As direções incluem t (topo), b, l, r, tr, tl, br, bl. Para gradientes radial/cônico (v3.3+) use bg-gradient-radial (requer plugin ou valor arbitrário).

tailwind
<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>

Cores Personalizadas e Arbitrárias

Valores arbitrários entre colchetes permitem usar qualquer cor CSS sem editar a config — ótimo para casos pontuais. Para cores usadas repetidamente, defina-as em theme.extend.colors para que tenham suporte a modificadores de opacidade e nomenclatura consistente.

tailwind
<!-- 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>

Visão Geral da Paleta de Cores

A paleta do Tailwind substitui o genérico 'gray' por quatro famílias neutras: slate (azul frio), gray, zinc, neutral e stone (quente). Escolha uma para o projeto inteiro, para neutros consistentes. Cada cor tem 11 tonalidades (50, 100, ..., 950).

tailwind
<!-- 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-*. -->
03

Tipografia

Tamanho e Peso da Fonte

text-{tamanho} mapeia para uma escala baseada em rem (text-base = 1rem). font-{peso} cobre 100-900. Valores arbitrários como text-[42px] também funcionam. A altura de linha escala automaticamente com o tamanho do texto, a menos que você sobrescreva com leading-*.

tailwind
<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>

Altura de Linha e Espaçamento de Letras

leading-* define a altura de linha (numérico = rem, nomeado = relativo). tracking-* define o espaçamento entre letras. Combine uppercase + tracking-wider + text-xs para rótulos estilo small-caps e eyebrows — um idioma Tailwind muito comum.

tailwind
<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>

Alinhamento e Decoração de Texto

text-{left,center,right,justify} alinha o conteúdo inline. underline/line-through/no-underline alternam o text-decoration; decoration-{1-4} define a espessura, underline-offset-{n} a posição. O padrão hover:underline é o padrão para links de navegação.

tailwind
<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>

Família de Fontes e Fontes Arbitrárias

Três pilhas de fontes vêm por padrão: sans (system UI), serif, mono. Adicione mais em theme.extend.fontFamily (ex.: display, body). Para fontes arbitrárias pontuais use font-['Nome']. Lembre-se de importar com @import ou <link> a fonte web real no seu CSS/HTML.

tailwind
<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>

Estouro e Truncamento de Texto

truncate = overflow-hidden text-ellipsis whitespace-nowrap (uma linha + reticências). line-clamp-{1-6} limita a N linhas (usa -webkit-line-clamp). Para quebra livre, use break-words ou break-all para controlar a quebra de palavras longas.

tailwind
<!-- 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>
04

Espaçamento

Padding e Margin

Os utilitários de espaçamento usam uma única escala baseada em 4px: 1 = 0.25rem = 4px. p* / m* para cada um dos lados, px/py para pares de eixo, pt/pr/pb/pl ou mt/mr/mb/ml por lado. mx-auto centraliza elementos de bloco horizontalmente.

tailwind
<!-- 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>

A Escala de Espaçamento

Uma única escala governa padding, margin, gap, width, height e mais — essa consistência é o superpoder do Tailwind. Use valores negativos (-mt-2) para sobreposições e puxões. Valores arbitrários p-[13px] fogem da escala quando necessário, mas devem ser raros.

tailwind
<!-- 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>

Espaço entre Filhos

space-x-* / space-y-* adicionam margem entre irmãos (não ao redor) — perfeito para pilhas verticais e fileiras de badges. Atenção: space-x usa margin-left, então não combina bem com flex justify; para flex, prefira o utilitário gap-* (ver Flexbox).

tailwind
<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 -->

Largura e Altura

w-* / h-* usam a escala de espaçamento mais frações (1/2, 1/3, 2/3, 1/4...), screen/ full, e tamanhos nomeados (xs..7xl para max-width). max-w-{tamanho} limita a largura — envolva o conteúdo da página em max-w-md mx-auto para linhas de leitura confortáveis. w-fit / w-max usam dimensionamento intrínseco.

tailwind
<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 e Grid

gap-* é a forma moderna de espaçar filhos de flex/grid — substitui a abordagem antiga de margens com space-x/space-y. Defina gap para os dois eixos, ou gap-x/gap-y individualmente. Usa a mesma escala de espaçamento do padding/margin.

tailwind
<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 -->
05

Flexbox

Contêiner Flex Básico

flex define display:flex; inline-flex define display:inline-flex. flex-col troca o eixo principal para vertical — combinado com gap, é a forma mais limpa de construir pilhas verticais. A direção padrão é row (horizontal).

tailwind
<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 e Align

justify-* controla o eixo principal (horizontal em flex-row); items-* controla o eixo cruzado (vertical em flex-row). A combinação 'flex justify-center items-center' centraliza o conteúdo nos dois sentidos — o snippet Tailwind mais usado para centralizar.

tailwind
<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 e Basis

flex-1 = flex:1 1 0% (cresce para preencher, pode encolher, basis 0). flex-none = não cresce nem encolhe (fixo). flex-grow-0 / flex-shrink-0 desativam crescimento/encolhimento individualmente. basis-{n} define o tamanho inicial antes de crescer.

tailwind
<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 e Order

flex-wrap permite que os filhos fluam para novas linhas (o padrão nowrap transborda). order-{n} reordena os filhos visualmente sem mudar o DOM — order-first/last são atalhos. Útil em layouts responsivos em que você quer ordem visual diferente por breakpoint.

tailwind
<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>

Padrões de Centralização

flex items-center justify-center é o snippet canônico de centralização — funciona para qualquer tamanho de conteúdo. O padrão de rodapé fixo (min-h-screen + flex-col + flex-1 no main) empurra o rodapé para o fundo mesmo com pouco conteúdo.

tailwind
<!-- 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>
06

Grid

Grid Básico

grid define display:grid. grid-cols-{n} define uma contagem fixa de colunas (1-12). auto-rows-fr faz todas as linhas terem a mesma altura (1fr cada). gap-* funciona exatamente como no flex para espaçar as trilhas.

tailwind
<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>

Colunas Responsivas

O padrão auto-fit + minmax é um truque responsivo poderoso: as colunas têm pelo menos 200px e se esticam para preencher a linha, quebrando automaticamente — sem media queries. Combine com grid-cols-* responsivos explícitos para mais controle.

tailwind
<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 Coluna e Linha

col-span-{n} / row-span-{n} fazem um item cobrir múltiplas trilhas. col-start-{n} / col-end-{n} posicionam itens em linhas de grid explícitas. Juntos, isso permite layouts complexos estilo revista sem media queries.

tailwind
<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 via Valores Arbitrários

Valores arbitrários entre colchetes permitem qualquer sintaxe de grid-template: grid-cols-[200px_1fr_100px] cria três trilhas de largura personalizada (underscores viram espaços). grid-template-areas nomeado não é utilitário embutido — defina-o numa classe personalizada ou estruture com spans de col/row.

tailwind
<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 e Alinhamento

justify-items-* / content-* controlam como os itens se posicionam dentro das células e como as trilhas se posicionam dentro do contêiner. place-items-center é atalho para justify-items + itens em ambos os eixos. place-content-center centraliza o bloco inteiro do grid.

tailwind
<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>
07

Bordas

Largura e Cor da Borda

border define 1px em cada um dos lados; border-{2,4,8} definem a espessura. border-{t,r,b,l,x,y} miram lados específicos. border-dashed/dotted/double definem o estilo. Sempre combine com border-{cor} — a cor de borda padrão do Tailwind é gray-200 (mudou de gray-300 na v3).

tailwind
<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>

Raio da Borda

rounded-{none,sm,md,lg,xl,2xl,3xl,full} escalam o raio; rounded-full faz pílulas ou círculos perfeitos (quando largura = altura). Por canto: rounded-{tl,tr,bl,br}-{tamanho}, por lado: rounded-{t,b,l,r}-{tamanho}. Círculos de avatar usam rounded-full + w/h iguais.

tailwind
<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>

Divisórias entre Filhos

divide-{x,y} adiciona bordas entre irmãos — muito mais limpo que estilizar cada filho com border-t. divide-{cor} e divide-{largura} personalizam-nas. Combine com py/px nos filhos para espaçamento confortável em listas e tabelas.

tailwind
<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 (tipo outline)

Rings são contornos baseados em box-shadow que não afetam o layout (diferente de bordas) e se sobrepõem bem. ring-{n} define a largura, ring-{cor} a cor, ring-offset-{n} adiciona espaço em branco entre elemento e ring. O padrão focus:ring é o estilo de foco acessível padrão.

tailwind
<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 a propriedade CSS outline real (fora da caixa da borda, sem impacto no layout). Ring é o preferido no Tailwind porque é um box-shadow em camadas — vários rings podem se empilhar e ring-offset dá um intervalo limpo. Outline é útil quando você precisa explicitamente do comportamento do outline CSS.

tailwind
<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) -->
08

Fundos

Cor de Fundo e Anexação

bg-{cor} define background-color, com /{opacidade} para alfa. bg-fixed cria efeito parallax (o fundo fica parado enquanto o conteúdo rola). bg-clip-{padding,border,content} controla até onde o fundo se estende sob bordas/conteúdo.

tailwind
<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>

Imagem e Gradiente de Fundo

Use bg-[url('/caminho/para/img.jpg')] para background-image com URLs arbitrárias (coloque a URL entre aspas). bg-cover preenche o elemento mantendo a proporção; bg-contain encaixa a imagem inteira. bg-{center,top,bottom,left,right} e bg-{repeat,no-repeat,repeat-x,repeat-y} controlam o posicionamento.

tailwind
<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>

Direção e Pontos do Gradiente

from-/via-/to- definem os pontos de cor do gradiente; bg-gradient-to-{direção} define o ângulo. Direções diagonais como to-br são comuns para gradientes quentes de hero. Gradientes radial/cônicos nativos precisam de plugin ou valor arbitrário: bg-[radial-gradient(...)].

tailwind
<!-- 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>

Tamanho e Posição do Fundo

bg-cover vs bg-contain é a escolha-chave para imagens hero e logos, respectivamente. Cover preenche a caixa (corta o excedente); contain encaixa a imagem inteira (pode mostrar espaço vazio). Combine bg-cover + bg-center para a imagem hero responsiva padrão.

tailwind
<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 Mistura de Fundo

bg-blend-{modo} controla como múltiplas camadas de fundo (imagem + cor) se compõem. multiply, screen, overlay, darken, lighten são comuns. Para escurecer imagens e dar legibilidade ao texto, a abordagem mais limpa é um overlay de gradiente semitransparente por cima (exemplo da direita).

tailwind
<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>
09

Sombras

Escala de Box Shadow

A escala de sombra (sm, padrão, md, lg, xl, 2xl) dá elevação consistente em o app inteiro. shadow-inner cria sombra interna útil para poços e estados pressionados. Cards tipicamente usam shadow-md com hover:shadow-lg para efeito de elevação.

tailwind
<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 Coloridas

shadow-{cor} tinge o box shadow com uma cor (usa a mesma paleta de cores). Combinada com /{opacidade}, cria efeitos de brilho. Sombras coloridas são uma forma rápida de tornar botões e acentos mais vibrantes e com identidade.

tailwind
<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>

Padrão de Elevação no Hover

hover:shadow-{maior} combinado com transition-shadow é o padrão clássico de hover de card. Combinar com hover:-translate-y-0.5 e active:translate-y-0 dá ao botão feedback físico de clique — um polimento de interação pequeno, mas satisfatório.

tailwind
<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 CSS filter:drop-shadow(), que segue a forma real do elemento (ótimo para SVGs e PNGs com transparência), diferente do box-shadow, que sombreia só a caixa. drop-shadow-md no texto é uma alternativa mais suave ao text-shadow.

tailwind
<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 Arbitrárias e em Camadas

Para sombras fora da escala padrão, use a sintaxe de valor arbitrário shadow-[...]. Para sombras complexas em camadas (do tipo que parece realmente premium), é mais limpo defini-las uma vez numa classe CSS personalizada — as sombras de camada única do Tailwind não alcançam profundidade de múltiplas camadas.

tailwind
<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>
10

Design Responsivo

Breakpoints

O Tailwind é mobile-first: os estilos base valem em qualquer lugar, os prefixos de breakpoint valem a partir de min-width. A ordem importa — escreva classes da menor para a maior (text-sm md:text-base lg:text-lg). Os breakpoints correspondem a larguras comuns de dispositivos e são configuráveis.

tailwind
<!-- 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

O padrão flex-col md:flex-row é a espinha dorsal dos layouts responsivos: empilhado no celular, lado a lado no desktop. Combine com grid-cols-* responsivos para grids de cards. Sempre projete primeiro o layout mobile, depois melhore para cima.

tailwind
<!-- 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 e Largura Máxima

container centraliza o conteúdo com max-widths responsivos em cada breakpoint (precisa de centralização + padding adicionados manualmente). O padrão manual 'max-w-7xl mx-auto px-4 sm:px-6 lg:px-8' é o wrapper de página mais comum. Para artigos, limite em max-w-2xl/3xl para linhas de leitura confortáveis.

tailwind
<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/Esconder por Breakpoint

hidden md:block / block md:hidden é o padrão canônico para alternar elementos entre mobile e desktop (ex.: menu hambúrguer vs navegação completa). print:block aparece só na impressão. Breakpoints arbitrários como min-[1200px]: permitem mirar larguras personalizadas.

tailwind
<!-- 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>

Tipografia e Espaçamento Responsivos

Escale tipografia e espaçamento a cada breakpoint para hierarquia visual. Para tipografia realmente fluida, use clamp() via valor arbitrário: text-[clamp(2rem,5vw,4rem)] — o título cresce suavemente com o viewport entre o mínimo e o máximo.

tailwind
<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>
11

Modo Escuro

Ativar Modo Escuro (estratégia class)

Por padrão o Tailwind usa prefers-color-scheme (media). Definir darkMode:'class' permite alternar o modo escuro adicionando a classe 'dark' a um ancestral (tipicamente <html>) — necessário para seletor de tema. darkMode:'selector' (v3.4+) é parecido, mas suporta seletores personalizados.

tailwind
// 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

Prefixe qualquer utilitário com dark: para aplicá-lo só no modo escuro. O padrão é escrever o estilo claro primeiro, depois os overrides dark:. Seja sistemático: pareie cada bg-*, text-*, border-* com um equivalente dark:* para que nada pareça quebrado no modo escuro.

tailwind
<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 Alternância de Tema

Coloque este script inline no <head> antes da página renderizar para evitar o flash do tema errado (FOUC). Ele verifica o localStorage primeiro e depois cai na preferência do sistema. O botão de alternância apenas troca a classe e persiste a escolha.

tailwind
// 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';
}

Somente Preferência do Sistema

Se você não precisa de alternância manual, darkMode:'media' (o padrão) segue a configuração do sistema do usuário sem nenhum JavaScript. Mais simples, mas você perde a capacidade de sobrescrever a preferência. Use isto em sites de conteúdo, onde respeitar a escolha do sistema basta.

tailwind
// 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) -->

Boas Práticas do Modo Escuro

Um bom modo escuro não é só inversão de cores: use cinza escuro (gray-900), não preto puro, para fundos; off-white (gray-100), não branco puro, para texto; escureça levemente as imagens; e reduza ou remova sombras. Cores de marca saturadas costumam precisar ser clareadas (blue-600 -> blue-500) no modo escuro.

tailwind
<!-- 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>
12

Animações e Transições

Transições

transition-{propriedade} define quais propriedades animam; duration-{ms} define o tempo; ease-{in,out,in-out} define a curva de tempo. transition-colors é a mais comum (mais barata que transition-all). Sempre adicione transition antes da mudança hover:* ou ela vai dar um salto.

tailwind
<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>

Propriedades de Transição

Prefira transições específicas (transition-colors, transition-transform) a transition-all por desempenho — all observa toda propriedade e pode causar engasgos. duration-* usa 75/100/150/200/300/500/700/1000ms. ease-out soa natural para elementos de UI surgindo.

tailwind
<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>

Animações Embutidas

O Tailwind traz quatro animações de keyframe: spin (loader), ping (ponto de notificação expandindo), pulse (fade de opacidade — perfeito para skeleton loaders), bounce (divertida). Para animações personalizadas, defina keyframes na config e referencie via animate-[nome].

tailwind
<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-, skew- cada um se compõe e anima suavemente com transition-transform. Use origin-{center,top,bottom-left,...} para mudar a origem da transformação. Floreios de hover em card (scale + leve rotação + elevação) parecem premium quando sutis.

tailwind
<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>

Animações Personalizadas via Config

Defina keyframes e nomes de animação personalizados em theme.extend. O valor da animação é uma abreviação: '{nome} {duração} {timing} {iteração}'. Uma vez definida, animate-{nome} vira um utilitário normal. Mantenha os keyframes pequenos — eles vão no seu pacote CSS.

tailwind
// 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>
13

Formulários

Campos de Entrada

O padrão de input clássico: w-full para largura total, padding, border, rounded e um anel de foco que remove o outline padrão. focus:border-transparent esconde a borda nativa de foco; focus:ring-2 desenha um indicador de foco acessível e claro. Sempre estilize o estado desabilitado, por clareza.

tailwind
<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 e Radios

text-{cor} em checkboxes/radios define a cor do estado marcado (usa accent-color por baixo). focus:ring-* adiciona o indicador de foco por teclado. Para toggles personalizados, use o padrão peer-* com um checkbox oculto para comandar o estilo, ou um plugin como @tailwindcss/forms.

tailwind
<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 e Options

A estilização nativa de <select> é limitada entre navegadores; para controle total, use um componente de dropdown personalizado ou uma biblioteca como Headless UI. O plugin @tailwindcss/forms dá a cada um dos elementos de formulário uma base consistente e fácil de tematizar — vale instalar em qualquer app cheio de formulários.

tailwind
<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 de Formulário

space-y-4 é a forma mais limpa de espaçar as linhas de um formulário — sem margens por campo. Pareie cada input com um <label class='block text-sm font-medium mb-1'> para rótulos consistentes. Envolva em max-w-md para manter a largura do formulário legível no desktop.

tailwind
<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>

Botões

Botões merecem variantes active: (pressionado), disabled: (estado) e focus: (teclado) — não apenas hover. active:bg-{mais escuro} dá feedback físico. disabled:opacity-50 disabled:cursor-not-allowed é o tratamento padrão de desabilitado. Mantenha altura consistente (ex.: py-2) entre as variantes de botão.

tailwind
<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>
14

Cards

Card Básico

O card canônico: rounded + shadow + overflow-hidden (para que os cantos da imagem sejam recortados direito). object-cover na imagem evita distorção. hover:shadow-lg com transition-shadow dá o efeito de elevação. overflow-hidden é a chave para o topo arredondado da imagem.

tailwind
<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>

Grid de Cards

Para grids de cards, use o padrão auto-fill + minmax: cards têm pelo menos 280px e se esticam para preencher, quebrando automaticamente — sem media queries. Para contagens fixas de colunas em breakpoints conhecidos, a abordagem grid-cols-* responsiva é mais simples de raciocinar.

tailwind
<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>

Card Interativo (inteiro clicável)

Envolver o card inteiro num <a> o torna cada clicável (melhor UX que um botão 'Leia mais' separado). O padrão group + group-hover permite animar elementos filhos (a cor do título, a posição da seta) quando o pai recebe hover — poderoso para cards interativos.

tailwind
<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>

Card com Rodapé

Use flex flex-col no card e flex-1 no corpo para que o rodapé grude no fundo mesmo quando os corpos dos cards têm tamanhos diferentes — mantém uma fileira de cards alinhada. O rodapé tipicamente tem metadados e ações, com fundo sutil e borda superior.

tailwind
<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>

Card de Perfil / Avatar

Avatar + nome + ação é o padrão clássico de card em linha. Use flex items-center gap-4 para alinhá-los. Para pontos de status, use position absolute no canto inferior direito com um ring na cor do fundo do card para 'recortar' o ponto. Avatares usam rounded-full + w/h iguais + object-cover.

tailwind
<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>
16

Padrões de Layout

Position

relative + absolute é o cavalo de batalha: defina position:relative no pai e position:absolute no filho para posicioná-lo com precisão. inset-0 = top/right/bottom/left:0 (preenche o pai). sticky top-0 é essencial para cabeçalhos fixos — precisa que o pai seja alto o bastante para rolar.

tailwind
<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 e Empilhamento

O Tailwind fornece z-0/10/20/30/40/50 mais z-auto. Use uma convenção consistente: 0 = base, 10 = dropdowns, 20 = sticky, 30 = modais, 40 = overlays, 50 = toasts/tooltips. Modais precisam tanto de z-index alto QUANTO de fixed inset-0 para cobrir o viewport.

tailwind
<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 são o básico. inline-block é útil para elementos que precisam de width/height mas devem ficar em linha. hidden remove do layout por completo (vs opacity-0, que mantém o espaço). Alterne com prefixos de breakpoint para mostrar/esconder responsivamente.

tailwind
<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 o conteúdo (também usado para que cantos arredondados recortem os filhos). overflow-auto adiciona barras de rolagem só quando necessário; overflow-x-auto com whitespace-nowrap é o padrão de rolagem horizontal para fileiras de navegação e blocos de código.

tailwind
<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 e Clear

Floats foram em grande parte substituídos por flexbox/grid para layout, mas float-left + mr-4 ainda funciona bem para texto contornando imagens. Para a maioria das necessidades de dimensionamento de imagem, object-cover (preenche, pode cortar) ou object-contain (encaixa, pode dar barras) num img com dimensões definidas é a abordagem moderna.

tailwind
<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" />
17

Efeitos e Filtros

Backdrop Blur (glassmorphism)

backdrop-blur-* desfoca o que está atrás do elemento (não o próprio elemento) — combinado com um bg translúcido (bg-white/30) cria o efeito glassmorphism. Perfeito para modais, cabeçalhos fixos sobre conteúdo e painéis foscos estilo iOS.

tailwind
<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 Imagem

Os utilitários de filtro mapeiam para funções CSS filter: blur, brightness, contrast, grayscale, invert, sepia, saturate, hue-rotate. O padrão grayscale hover:grayscale-0 é um efeito popular para fotos de equipe e imagens de produto — a cor aparece no hover.

tailwind
<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 como um elemento se mistura com o que está atrás dele. mix-blend-difference em texto branco sobre uma imagem cria um efeito de alto contraste legível independentemente da imagem de fundo — popular em seções hero. Use com parcimônia; pode parecer cafonice.

tailwind
<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} (mais 5/10/20/.../95) define a opacidade do elemento — afeta o elemento E seus filhos. Para só um fundo translúcido, use bg-{cor}/{opacidade}, que mantém o texto totalmente opaco. opacity-0 esconde mas preserva o layout (vs hidden, que remove).

tailwind
<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 e User Select

Sempre combine cursor com comportamento: cursor-pointer para clicável, cursor-not-allowed para desabilitado. select-none desativa a seleção de texto (útil para cromos de UI e botões sujeitos a duplo clique). resize-none em textareas evita o controle de redimensionamento padrão quando você quer layout consistente.

tailwind
<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>
18

Transições e Transformações

Origem da Transformação e Scale

origin-* define o ponto de origem da transformação. scale-x-* / scale-y-* escalam independentemente por eixo. transform-gpu força aceleração de GPU (translate3d) para animações mais suaves — use quando notar engasgos em elementos cheios de transform, como carrosséis.

tailwind
<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 e Rotate

translate-{x,y}-{n} move o elemento usando a escala de espaçamento (ou use /2 para 50% via -translate-x-1/2). O padrão left-1/2 + -translate-x-1/2 centraliza perfeitamente um elemento absolutamente posicionado independentemente da largura — útil para tooltips e modais.

tailwind
<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 e Transforms 3D

Skew inclina um elemento ao longo de um eixo — útil para efeitos sutis de paralelogramo. Transforms 3D (perspective, rotate-y, rotate-x, transform-style-3d) precisam de extensão de tema no Tailwind padrão, mas habilitam efeitos de flip de card e parallax. A maioria dos projetos usa apenas transforms 2D.

tailwind
<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>

Delay e Timing de Transição

delay-{ms} atrasa o início de uma transição — combine com delays por filho para criar entradas escalonadas (cada item começa um pouco depois). ease-out soa natural para coisas surgindo (desacelerando até o lugar), ease-in para coisas desaparecendo (acelerando para fora).

tailwind
<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>

Hover vs Focus vs Active

Sempre considere focus (usuários de teclado) e active (clique do mouse) além do hover. focus-visible: aplica-se apenas ao foco por teclado (não ao clique do mouse) — geralmente o que você quer para anéis de foco. group + group-hover: deixa o hover do pai comandar o estilo dos filhos — essencial para cards e hovers complexos.

tailwind
<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>
19

Dimensionamento

Escala de Largura

w-* usa a escala de espaçamento mais frações (1/2, 1/3, 2/3, 1/4, 3/4, 1/5, ..., 1/12) para porcentagens. w-full = 100%, w-screen = 100vw, w-fit = largura intrínseca, w-max = max-content. Use w-full + max-w-{tamanho} para conteúdo responsivo que limita numa largura legível.

tailwind
<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>

Altura e Viewport

h-screen = 100vh, que tem problemas com a barra de endereço em navegadores móveis. Prefira h-dvh (altura de viewport dinâmica) para layouts de altura total amigáveis ao mobile — ela se ajusta conforme a barra do navegador aparece/some. min-h-screen é o padrão para layouts de rodapé fixo.

tailwind
<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} mapeia para tamanhos baseados em rem, ideais para largura de conteúdo. Envolver o conteúdo da página em max-w-7xl mx-auto é padrão. min-w-0 é um truque crítico de flexbox — permite que filhos flex encolham abaixo do tamanho intrínseco para evitar estouro.

tailwind
<!-- 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>

Proporção (Aspect Ratio)

aspect-{proporção} mantém uma proporção fixa independentemente da largura — muito mais limpo que o antigo truque de padding-bottom. aspect-video é o padrão para embeds de vídeo. Combine com object-cover para preencher a caixa sem distorção. Proporções arbitrárias como aspect-[21/9] também funcionam.

tailwind
<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 e Position

object-fit em <img> (e <video>) controla como a fonte preenche sua caixa: cover (preenche, corta), contain (encaixa, dá barras), fill (estica), none (tamanho original). Pareie com object-{posição} para controlar qual parte é mantida ao cortar. object-cover + object-center é o padrão para imagens hero.

tailwind
<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" />
20

Interatividade e Estado

Hover, Focus e Group

group torna um elemento uma fonte de estado; group-hover:* aplica um estilo a um filho quando o pai recebe hover. Crucial para cards em que o hover no card afeta imagem, título e uma ação oculta de uma vez. Grupos nomeados (group/card) permitem aninhamento.

tailwind
<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 irmãos)

peer marca um elemento como fonte de estado para seus IRMÃOS (por padrão, apenas irmãos posteriores). peer-checked:* permite estilizar irmãos com base no estado de um checkbox/radio — sustenta toggles só com CSS, botões de revelar senha e acordeões sem JavaScript.

tailwind
<!-- 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 (só teclado)

Use focus-visible: em vez de focus: para anéis de foco — mostra o anel apenas para usuários de teclado (que precisam) e esconde para cliques de mouse (que têm feedback visual próprio). Pareie com focus:outline-none para suprimir o anel padrão do navegador.

tailwind
<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 Arquivo

placeholder-* estiliza o texto do placeholder. file:* estiliza o pseudo-botão dentro de <input type='file'> — um elemento notoriamente difícil de estilizar, mas a variante file: do Tailwind o torna tratável. O padrão acima dá um botão de upload limpo e com identidade.

tailwind
<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 e Selection

marker:* estiliza bullets/números de listas. selection:* estiliza o realce quando usuários selecionam texto. first-letter:* / first-line:* permitem capitulares e primeiras linhas em small-caps — úteis para designs editoriais. Cada um desses pseudo-elementos tem variantes dedicadas no Tailwind.

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>
21

Valores Arbitrários e Personalização

Valores Arbitrários

Colchetes permitem usar qualquer valor CSS sem estender o tema — perfeito para casos pontuais. Underscores nos valores viram espaços (então grid-cols-[200px_1fr] vira '200px 1fr'). O excesso leva a design inconsistente; prefira extensão de tema para valores repetidos.

tailwind
<!-- 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>

Propriedades Arbitrárias

[propriedade:valor] define uma propriedade CSS arbitrária — útil para propriedades sem utilitários no Tailwind (mask-type, hyphens, etc.). [--var:valor] define uma variável CSS que você pode referenciar em valores arbitrários como p-[var(--tw)]. Poderoso para tematização.

tailwind
<!-- 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 Arbitrárias

Variantes arbitrárias estendem o sistema de variantes do Tailwind: min-[1200px]: para breakpoints personalizados, aria-*: para estados ARIA, odd:/even: para zebrado, has-[:checked]: para estilização relacional. A variante has-* (recurso recente do CSS) é particularmente poderosa para estilizar pais com base no estado dos filhos.

tailwind
<!-- 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>

Extensão do Tema

theme.extend acrescenta aos padrões; theme.{chave} os substitui. DEFAULT permite usar o nome base (bg-brand) mais tonalidades (bg-brand-dark). Adicione espaçamento, breakpoints, raios etc. personalizados. Estender é quase sempre o que você quer — substituir a paleta de cores remove os padrões do Tailwind.

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 e @apply

Plugins adicionam novos utilitários ou componentes (forms, typography, aspect-ratio são oficiais). @apply permite incorporar utilitários Tailwind no CSS personalizado — útil quando você tem uma classe usada identicamente em dezenas de lugares. Não abuse do @apply; a abordagem utility-first costuma ser mais limpa.

tailwind
// 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>
22

Padrões do Mundo Real

Modal / Dialog

Anatomia do modal: overlay fixed inset-0 (cobre o viewport), z-50 (acima de tudo), centralização flex para o painel, e o próprio painel posicionado relative para ficar acima do overlay. backdrop-blur dá um acabamento. Sempre ofereça um botão de fechar visível e ESC para fechar, por acessibilidade.

tailwind
<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 / Notificação

Toasts são fixados num canto (inferior direito é a convenção), com largura limitada e borda esquerda colorida indicando o tipo (verde=sucesso, vermelho=erro, amarelo=aviso, azul=info). Pareie com uma animação via JS (slide-in com translate-x) e auto-dismiss após alguns segundos.

tailwind
<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 e Pílula

Badges são pílulas inline-flex (rounded-full) ou rótulos (rounded). Use bg-{cor}-100 + text-{cor}-800 para o estilo pastel suave. Adicione um ponto (w-1.5 h-1.5 rounded-full) para indicadores de status. Mantenha text-xs font-medium para a escala de texto de badges.

tailwind
<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 Vazio

Estados vazios precisam de: um ícone num círculo suave, um título curto, um texto de apoio e uma CTA principal. Centralize tudo (text-center mx-auto), use padding generoso py-12 e esmaeça as cores (texto gray-400/500) para que o botão CTA chame o olhar. Não mostre só 'Sem dados'.

tailwind
<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 Carregamento

Skeleton loaders usam animate-pulse num contêiner de blocos cinzas com a forma do conteúdo real. Espelhe o layout e as proporções do estado carregado para não haver salto brusco quando os dados chegam. rounded-full + w-10 h-10 imita um avatar; larguras variadas (w-3/4, w-1/2) imitam linhas de texto.

tailwind
<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>

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.