Communitygithub.com

brainzcode/premium-landing

Erstelle ein Premium-Mobilmenü mit Hamburger-Button, der zu einem X mutiert, einem Vollbild-Overlay-Panel mit gestaffelter Link-Einblendung, Scroll-Sperre, Fokus-Falle und Unterstützung für reduzierte Bewegung.

Was ist premium-landing?

Diese Fähigkeit beschreibt, wie man ein hochwertiges, barrierefreies mobiles Navigationsmenü entwickelt, das aus vier synchronisierten Komponenten besteht: einem Button, der seine Form ändert, einem darüber liegenden Panel, einer gesperrten Seite und einem eingeschränkten Fokus. Der Kern ist eine einzige `set(state)`-Funktion, die alle Zustandsänderungen steuert – keine verstreuten `classList.toggle()`-Aufrufe. Das Panel wird mit `visibility` und verzögertem Übergang aus- und eingeblendet, um Tastatursicherheit zu gewährleisten. Die Fähigkeit behandelt fünf häufige Fehlerquellen (Traps): den Z-Index-Konflikt zwischen Header und Panel (Trap 1), die iOS-Gummiband-Animation (Trap 2) mit `position: fixed` und Scroll-Sperre, den fehlenden Übergang bei `display: none` (Trap 3), die Performance-Probleme von `backdrop-filter` (Trap 4) und ungetestete Zustände wie Breakpoint-Änderungen oder Browser-Zoom (Trap 5). Sie enthält außerdem eine Checkliste und Anweisungen zur Reduzierung von Bewegungen (prefers-reduced-motion).

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/premium-mobile-menu

In Ihrer bevorzugten KI fragen

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

Dokumentation

Premium-Mobilmenü

Ein Mobilmenü besteht aus vier Dingen, die mit einem Boolean verbunden sind: einem Button, der seine Form ändert, einem Panel, das sich öffnet, der Seite dahinter, die stillgehalten wird, und dem Fokus, der darin eingeschlossen bleibt. Fast jedes kaputte Menü ist kaputt, weil diese vier Dinge nicht synchron sind – eines wird irgendwo anders, von etwas anderem, umgeschaltet.

Treibe alles mit einer einzigen set(state)-Funktion an. Kein classList.toggle() verstreut über Click-Handler, kein separater "Schließen"-Pfad, der die Scroll-Sperre vergisst. Eine Funktion, jedes Attribut, beide Richtungen.

Struktur

Der Header hat Vorrang vor dem Panel, und das Panel bedeckt alles andere:

.nav  { position: fixed; inset: 0 0 auto; z-index: 210 }  /* Burger lebt hier */
.menu { position: fixed; inset: 0 0 auto; z-index: 200; height: 100dvh }
<header class="nav">
  <a class="brand" href="/">silva</a>
  <button class="burger" id="menuBtn" type="button"
          aria-label="Menü öffnen" aria-expanded="false" aria-controls="menu">
    <i></i><i></i>
  </button>
</header>

<div class="menu" id="menu" role="dialog" aria-label="Menü" tabindex="-1" inert>
  <nav class="menu__nav">
    <a href="#about"><span class="menu__idx">01</span> Über uns</a>
    <a href="#work"><span class="menu__idx">02</span> Arbeiten</a>
  </nav>
  <div class="menu__foot">…</div>
</div>

Der Burger bleibt im Header und mutiert an Ort und Stelle. Er ist das Öffnungs- und das Schließ-Steuerelement, weshalb der Header über dem Panel liegen muss – siehe Falle 1.

Der Button

44×44 Ziel, 22px sichtbarer Balken. Die Balken sind absolut positioniert und mit Margins zentriert, nicht mit Transforms, damit die transform-Eigenschaft für die Mutation frei bleibt:

.burger {
  position: relative; display: grid; place-items: center;
  width: 44px; height: 44px;
  background: none; border: 0; padding: 0; cursor: pointer;
  color: currentColor;
  -webkit-tap-highlight-color: transparent;
}

.burger i {
  position: absolute; left: 50%; top: 50%;
  margin: -.75px 0 0 -11px;          /* Zentrierung lebt hier, nicht im Transform */
  width: 22px; height: 1.5px;
  background: currentColor; border-radius: 2px;
  transition: transform .45s var(--ease);
}

.burger i:first-child { transform: translateY(-4px) }
.burger i:last-child  { transform: translateY(4px)  }

html.is-menu-open .burger i:first-child { transform: rotate(45deg)  }
html.is-menu-open .burger i:last-child  { transform: rotate(-45deg) }

