GSAP Best Practices

Rule routing

Load the smallest relevant set:

• Read AGENTS.md for broad GSAP reviews, unclear tasks, or when you need the compact checklist.
• Read rules/gsap-core.md for tweens, eases, staggers, transform aliases, matchMedia, defaults, or immediateRender.
• Read rules/gsap-timelines.md for sequencing, labels, position parameters, nested timelines, or playback control.
• Read rules/gsap-scrolltrigger.md for scroll animation, ScrollTrigger, pinning, scrub, snap, batch, scroller proxies, refresh, or horizontal scroll.
• Read rules/gsap-plugins.md for plugin registration or plugin APIs such as Flip, Draggable, Observer, SplitText, ScrambleText, DrawSVG, MorphSVG, MotionPath, ScrollTo, ScrollSmoother, or GSDevTools.
• Read rules/gsap-utils.md for gsap.utils, value mapping, clamp, mapRange, normalize, random, snap, distribute, toArray, selector, pipe, wrap, or units.
• Read rules/gsap-performance.md for jank, FPS, layout thrashing, many elements, quickTo, quickSetter, will-change, reduced motion, or animation cleanup/performance.

For React or Next.js, load the smallest matching React rules: