Communitygithub.com

gsap-motion

GSAP 3-Architektur für Premium-Websites – Plugin-Registry (ScrollTrigger, SplitText, Flip, Observer, Draggable, Inertia, CustomEase, MorphSVG, DrawSVG – alle kostenlos im öffentlichen gsap-Paket), React-Integration mit useGSAP-Scoping und -Bereinigung, gsap.matchMedia für responsive und Reduced-Motion-Zweige, Timelines, scrollgescrubbte gepinnte Sequenzen, Text-Reveals, Clip-Path/Mask-Übergänge, Flip-Layout-Morphs, horizontales Scrollen, Parallax, magnetische/Cursor-Effekte und Seitenübergänge. Verwenden Sie dies für alle GSAP- oder ScrollTrigger-Arbeiten, für scrollgesteuerte oder kinematografische Animationen und immer dann, wenn Animationen nach Routenwechseln oder Größenänderungen lecken, sich duplizieren, ruckeln oder brechen.

Was ist gsap-motion?

Dieses Skill bietet eine vollständige, produktionserprobte GSAP-3-Architektur für Premium-Websites, die auf React und moderne JavaScript-Frameworks zugeschnitten ist. Es enthält eine zentrale Plugin-Registry, die sicherstellt, dass alle GSAP-Plugins (ScrollTrigger, SplitText, Flip, Observer, Draggable, Inertia, CustomEase, MorphSVG, DrawSVG und viele mehr) genau einmal registriert werden – alle sind im kostenlosen öffentlichen gsap-Paket enthalten. Die Integration mit @gsap/react (useGSAP) gewährleistet, dass Animationen automatisch bereinigt werden, wenn Komponenten ausgehängt werden, wodurch die häufigsten Ursachen für Speicherlecks und defekte ScrollTrigger in React-Anwendungen vermieden werden. Das Skill bietet einen detaillierten Regelsatz, der 90% der GSAP-Fehler in React verhindert, darunter die Verwendung von gsap.matchMedia für Reduced-Motion-Zweige, korrekte Pin-Strategien für ScrollTrigger, das Animieren kostengünstiger CSS-Eigenschaften und das Aktualisieren von ScrollTrigger nach Layout-Änderungen. Es enthält außerdem eine umfangreiche Rezeptsammlung für Hero-Sequenzen, Text-Reveals, Clip-Path-Übergänge, horizontales Scrollen, Parallax, Drag-basierte Karussells, magnetische Buttons, Cursor-Effekte, SVG-Morphing und Seitenübergänge. Ein besonderer Fokus liegt auf zielgerichteter Animation: Jede Bewegung sollte einen Zweck (Hierarchie, Kausalität, Zustand, Markenmaterial) kommunizieren, und es gibt immer eine Alternativdarstellung für Reduced-Motion. Das Skill ist plattformunabhängig und kann mit jedem modernen Build-Tool (Vite, Next.js, Remix, Astro usw.) verwendet werden.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jakyherr05-hash/Claude-code-skill/tree/HEAD/plugins/premium-web-studio/skills/gsap-motion

In Ihrer bevorzugten KI fragen

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

Dokumentation

GSAP-Bewegungsarchitektur