Beide Balken teilen sich einen Mittelpunkt, sodass eine Rotation um ±45° ein symmetrisches X ergibt – ohne zweiten Keyframe und ohne Nachjustieren. Wenn du stattdessen mit translate(-50%,-50%) zentrierst, muss jeder Mutationszustand diese Translation wiederholen, und die beiden Balken driften um ein Pixel auseinander.

Verwende zwei Balken, nicht drei. Das Drei-Balken-X benötigt, dass der mittlere verblasst, während sich die äußeren annähern, und das Verblassen ist als grauer Schleier in der Mitte des Übergangs sichtbar. Zwei Balken mutieren sauber. Wenn ein Drei-Balken-Ruhezustand nicht verhandelbar ist, animiere die äußeren Balken mit translateY + rotate und gib dem mittleren opacity eine kürzere Dauer, damit es verschwunden ist, bevor die Rotation beginnt.

Animiere niemals top/margin, um die Balken zu bewegen. Nur Transform.

Das Panel

.menu {
  position: fixed; left: 0; right: 0; top: 0;
  height: 100dvh;                      /* nicht inset:0 — siehe Falle 2 */
  z-index: 200;
  display: flex; flex-direction: column; justify-content: space-between;
  padding: clamp(96px, 24vw, 150px) var(--gutter)
           max(clamp(28px, 7vw, 52px), env(safe-area-inset-bottom));
  background: var(--black); color: var(--white);
  overflow-y: auto; overscroll-behavior: contain;

  opacity: 0; visibility: hidden; transform: translateY(-12px);
  transition: opacity .45s var(--ease),
              transform .55s var(--ease),
              visibility 0s linear .45s;   /* erst ausblenden, nachdem das Verblassen beendet ist */
}

.menu.is-open {
  opacity: 1; visibility: visible; transform: none;
  transition-delay: 0s;                    /* Verzögerung der Sichtbarkeit beim Öffnen aufheben */
}

visibility macht dies tastatursicher: Es entfernt das geschlossene Panel aus der Tab-Reihenfolge, was opacity: 0 allein nicht tut. Der verzögerte visibility-Übergang ist der ganze Trick – beim Öffnen sofort sichtbar, beim Schließen erst ausgeblendet, sobald das Einblenden abgespielt ist.

Die gestaffelte Link-Einblendung ist das, was als teuer wahrgenommen wird:

.menu__nav a {
  opacity: 0; transform: translateY(18px);
  transition: opacity .6s var(--ease), transform .6s var(--ease);
}
.menu.is-open .menu__nav a { opacity: 1; transform: none }

.menu.is-open .menu__nav a:nth-child(1) { transition-delay: .10s }
.menu.is-open .menu__nav a:nth-child(2) { transition-delay: .16s }
.menu.is-open .menu__nav a:nth-child(3) { transition-delay: .22s }
.menu.is-open .menu__nav a:nth-child(4) { transition-delay: .28s }
.menu.is-open .menu__nav a:nth-child(5) { transition-delay: .34s }

60ms Abstand. Unter ~40ms wirkt es wie ein Block; über ~90ms fühlt sich das letzte Element zu spät an. Für eine Liste unbekannter Länge setze style="--i:3" auf jedes Element und verwende transition-delay: calc(.10s + var(--i) * .06s).

Beim Schließen entferne die Verzögerungen (.menu:not(.is-open) .menu__nav a { transition-delay: 0s }). Ein gestaffeltes Schließen fühlt sich langsam an – Schließen sollte sofort erfolgen.

Die Zustandsfunktion

(function () {
  var btn   = document.getElementById('menuBtn');
  var panel = document.getElementById('menu');
  var root  = document.documentElement;
  var open  = false;
  var scrollY = 0;

  var FOCUSABLE = 'a[href], button:not([disabled]), input, select, textarea,' +
                  '[tabindex]:not([tabindex="-1"])';

  // der Burger ist das Schließelement und lebt außerhalb des Panels, also gehört er in den Zyklus
  function focusables() {
    return [btn].concat([].slice.call(panel.querySelectorAll(FOCUSABLE)));
  }

  function set(state) {
    if (state === open) return;
    open = state;

    panel.classList.toggle('is-open', open);
    root.classList.toggle('is-menu-open', open);
    btn.setAttribute('aria-expanded', String(open));
    btn.setAttribute('aria-label', open ? 'Menü schließen' : 'Menü öffnen');
    if (open) panel.removeAttribute('inert');
    else      panel.setAttribute('inert', '');

    if (open) {
      scrollY = window.scrollY;
      document.body.style.position = 'fixed';
      document.body.style.top = -scrollY + 'px';
      document.body.style.left = '0';
      document.body.style.right = '0';
      panel.focus({ preventScroll: true });
    } else {
      document.body.style.position = '';
      document.body.style.top = '';
      document.body.style.left = '';
      document.body.style.right = '';
      window.scrollTo(0, scrollY);
      btn.focus({ preventScroll: true });
    }
  }

  btn.addEventListener('click', function () { set(!open); });

  panel.querySelectorAll('a').forEach(function (a) {
    a.addEventListener('click', function () { set(false); });
  });

  document.addEventListener('keydown', function (e) {
    if (!open) return;
    if (e.key === 'Escape') { set(false); return; }
    if (e.key !== 'Tab') return;

    var list  = focusables();
    var first = list[0];
    var last  = list[list.length - 1];
    if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
    else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
  });

  // Das Überschreiten des Breakpoints darf die Seite nicht in einem gesperrten Zustand zurücklassen
  matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
    if (e.matches) set(false);
  });
})();

