Communitygithub.com

responsive-layout

Créez des mises en page qui fonctionnent du mobile aux grands écrans grâce à CSS Grid, Flexbox, les conteneurs de requêtes et le dimensionnement fluide. Idéal pour corriger les sites qui « cassent sur mobile », les grilles responsives, les bento grids, les menus mobiles, les débordements horizontaux ou toute section multi-colonnes.

Qu'est-ce que responsive-layout ?

Ce skill permet de construire des mises en page responsives robustes en utilisant une approche mobile-first avec CSS Grid, Flexbox, les conteneurs de requêtes et le dimensionnement fluide. Il fournit des motifs éprouvés comme la grille de cartes sans points de rupture, la section partagée texte/média, la grille bento, la barre latérale collante et le menu mobile. Le skill insiste sur l'utilisation de breakpoints uniquement là où le contenu « casse », plutôt que de fixer des largeurs arbitraires, ce qui réduit les bugs liés à l'approche desktop-first. Il inclut également des techniques pour le débogage des débordements horizontaux (via une commande console), la gestion du viewport mobile (svh/dvh, safe-area-inset) et l'accessibilité tactile (taille minimale des cibles). Adapté aux agents comme Claude Code, Cursor ou Codex, ce skill est utile chaque fois qu'un développeur doit corriger un site qui ne s'affiche pas correctement sur mobile, créer une grille responsive, un bento layout, un menu mobile, ou remédier à un défilement horizontal ou à un overflow.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Mise en page responsive

Écrivez la mise en page pour qu'elle s'adapte d'elle-même, puis ajoutez des points de rupture uniquement là où le contenu casse réellement. Les mises en page conçues d'abord pour le desktop et rafistolées vers le bas sont la source de la plupart des bugs mobiles.

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

Motifs

Grille de cartes sans points de rupture

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

min(100%, 18rem) empêche le débordement quand le conteneur est plus étroit que le minimum. Utilisez auto-fill si une dernière ligne courte ne doit pas s'étirer.

Section partagée (texte et 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; } }

Sur mobile, décidez délibérément quel élément vient en premier ; généralement le texte, sauf si l'image est le message.

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

Les étendues de chaque ligne doivent correspondre au nombre de colonnes, sinon des espaces apparaissent. Esquissez les lignes avant d'écrire les classes.

Barre latérale collante à côté d'un long contenu (FAQ, article)

.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 échoue silencieusement si un ancêtre a overflow: hidden ou auto. Utilisez overflow: clip sur les ancêtres à la place.

En-tête et menu mobile

  • Desktop : logo, navigation en ligne, CTA. Réduisez à un bouton de menu lorsque la navigation ne tient plus, pas à une largeur arbitraire.
  • Le bouton de menu est un vrai <button aria-expanded aria-controls>. Le panneau capture le focus lorsqu'il est ouvert, se ferme avec Échap et restore le focus sur le bouton.
  • Verrouillez le défilement de l'arrière-plan quand le menu est ouvert (overflow: hidden sur html) et tenez compte de la largeur de la barre de défilement pour éviter un saut de mise en page.
  • Les sous-menus s'ouvrent au clic sur les appareils tactiles ; le survol seul est inaccessible.

Réactivité au niveau du composant

Lorsqu'une carte apparaît à la fois dans une large grille et une étroite barre latérale, utilisez les conteneurs de requêtes pour que la carte réagisse à sa propre largeur :

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

Points de rupture

Utilisez em pour qu'ils respectent le zoom de l'utilisateur. Jeu suggéré : 36em (576px), 48em (768px), 62em (992px), 75em (1200px). N'en ajoutez un que lorsque vous pouvez nommer ce qui casse sans lui.

Chasse au débordement

Le défilement horizontal sur mobile est presque toujours dû à l'un des éléments suivants :

  1. Une width fixe en px sur un élément ou une image.
  2. 100vw sur quelque chose à l'intérieur d'un parent avec padding (utilisez 100%).
  3. Un texte long sans coupure comme des URL ou des e-mails : overflow-wrap: anywhere.
  4. Un enfant flex qui ne se réduit pas : ajoutez min-width: 0.
  5. Une piste de grille avec minmax(20rem, 1fr) sur un écran de 320px : enveloppez le minimum dans min(100%, …).
  6. Une décoration positionnée en absolu en dehors de la fenêtre : découpez la section avec overflow: clip.
  7. Des marges négatives sur une ligne pleine largeur.

Pour trouver le coupable, exécutez ceci dans la console :

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

Détails tactiles et de la fenêtre

  • Cibles tactiles d'au moins 44 par 44 px avec 8 px entre elles.
  • Utilisez svh/dvh au lieu de vh pour les sections pleine hauteur afin que les barres du navigateur mobile ne coupent pas le contenu.
  • Champs de saisie avec une taille de police de 16 px ou plus ; plus petite fait zoomer iOS au focus.
  • Respectez les encoches : padding-inline: max(var(--gutter), env(safe-area-inset-left)).

Largeurs de test

320, 390, 768, 1024, 1440 et 1920. Testez également à 200 % de zoom du navigateur et avec une longue chaîne traduite dans la navigation.

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 associés