Communitygithub.com

brainzcode/premium-landing

Füge Lenis-Smooth-Scrolling korrekt zu einer Website hinzu — Einrichtung, Anchor-Offsets für Sticky-Header, Scroll-Sperre für Modals und Menüs sowie Verarbeitung von reduzierter Bewegung.

Was ist premium-landing?

Dieses Skill beschreibt die korrekte Integration der Lenis-Bibliothek für flüssiges „Smooth Scrolling“ in eine Webseite. Es löst typische Probleme, die bei der Verwendung von Lenis auftreten, wie etwa das Brechen von `position: sticky`, Konflikte mit mehrfachen Scroll-Sperren, falsche Anchor-Sprünge und die fälschliche Schuldzuweisung an Lenis für allgemeine Ruckler. Die Anleitung erklärt die Einrichtung über ein IIFE-Script, die benötigten CSS-Deklarationen und die Handhabung von `prefers-reduced-motion`, um die Zugänglichkeit zu gewährleisten. Es behandelt vier Haupt-Fallstricke: dass `overflow: clip` durch `lenis.stop()` Sticky-Elemente verschwinden lässt, dass zwei Scroll-Sperren (Lenis und `position: fixed`) sich gegenseitig aufheben, wie Anchor-Links mit Lenis funktionieren und wie man echte Performance-Probleme (z. B. durch `backdrop-filter`) misst. Das Skill eignet sich für Benutzer von Claude Code, Cursor, Codex und anderen KI-Agenten, die Website-Performance und Navigation optimieren möchten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Lenis Smooth Scroll

Lenis fängt Radeingaben ab und gleicht die native Scroll-Position weich aus. Sticky-Positionierung, IntersectionObserver und window.scrollY funktionieren weiterhin — weshalb es die richtige Wahl ist. Die Fehler kommen von Dingen, die dagegen ankämpfen, nicht von Lenis selbst.

Einrichtung

Binde die Bibliothek als lokale Datei ein, anstatt einen CDN-Link zu verwenden, damit die Seite in sich geschlossen bleibt und auch von file:// funktioniert:

curl -sSL -o assets/vendor/lenis.min.js https://unpkg.com/[email protected]/dist/lenis.min.js

Der Build dist/lenis.min.js ist ein IIFE, der globalThis.Lenis bereitstellt — funktioniert in einem einfachen <script>-Tag. (dist/lenis.mjs ist ESM und wird nicht in einem einfachen Script-Tag funktionieren.) Lade es vor deinem eigenen Script.

var reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
var lenis = null;

if (!reduced && window.Lenis) {
  var navH = parseInt(getComputedStyle(document.documentElement)
                        .getPropertyValue('--nav-h'), 10) || 0;
  lenis = new Lenis({
    duration: 1.05,
    easing: t => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
    smoothWheel: true,
    syncTouch: false,        // Touch bleibt nativ — Glättung fühlt sich auf Handys träge an
    autoRaf: true,           // Lenis hat eine eigene RAF-Schleife; kein manueller Ticker nötig
    anchors: { offset: -(navH + 10) }   // Interne Links lassen den Sticky-Header frei
  });
} else {
  // Kein Lenis — dem Browser sein eigenes Verhalten zurückgeben
  document.documentElement.style.scrollBehavior = reduced ? 'auto' : 'smooth';
}

Erforderliches CSS

html { /* KEIN scroll-behavior: smooth — es kämpft gegen Lenis */ }

html.lenis, html.lenis body { height: auto; }
.lenis:not(.lenis-autoToggle).lenis-stopped { overflow: clip; }
.lenis.lenis-smooth [data-lenis-prevent] { overscroll-behavior: contain; }
.lenis.lenis-smooth iframe { pointer-events: none; }

scroll-behavior: smooth auf html muss entfernt werden. Wenn es bleibt, animieren Anchor-Sprünge doppelt und kämpfen gegen die Glättung.

Falle 1 — overflow: clip tötet position: sticky

Das ist die Falle, die dich eine Stunde kostet.

lenis.stop() fügt .lenis-stopped hinzu, dessen CSS overflow: clip auf <html> setzt. Das entfernt den Scrollport, und position: sticky hat nichts mehr, woran es haften kann — Sticky-Elemente schnappen zurück an ihre Position im Dokument, also an den oberen Rand der Seite.

Öffnet man ein Menü bei Scroll-Position 1200, wird der Sticky-Header bei top: -1200 dargestellt. Außerhalb des Bildschirms. Zusammen mit seinem Schließen-Button. Nutzer berichten: „Der Schließen-Button ist verschwunden.“

Dasselbe passiert mit der klassischen body { position: fixed }-Scroll-Sperre, aus demselben Grund — kein Scrollport.

