Communitygithub.com

layout-responsivo

Construa layouts de página que funcionam de celulares a desktops amplos usando CSS grid, flexbox, consultas de contêiner e dimensionamento fluido, incluindo grades de cartões, grades bento, seções divididas, barras laterais fixas e navegação que recolhe.

O que é layout-responsivo?

Este skill capacita agentes de IA a gerarem layouts CSS verdadeiramente responsivos, projetados para se adaptarem automaticamente a qualquer tamanho de tela, de 320px a 1920px. Em vez de depender de múltiplos breakpoints arbitrários, o foco está em técnicas como CSS Grid com `auto-fit`, `minmax()` e `min(100%, …)` para grades de cartões flexíveis, Flexbox para seções divididas e consultas de contêiner para componentes que respondem ao seu próprio espaço disponível. O skill também oferece padrões prontos para usos comuns: barras laterais fixas que ficam coladas durante a rolagem, navegação que colapsa em um menu mobile com gerenciamento de foco e bloqueio de rolagem, e grades bento responsivas com classes de span que se reorganizam em quebras específicas. Além dos padrões de layout, o skill inclui uma seção prática de "caça ao overflow" com um snippet de console para identificar o elemento culpado por barras de rolagem horizontais em mobile, e boas práticas de viewport como uso de `dvh`, `svh` e a função `env(safe-area-inset-left)` para respeitar entalhes de tela. Ele suporta qualquer plataforma de agente que execute CSS (navegadores, visualizações de componentes) e é ideal sempre que um usuário reclamar que "o site quebra no mobile" ou precisar de uma grade responsiva, layout bento, menu mobile ou correção de overflow horizontal.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/responsive-layout

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Layout responsivo

Escreva o layout para que ele se adapte sozinho; depois, adicione breakpoints apenas onde o conteúdo realmente quebra. Layouts feitos primeiro para desktop e depois "remendados" para baixo são a origem da maioria dos bugs em mobile.

Base

*, *::before, *::after { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; }
body { margin: 0; }
img, video, svg { max-width: 100%; height: auto; display: block; }

.container { width: min(100% - 2 * var(--gutter, 1.25rem), var(--container, 76rem)); margin-inline: auto; }
section { padding-block: var(--section, clamp(4rem, 3rem + 6vw, 9rem)); }

Padrões

Grade de cartões sem breakpoints

.grid { display: grid; gap: clamp(1rem, 2vw, 2rem);
  grid-template-columns: repeat(auto-fit, minmax(min(100%, 18rem), 1fr)); }

min(100%, 18rem) evita overflow quando o contêiner é mais estreito que o mínimo. Use auto-fill se uma última linha curta não deve esticar.

Seção dividida (texto e mídia)

.split { display: grid; gap: clamp(2rem, 5vw, 5rem); align-items: center; }
@media (min-width: 62em) { .split { grid-template-columns: 1.1fr 0.9fr; }
  .split--flip > :first-child { order: 2; } }

No mobile, decida deliberadamente o que vem primeiro; geralmente o texto, a menos que a imagem seja a mensagem.

Grade bento

.bento { display: grid; gap: 1rem; grid-template-columns: repeat(6, 1fr); grid-auto-rows: minmax(12rem, auto); }
.bento > .wide  { grid-column: span 4; }
.bento > .half  { grid-column: span 3; }
.bento > .third { grid-column: span 2; }
.bento > .tall  { grid-row: span 2; }
@media (max-width: 61.99em) { .bento { grid-template-columns: repeat(2, 1fr); }
  .bento > * { grid-column: span 1; grid-row: auto; } .bento > .wide { grid-column: span 2; } }
@media (max-width: 35.99em) { .bento { grid-template-columns: 1fr; } .bento > * { grid-column: auto; } }

Os spans de cada linha devem somar o número de colunas, senão aparecem lacunas. Esboce as linhas antes de escrever as classes.

Barra lateral fixa ao lado de conteúdo longo (FAQ, artigo)

.with-aside { display: grid; gap: 3rem; }
@media (min-width: 62em) { .with-aside { grid-template-columns: 22rem 1fr; align-items: start; }
  .with-aside aside { position: sticky; top: 6rem; } }

position: sticky falha silenciosamente se algum ancestral tiver overflow: hidden ou auto. Use overflow: clip nos ancestrais.

Cabeçalho e menu mobile

  • Desktop: logotipo, navegação inline, CTA. Recolher para um botão de menu quando a navegação não couber mais, não em uma largura arbitrária.
  • O botão de menu é um <button aria-expanded aria-controls> real. O painel prende o foco enquanto aberto, fecha com Escape e restaura o foco para o botão.
  • Travar a rolagem do fundo enquanto aberto (overflow: hidden no html) e compensar a largura da barra de rolagem para evitar um salto no layout.
  • Submenus abrem ao clicar em dispositivos de toque; apenas hover é inacessível.

Responsividade no nível do componente

Quando um cartão aparece tanto em uma grade larga quanto em uma barra lateral estreita, use consultas de contêiner para que o cartão responda à sua própria largura:

.card-wrap { container-type: inline-size; }
@container (min-width: 28rem) { .card { display: grid; grid-template-columns: 10rem 1fr; } }

Breakpoints

Use em para que respeitem o zoom do usuário. Conjunto sugerido: 36em (576px), 48em (768px), 62em (992px), 75em (1200px). Adicione um apenas quando puder nomear o que quebra sem ele.

Caça ao overflow

A barra de rolagem horizontal no mobile é quase sempre uma destas causas:

  1. Uma width fixa em px em um elemento ou imagem.
  2. 100vw em algo dentro de um pai com padding (use 100%).
  3. Texto longo sem quebras, como URLs ou e-mails: overflow-wrap: anywhere.
  4. Um filho flex que não encolhe: adicione min-width: 0.
  5. Uma faixa de grade com minmax(20rem, 1fr) em uma tela de 320px: envolva o mínimo em min(100%, …).
  6. Uma decoração com posicionamento absoluto fora da viewport: recorte a seção com overflow: clip.
  7. Margens negativas em uma linha de largura total.

Para encontrar o culpado, execute isto no console:

[...document.querySelectorAll("*")].filter(e => e.getBoundingClientRect().right > innerWidth + 1)

Detalhes de toque e viewport

  • Alvos de toque com pelo menos 44 por 44px e 8px entre eles.
  • Use svh/dvh em vez de vh para seções de altura total, para que as barras do navegador mobile não cortem o conteúdo.
  • Inputs com tamanho de fonte 16px ou maior; menor faz o iOS aplicar zoom no foco.
  • Respeite entalhes: padding-inline: max(var(--gutter), env(safe-area-inset-left)).

Larguras de teste

320, 390, 768, 1024, 1440 e 1920. Teste também com zoom de 200% no navegador e com uma string traduzida longa na navegação.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Habilidades Relacionadas