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.
<!-- 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.
# 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 --watchDiretivas 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.
/* 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.
<!-- 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.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: [],
};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).
<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.
<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).
<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.
<!-- 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 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-*. -->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-*.
<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.
<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.
<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.
<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.
<!-- 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>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.
<!-- 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.
<!-- 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).
<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.
<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.
<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
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).
<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.
<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.
<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.
<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.
<!-- 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 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.
<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.
<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.
<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.
<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.
<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>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).
<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.
<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.
<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.
<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.
<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) -->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.
<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.
<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(...)].
<!-- 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.
<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).
<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
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.
<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.
<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.
<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.
<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.
<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>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.
<!-- 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.
<!-- 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.
<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.
<!-- 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.
<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 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.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.
<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.
// 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.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.
<!-- 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>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.
<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.
<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].
<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.
<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.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>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.
<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.
<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.
<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.
<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.
<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>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.
<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.
<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.
<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.
<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.
<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>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.
<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.
<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.
<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.
<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.
<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" />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.
<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.
<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.
<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).
<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.
<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>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.
<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.
<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.
<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).
<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.
<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>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.
<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.
<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.
<!-- 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.
<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.
<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" />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.
<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.
<!-- 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.
<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.
<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.
<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 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.
<!-- 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.
<!-- 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.
<!-- 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.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.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>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.
<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.
<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.
<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'.
<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.
<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>Snippets 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?