Verifizierte Basis (2026-11-15)

  • [email protected] ist die neueste Version auf npm. Ihr Lizenzfeld ist "Standard 'no charge' license" (gsap.com/standard-license): kostenlos für kommerzielle Websites, einschließlich Kundenprojekten. Die einzige verbotene Nutzung ist die Entwicklung von No-Code-Animation-Builder-Tools, die mit Webflow konkurrieren. Alle Plugins werden im öffentlichen Paket ausgeliefert: ScrollTrigger, ScrollSmoother, SplitText, Flip, Observer, Draggable, InertiaPlugin, CustomEase, CustomBounce, CustomWiggle, MorphSVGPlugin, DrawSVGPlugin, MotionPathPlugin, ScrambleTextPlugin, ScrollToPlugin, Physics2D, PhysicsProps, GSDevTools und mehr.
  • @gsap/[email protected] bietet useGSAP.
  • Vor einem neuen Projekt erneut prüfen: npm view gsap version license und ls node_modules/gsap/*.js.
  • Verwenden Sie entweder ScrollSmoother oder Lenis, niemals beide. Dieser Studio-Standard verwendet Lenis (lenis-scroll Skill).

Architektur (Kopieren Sie assets/ in src/motion/)

DateiRolle
assets/registry.tsRegistriert Plugins einmal, erstellt die benutzerdefinierten Eases des Projekts, setzt Standardwerte, ScrollTrigger.config({ ignoreMobileResize: true }). Alles importiert gsap von hier.
assets/tokens.tsBewegungs-Tokens (Dauern, Eases, Staggers) gespiegelt aus ANIMATION_SPECIFICATION.md + prefersReducedMotion()
assets/lit.tsBeispiel einer wiederverwendbaren Textprimitive: SplitText mit aria:'auto', autoSplit und onSplit, der den Tween zurückgibt. Passen Sie das Reveal an die Marke an (lit, masked, slid…).
assets/useReducedMotion.tsLive-prefers-reduced-motion-Hook für DOM-Ebenen-Schalter (z. B. statische Schritte anstelle eines Pins rendern)
assets/examples/*.tsxGetestete Muster aus der Referenzdemo: gepinnte gescrubbte Sequenz (Method), Flip-Filter (ScheduleIndex), quickTo-gesteuert interaktiv (TheHour), einmalige Reveals (Rooms), Routenübergang-Vorhang (Router)

Diese Dateien sind die verifizierte Implementierung aus demo/ in diesem Repository, getestet durch seine Playwright-Suite (Bereinigung über Routen hinweg, Reduced Motion, Scroll-Synchronisation).

Regeln, die 90% der GSAP-Fehler in React verhindern

  1. Jede Animation lebt innerhalb von useGSAP(() => {...}, { scope: ref }). Der Kontext macht alle Tweens, ScrollTrigger, SplitTexts und matchMedia-Zweige beim Aushängen rückgängig. Animations-Ereignis-Handler verwenden contextSafe.
  2. Erstellen Sie ScrollTrigger niemals im Modulbereich oder in einem einfachen useEffect ohne sie rückgängig zu machen. Rufen Sie ScrollTrigger.killAll() niemals als Bereinigungsstrategie auf.
  3. Ein gsap.matchMedia() pro Abschnitt mit motion/reduce (und Desktop/Mobil-) Bedingungen. Initiale versteckte Zustände werden innerhalb des Bewegungszweigs gesetzt, sodass Benutzer ohne JavaScript und mit Reduced Motion den endgültigen Inhalt sehen.
  4. Strict Mode sicher: useGSAP behandelt React 18/19-Doppelaufrufe. Überprüfen Sie mit einem Leck-Check: ScrollTrigger.getAll().length kehrt zum Ausgangswert zurück, nachdem Sie weg- und zurücknavigiert sind.
  5. Aktualisierung nach Layout-Änderungen: nachdem Schriftarten geladen sind (document.fonts.ready.then(() => ScrollTrigger.refresh())), nach dem Filtern von Listen und nachdem Routeninhalte montiert wurden. invalidateOnRefresh: true bei jedem Trigger, dessen Werte aus dem Layout berechnet werden.
  6. Richtig pinnen: einen inneren Wrapper pinnen, pinSpacing beibehalten, ihm eine min-height: 100svh geben, die nicht von Webfonts abhängt, und anticipatePin: 1 mit Lenis verwenden. Verwenden Sie einen Pin pro Experience; gestapelte Pins verwirren Benutzer.
  7. Günstige Eigenschaften animieren: transform, opacity, clip-path; CSS-Variablen nur auf kleinen Teilbäumen. Vermeiden Sie width/height/top/left in gescrubbten Timelines und lesen Sie das Layout vor dem Schreiben (GSAP bündelt seine eigenen Schreibvorgänge).
  8. will-change nur während der Animation und nur auf wenigen Ebenen.

Rezepte

references/recipes.md enthält getestete oder dokumentierte Muster für: kinematografische Hero-Sequenz, SplitText-Reveals (Zeichen/Wörter/Zeilen, maskiert), Clip-Path- und Mask-Übergänge, gepinntes Scrub-Storytelling, horizontalen Scroll-Abschnitt (containerAnimation), Parallax-Ebenen, Flip-State-Morphs, Observer-gesteuerte Gestenabschnitte, Draggable + Inertia-Karussells, magnetische Buttons, Cursor-Follower, SVG-Morph/Draw, Bildverzerrung-Übergabe an WebGL, Seitenübergänge und 3D-Scrollen mit einer WebGL-Kamera.

references/react-lifecycle.md behandelt Routenänderungen, Größenänderungen, Inhaltsänderungen und das Debuggen von Lecks.

Checkliste für zielgerichtete Bewegung (bevor Sie animieren)

  • Was kommuniziert diese Animation (Hierarchie, Kausalität, Zustand, Markenmaterial)? Wenn nichts, löschen Sie sie.
  • Ist es der entscheidende Moment oder sollte es leise bleiben?
  • Was zeigt stattdessen Reduced Motion? (Es muss vollständig verständlich bleiben.)
  • Was ist der mobile Ausdruck? (Hover-Effekte brauchen eine Touch-Alternative; Pins werden kürzer.)
  • Wie viele ScrollTrigger erstellt die Seite? Schreiben Sie das Inventar in die Spezifikation, damit QA es überprüfen kann.

Verwandte Skills