inert ersetzt hier aria-hidden. Setze niemals aria-hidden="true" auf ein Panel, das Fokus halten kann – wenn der Fokus darin ist, hast du das fokussierte Element aus dem Barrierefreiheitsbaum ausgeblendet, was ein Autorenfehler ist, den Screenreader schlecht handhaben. inert blockiert den Fokus und blendet gleichzeitig aus dem Baum aus.

Beachte das role="dialog" ohne aria-modal="true". aria-modal teilt assistiven Technologien mit, alles außerhalb des Dialogs zu ignorieren, und der Schließen-Button befindet sich außerhalb. Lasse entweder aria-modal weg (wie oben) oder füge einen echten Schließen-Button innerhalb des Panels ein.

Falle 1 – Der Header muss Vorrang vor dem Panel haben

Der Burger mutiert zum X, also muss er anklickbar bleiben, während das Panel geöffnet ist. Wenn der z-index des Panels höher ist als der des Headers, wird das X zwar gerendert (es wird im Header gemalt), aber jeder Klick landet auf dem Overlay. Das Menü wird zu einer Falle ohne sichtbaren Ausweg – gemeldet als "der Schließen-Button tut nichts."

Gib dem Header einen höheren z-index als dem Panel und überprüfe beide gegen jede andere fixierte Ebene auf der Seite (Cookie-Banner und sticky CTAs sind die üblichen Kollisionen). Ein funktionierender Satz: Panel 200, Header 210, Toasts 9000.

Fixierte Elemente stapeln sich nur gegeneinander, wenn sie denselben Stacking-Kontext teilen. Ein transform, filter, opacity < 1 oder will-change auf einem Vorfahren erstellt einen neuen und weist den gesamten Vergleich leise neu zu.

Falle 2 – overflow: hidden auf dem Body hält iOS nicht

document.body.style.overflow = 'hidden' sperrt Desktop-Browser und tut nichts gegen einen Touch-Drag auf iOS Safari. Die Seite federt hinter dem Panel zurück, und beim Loslassen befindet sich der Benutzer woanders völlig.

Die Sperre, die funktioniert, besteht darin, den Body zu fixieren und den Offset wiederherzustellen – genau das, was set() oben tut. Zwei Details, die damit einhergehen:

  • overscroll-behavior: contain auf dem Panel verhindert, dass das eigene Scrollen des Panels auf die Seite übergreift, wenn ein Ende erreicht wird.
  • Stelle mit window.scrollTo(0, scrollY) im selben Aufruf wieder her, der position löscht. Das Lesen von scrollY, nachdem der Body freigegeben ist, ergibt 0.

Wenn dein Header position: sticky statt fixed ist, zerbricht diese Sperre ihn. Ein fixierter Body hat keinen Scrollport, also löst sich sticky gegen das Dokument auf und der Header springt an den oberen Rand der Seite – außerhalb des Bildschirms, und der Burger ist weg. Schalte ihn auf fixed, während das Menü geöffnet ist (html.is-menu-open .nav { position: fixed; top: 0 }). Der Skill lenis-smooth-scroll deckt denselben Fehler von der Lenis-Seite ab; wenn diese Bibliothek auf der Seite ist, verwende lenis.stop() anstelle einer zweiten Sperre, statt beide zu stapeln.

Teste die Sperre bei einem Offset ungleich Null. Bei Scroll-Position 0 ist eine defekte Sperre pixelidentisch mit einer funktionierenden. Scrolle auf ~1200, öffne, ziehe, schließe: Die Position muss während des gesamten Vorgangs 1200 sein.

Falle 3 – display: none kann nicht übergehen

Das Umschalten von display überspringt die Animation vollständig: Das Panel erscheint und verschwindet abrupt. Das visibility + verzögerter Übergangsmuster oben ist die Version, die überall funktioniert.

Das moderne Äquivalent, wenn du bereit bist, eine Basis von 2024+ zu verlangen:

.menu { display: none; opacity: 0;
        transition: opacity .45s var(--ease), display .45s allow-discrete }