Lösung: Fixiere den Header für die Dauer der gesperrten Scroll-Position im Viewport.

html.menu-open .nav-wrap { position: fixed; top: 0; left: 0; right: 0; }
document.documentElement.classList.toggle('menu-open', open);

Füge die Klasse hinzu, während das Overlay noch deckend ist, damit der Wechsel von Sticky zu Fixed unsichtbar bleibt. Wende sie auf beiden Pfaden an (Lenis und reduzierte Bewegung).

Teste Overlays bei einer Scroll-Position ungleich Null. Bei Scroll-Position 0 ist ein defekter Sticky-Header pixelgenau identisch mit einem funktionierenden, sodass der Fehler vollständig versteckt bleibt. Überprüfe bei 0, ~1200 und tief in der Seite.

Falle 2 — nicht zwei Scroll-Sperren stapeln

Das Fixieren des Bodys und das Aufrufen von lenis.stop() führt zu Konflikten: position: fixed auf dem Body lässt die Seitenhöhe kollabieren, Lenis synchronisiert zurück auf 0, und beim Schließen des Overlays wird der Benutzer an den oberen Rand der Seite geworfen.

Mit Lenis hält stop() plus das eigene overflow: clip die Seite ohne den Body zu berühren — also geht die Scroll-Position nie verloren und es gibt nichts wiederherzustellen:

if (lenis) {
  open ? lenis.stop() : lenis.start();
} else if (open) {                       // nur bei reduzierter Bewegung
  scrollY = window.scrollY;
  document.body.style.position = 'fixed';
  document.body.style.top = -scrollY + 'px';
  document.body.style.width = '100%';
} else if (document.body.style.position === 'fixed') {
  document.body.style.position = '';
  document.body.style.top = '';
  document.body.style.width = '';
  window.scrollTo(0, scrollY);
}

Überprüfe: Scrolle auf 1200 → öffne → scrolle → schließe. Die Position muss bei jedem Schritt 1200 betragen, und Scrollen muss danach wieder funktionieren.

Falle 3 — Anchor-Links

Lenis steuert das Scrollen, daher sehen rohe href="#id"-Sprünge falsch aus. Verwende die eingebaute anchors-Option mit einem negativen Offset in Höhe deines Sticky-Headers oder leite Klicks manuell über lenis.scrollTo(target, { offset: -navH }).

Überprüfe die Zielposition: Der Abschnittsanfang muss auf oder unter der Unterkante des Headers liegen, nicht darunter.

Falle 4 — Lenis ist normalerweise nicht dein Ruckeln

Wenn sich das Scrollen nach dem Hinzufügen von Lenis schlecht anfühlt, messe bevor du es beschuldigst. In einem Build war das native Scrollen tatsächlich schlechter (13% verlorene Frames vs. 9%) — Lenis war in Ordnung und die eigentlichen Kosten lagen woanders:

  • ein fixiertes, vollbildgroßes mix-blend-mode-Overlay (Filmkörnung): 34% → 3% verlorene Frames allein durch Entfernen des Blend-Modus
  • backdrop-filter auf einem Sticky-Element, das bei jedem Frame jedes Scrollvorgangs auf dem Bildschirm ist
  • backdrop-filter auf großen Elementen im Allgemeinen — es wird pro Frame neu berechnet

Frame-Timing-Werkzeug

// in der Seite
window.__f = []; let l = performance.now();
const t = n => { window.__f.push(n - l); l = n; requestAnimationFrame(t); };
requestAnimationFrame(t);

Treiben Sie es mit echten Radeingaben über den verdächtigen Bereich an und melden Sie dann Mittelwert, p95 und den Prozentsatz der Frames > 33ms. Durch Versuch und Irrtum deaktivieren Sie einen Effekt nach dem anderen mit add_style_tag. Gesund ist ~16,7ms Mittelwert und 0% lange Frames; alles über ~10% lange Frames ist sichtbares Ruckeln.

Checkliste

  • scroll-behavior: smooth von html entfernt
  • Lenis-CSS-Block hinzugefügt
  • autoRaf: true (oder eine manuelle RAF-Schleife — nicht beides)
  • anchors-Offset entspricht der Höhe des Sticky-Headers
  • syncTouch: false, damit Handys natives Momentum behalten
  • Sticky-Header fixiert, während ein Overlay das Scrollen sperrt
  • Nur ein Scroll-Sperr-Mechanismus aktiv
  • Overlays bei einer von Null verschiedenen Scroll-Position getestet
  • prefers-reduced-motion überspringt Lenis und stellt natives Verhalten wieder her
  • Scroll-Position über Öffnen → Schließen erhalten
  • Frame-Timing gemessen, nicht angenommen

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

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

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

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