Communitygithub.com

Responsives Layout

Erstelle Seitenlayouts, die von Smartphones bis zu breiten Desktops funktionieren – mit CSS Grid, Flexbox, Container Queries und fließenden Größen. Nutze dies immer, wenn jemand sagt, die Seite „geht auf mobilen Geräten kaputt“, ein responsives Raster, ein Bento-Layout, ein mobiles Menü, die Behebung von horizontalem Scrollen oder Überlauf benötigt, oder wenn ein mehrspaltiger Abschnitt erstellt werden soll.

Was ist Responsives Layout?

Dieses Skill hilft Entwicklern, **robuste responsive Layouts** zu erstellen, die sich ohne harte Breakpoints an jeden Viewport anpassen. Es verwendet moderne CSS-Features wie `auto-fit`/`minmax()` für selbstanpassende Grids, Container Queries für komponenteninterne Reaktionsfähigkeit und `clamp()` für fließende Typografie und Abstände. Der Schwerpunkt liegt auf dem Aufbau basierend auf Inhalten statt auf festen Gerätebreiten – Layouts werden zuerst mobilfreundlich gestaltet und nur dort mit Breakpoints versehen, wo der Inhalt tatsächlich umbricht. Das Skill enthält sofort einsetzbare Code-Muster für Kartenraster, Bento-Raster, geteilte Abschnitte, klebrige Sidebars und mobile Menüs sowie eine systematische Anleitung zur Fehlersuche bei horizontalem Überlauf und Details zur Touchscreen-Optimierung. Es ist plattformunabhängig und kann mit jedem modernen CSS-Workflow (wie Claude Code, Cursor, VS Code, Codex) verwendet werden, die CSS generieren. Das Skill ist ideal für Entwickler, die typische Breakpoint-Fehler vermeiden und wartbare, performante Layouts schreiben möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Responsives Layout?

Schreibe das Layout so, dass es sich selbstständig anpasst, und füge Breakpoints nur dort hinzu, wo der Inhalt tatsächlich umbricht. Die meisten mobilen Fehler entstehen durch Layouts, die zuerst für den Desktop entwickelt und dann nach unten geflickt werden.

Basis

*, *::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)); }

Muster

Kartenraster ohne Breakpoints

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

min(100%, 18rem) verhindert Überlauf, wenn der Container schmaler als das Minimum ist. Verwende stattdessen auto-fill, wenn eine kurze letzte Zeile nicht gedehnt werden soll.

Geteilter Abschnitt (Text und Medien)

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

Auf mobilen Geräten bewusst entscheiden, was zuerst kommt; normalerweise Text, es sei denn, das Bild ist die Botschaft.

Bento-Raster

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

Die Spannen jeder Zeile müssen zur Spaltenanzahl addieren, sonst entstehen Lücken. Skizziere die Zeilen, bevor du Klassen schreibst.

Klebrige Sidebar neben langem Inhalt (FAQ, Artikel)

.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 schlägt stillschweigend fehl, wenn ein Vorfahre overflow: hidden oder auto hat. Verwende stattdessen overflow: clip bei Vorfahren.

Kopfzeile und mobiles Menü

  • Desktop: Logo, Inline-Navigation, CTA. Auf eine Menüschaltfläche reduzieren, wenn die Navigation nicht mehr passt, nicht bei einer willkürlichen Breite.
  • Die Menüschaltfläche ist ein echtes <button aria-expanded aria-controls>. Das Panel fängt den Fokus ein, während es geöffnet ist, schließt bei Escape und stellt den Fokus wieder auf die Schaltfläche.
  • Hintergrundscrollen während des Öffnens sperren (overflow: hidden auf html) und die Scrollleistenbreite berücksichtigen, um einen Layoutsprung zu vermeiden.
  • Dropdowns öffnen bei Klick auf Touch-Geräten; Hover allein ist nicht erreichbar.

Komponentenbasierte Reaktionsfähigkeit

Wenn eine Karte sowohl in einem breiten Raster als auch in einer schmalen Sidebar vorkommt, verwende Container Queries, damit die Karte auf ihre eigene Breite reagiert:

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

Breakpoints

Verwende em, damit sie den Benutzer-Zoom respektieren. Vorgeschlagene Werte: 36em (576px), 48em (768px), 62em (992px), 75em (1200px). Füge einen nur hinzu, wenn du benennen kannst, was ohne ihn kaputtgeht.

Überlaufjagd

Horizontaler Scroll auf mobilen Geräten wird fast immer durch eines dieser Probleme verursacht:

  1. Eine feste width in px bei einem Element oder Bild.
  2. 100vw bei etwas innerhalb eines gepolsterten Elterncontainers (verwende 100%).
  3. Langer, ungebrochener Text wie URLs oder E-Mails: overflow-wrap: anywhere.
  4. Ein Flex-Kind, das nicht schrumpft: füge min-width: 0 hinzu.
  5. Eine Grid-Spur mit minmax(20rem, 1fr) auf einem 320px-Bildschirm: umschließe das Minimum mit min(100%, …).
  6. Eine absolut positionierte Dekoration außerhalb des Viewports: schneide den Abschnitt mit overflow: clip zu.
  7. Negative Ränder bei einer vollbreiten Zeile.

Um den Übeltäter zu finden, führe dies in der Konsole aus:

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

Touch- und Viewport-Details

  • Tippziele mindestens 44 x 44 Pixel mit 8 Pixel Abstand dazwischen.
  • Verwende svh/dvh anstelle von vh für vollhohe Abschnitte, damit mobile Browserleisten keinen Inhalt abschneiden.
  • Eingabefelder mit Schriftgröße 16 Pixel oder größer; kleinere Größen veranlassen iOS zum Zoomen bei Fokus.
  • Notch respektieren: padding-inline: max(var(--gutter), env(safe-area-inset-left)).

Testbreiten

320, 390, 768, 1024, 1440 und 1920. Teste auch bei 200% Browser-Zoom und mit einer langen übersetzten Zeichenfolge in der 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.

Verwandte Skills