.menu.is-open { display: flex; opacity: 1 }
@starting-style { .menu.is-open { opacity: 0 } }

@starting-style ist erforderlich – ohne es hat der Eintritt keinen Startwert und nur der Austritt wird animiert.

Falle 4 – Das Panel ist der falsche Ort für einen Hintergrundunschärfe

backdrop-filter auf einem Vollbild-Panel tastet alles dahinter in jedem Frame neu ab, und auf Mittelklasse-Android-Geräten sinkt die Eintrittsanimation auf einstellige fps. Bei einem Build reduzierte das Entfernen einer Vollbild-Blend/Blur die Anzahl der verworfenen Frames von 34 % auf 3 %.

Ein Premium-Menü ist fast immer ein undurchsichtiges, markenfarbenes Panel, kein Milchglas. Wenn das Design Glas vorsieht, verwische ein kleines Element (ein Blatt, das einen Teil des Bildschirms abdeckt), niemals den gesamten Viewport, und siehe den Skill liquid-glass.

Falle 5 – Die Zustände, die niemand testet

  • Größenänderung über den Breakpoint hinweg, während es geöffnet ist. Oben behandelt mit matchMedia, nicht einem resize-Listener, sodass es nur einmal beim Überschreiten ausgelöst wird, statt bei jedem Frame eines Drags.
  • Clientseitige Routenänderung. In Next/Astro/SPA-Navigation überlebt das Panel die Navigation. Rufe set(false) beim Router-Ereignis auf und bereinige die Body-Stile beim Unmount.
  • Zurück-Button nach dem Öffnen. Wenn du einen History-Eintrag hinzufügst, wenn das Menü geöffnet wird, muss der Zurück-Button es schließen, anstatt die Seite zu verlassen.
  • Zoom auf 200 %. Das Panel muss scrollen, anstatt seinen Footer abzuschneiden.
  • Querformat-Telefon. 100dvh mit einem scrollbaren Panel handhabt es; eine vertikal zentrierte justify-content: center-Liste nicht.

Reduzierte Bewegung

@media (prefers-reduced-motion: reduce) {
  .menu, .menu__nav a, .burger i {
    transition-duration: .01ms !important;
    transition-delay: 0s !important;
  }
}

Behalte die Zustandsänderungen, entferne die Choreografie. Das Panel muss immer noch erscheinen und verschwinden.

Was es als Premium lesen lässt

Die obigen Mechaniken sind die Grundvoraussetzung. Dies sind die Entscheidungen, die es von einer Bootstrap-Drawer unterscheiden:

  • Easing. cubic-bezier(.16, 1, .3, 1) (expo-out) auf dem Panel und den Links. Schneller Start, langes Ausklingen. Niemals ease oder linear.
  • Timing. Panel 450–600 ms, Links 600 ms bei einem 60-ms-Staffelung, Burger-Morph 450 ms. Unter 300 ms wird nichts als Bewegung registriert; über 700 ms wirkt es träge.
  • Schrift. Die Linkliste ist das Design. clamp(1.65rem, 8.4vw, 2.9rem), Schriftstärke 300, line-height: 1, Großbuchstaben, enge Laufweite. Haarlinien zwischen den Zeilen.
  • Indexzahlen. 01 / 02 / 03 in kleiner Mono- oder Buchstabenabstand-Kapitälchen vor jeder Bezeichnung, in einer gedämpften Farbe gesetzt. Günstig hinzuzufügen, tut mehr für die wahrgenommene Qualität als jeder Effekt.
  • Vollzeilen-Klickbereiche. Vertikales Padding von clamp(14px, 3.4vw, 22px) auf dem Anker selbst, nicht ein Margin darum herum, sodass die gesamte Zeile tippbar ist.
  • Ein :active-Zustand, nicht ein :hover-Zustand. Telefone haben keinen Hover, und ein Hover-Stil, der nach einem Tippen hängen bleibt, sieht kaputt aus.
  • Ein Footer-Block – Kontaktzeile, Socials, ein einzelner Pill-CTA – fixiert durch justify-content: space-between. Leerer unterer Raum lässt ein Menü wie einen Platzhalter wirken.
  • Kein Bounce oder Springen auf dem Panel selbst. Überschwingen auf einer Vollbild-Oberfläche wirkt billig. Hebe dir Spring-Easing für kleine Elemente auf.

Checkliste

  • Eine set(state)-Funktion besitzt Klasse, aria-expanded, Label, inert und Scroll-Sperre
  • Der Header z-index liegt über dem des Panels, verifiziert gegen jedes andere fixierte Element

…

[gekürzt zur Übersetzung]

Individual skills in this repo

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

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

Verwandte Skills