GSAP Best Practices
Apply these rules when working on GSAP-powered animation codebases.
Current platform note
- As of March 6, 2026, official GSAP docs state that all plugins, including former Club GSAP bonus plugins, are freely available in the public package. Use the standard
gsappackage and do not recommend legacy private-registry or paid-only installation flows. Prefer GSAP3.13+when this matters.
Rule loading order
- Read
rules/gsap-core.md. - Read
rules/gsap-timelines.md. - Read
rules/gsap-scrolltrigger.md. - Read
rules/gsap-performance.md. - Use
AGENTS.mdas a compact summary plus pointer.
Enforcement policy
- Use recommendation-first language for style and performance guidance.
- Use strict language (
must/must not) only for correctness, stability, and accessibility constraints. - Prefer official GSAP docs when resolving conflicts; update these rules when docs change.