Communitygithub.com

diseño-responsivo

Crea diseños de página que funcionan desde teléfonos hasta escritorios anchos usando CSS grid, flexbox, consultas de contenedor y dimensionamiento fluido, incluyendo cuadrículas de tarjetas, tramas bento, secciones divididas, barras laterales fijas y navegación colapsable. Úsalo cuando alguien dice que su sitio "se rompe en móvil", pide una cuadrícula responsiva, un diseño bento, un menú móvil, corregir desplazamiento horizontal o desbordamiento, o está diseñando cualquier sección de varias columnas.

¿Qué es diseño-responsivo?

Esta habilidad proporciona un conjunto completo de patrones CSS y mejores prácticas para construir diseños web responsivos que se adaptan elegantemente desde pantallas de teléfono hasta escritorios amplios. Prioriza un enfoque "mobile-first" o "intrínsecamente responsivo", utilizando técnicas modernas como CSS Grid, Flexbox, consultas de contenedor y dimensionamiento fluido (`clamp()`, `min()`, `max()`), y solo añadiendo puntos de interrupción (en `em`) donde el contenido realmente se rompe. La habilidad incluye patrones probados para cuadrículas de tarjetas, tramas bento, secciones divididas con texto e imagen, barras laterales fijas, menús móviles accesibles y corrección de desbordamiento horizontal. Es compatible con cualquier proyecto web (sitios, aplicaciones, portales) y guía al usuario en la resolución de problemas comunes como el scroll horizontal no deseado, el zoom de iOS en inputs, y el respeto de las áreas seguras (notch) en dispositivos modernos, incluyendo incluso un script de consola para encontrar el elemento culpable del desbordamiento.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Diseño responsivo

Escribe el diseño para que se adapte por sí solo, luego añade puntos de interrupción solo donde el contenido realmente se rompa. Los diseños hechos primero para escritorio y parcheados hacia abajo son la fuente de la mayoría de los errores en móvil.

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)); }

Patrones

Cuadrícula de tarjetas sin puntos de interrupción

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

min(100%, 18rem) evita el desbordamiento cuando el contenedor es más estrecho que el mínimo. Usa auto-fill si una última fila corta no debe estirarse.

Sección dividida (texto y medios)

.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; } }

En móvil decide deliberadamente qué va primero; normalmente el texto, a menos que la imagen sea el mensaje.

Cuadrícula 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; } }

Los spans de cada fila deben sumar el número de columnas o aparecerán huecos. Dibuja las filas antes de escribir las clases.

Barra lateral fija junto a contenido largo (FAQ, artículo)

.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 falla silenciosamente si algún ancestro tiene overflow: hidden o auto. Usa overflow: clip en los ancestros en su lugar.

Cabecera y menú móvil

  • Escritorio: logo, navegación en línea, CTA. Colapsa a un botón de menú cuando la navegación ya no cabe, no a un ancho arbitrario.
  • El botón de menú es un <button aria-expanded aria-controls> real. El panel atrapa el foco mientras esté abierto, cierra con Escape y restaura el foco al botón.
  • Bloquea el desplazamiento del fondo mientras está abierto (overflow: hidden en html) y contempla el ancho de la barra de desplazamiento para evitar un salto en el diseño.
  • Los menús desplegables se abren al hacer clic en dispositivos táctiles; el hover solo es inalcanzable.

Capacidad de respuesta a nivel de componente

Cuando una tarjeta aparece tanto en una cuadrícula ancha como en una barra lateral estrecha, usa consultas de contenedor para que la tarjeta responda a su propio ancho:

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

Puntos de interrupción

Usa em para que respeten el zoom del usuario. Conjunto sugerido: 36em (576px), 48em (768px), 62em (992px), 75em (1200px). Añade uno solo cuando puedas nombrar qué se rompe sin él.

Caza de desbordamiento

El desplazamiento horizontal en móvil casi siempre es una de estas causas:

  1. Un width fijo en píxeles en un elemento o imagen.
  2. 100vw en algo dentro de un padre con padding (usa 100%).
  3. Texto largo sin separación, como URL o correos: overflow-wrap: anywhere.
  4. Un hijo de flex que no se encoge: añade min-width: 0.
  5. Una pista de grid con minmax(20rem, 1fr) en una pantalla de 320px: envuelve el mínimo en min(100%, …).
  6. Una decoración con posición absoluta fuera del viewport: recorta la sección con overflow: clip.
  7. Márgenes negativos en una fila de ancho completo.

Para encontrar al culpable, ejecuta esto en la consola:

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

Detalles de interacción táctil y viewport

  • Objetivos táctiles de al menos 44x44 píxeles con 8px entre ellos.
  • Usa svh/dvh en lugar de vh para secciones de altura completa, así las barras del navegador móvil no cortan el contenido.
  • Inputs con un tamaño de fuente de 16px o mayor; más pequeño hace que iOS haga zoom al enfocar.
  • Respeta los notch: padding-inline: max(var(--gutter), env(safe-area-inset-left)).

Anchuras de prueba

320, 390, 768, 1024, 1440 y 1920. También prueba con zoom del navegador al 200% y con una cadena traducida larga en la navegación.

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.

Skills relacionados