GSAP (GreenSock Animation Platform)

NOTE: This if a fork with a proper package.json config for proper modular apps.

Ultra high-performance, professional-grade animation for the modern web

GSAP is a JavaScript library for high-performance HTML5 animations that work in all major browsers. No other library delivers such advanced sequencing, reliability, API efficiency, and tight control while solving real-world problems for animators on over 3 million sites. GSAP can animate any numeric property of any JS object, not just CSS properties.

What is GSAP? (video)

Getting started video

Think of GSAP as the Swiss Army Knife of animation. It animates anything JavaScript can touch (CSS properties, canvas library objects, SVG, generic objects, whatever) and solves countless browser inconsistencies, all with blazing speed (up to 20x faster than jQuery), including automatic GPU-acceleration of transforms. See the "Why GSAP?" article for details. Most other libraries only animate CSS properties. Plus, their sequencing abilities and runtime controls pale by comparison. Simply put, GSAP is the most robust high-performance animation library on the planet, which is probably why Google recommends it for JS-based animations and every major ad network excludes it from file size calculations. Unlike monolithic frameworks that dictate how you structure your apps, GSAP is completely flexible; sprinkle it wherever you want.

This is the public repository for GreenSock's JavaScript tools like GSAP and Draggable. "GSAP" describes all of the animation-related tools which include TweenLite, TweenMax, TimelineLite, TimelineMax, various plugins (like CSSPlugin for animating CSS properties of DOM elements), extra easing functions, etc.

Resources

• GSAP home page
• Getting started guide
• Full documentation
• Community forums
• Examples & showcases
• Codepen with all bonus plugins (try them for free on codepen)
• Why GSAP? (a practical guide for developers)
• Draggable demo
• Animating SVG with GSAP
• Club GreenSock (get access to bonus plugins and tools not in this repository)
• css-tricks.com article: Myth Busting: CSS Animations vs. JavaScript
• css-tricks.com article about how GSAP solves cross-browser SVG animation challenges

CDN

Click the green "Download GSAP" button at https://greensock.com for more options. Most ad networks have it on their CDNs as well, so contact them for the appropriate URL(s).

NPM

npm install gsap

The default (main) file is TweenMax which also includes TweenLite, TimelineLite, TimelineMax, CSSPlugin, RoundPropsPlugin, BezierPlugin, AttrPlugin, DirectionalRotationPlugin, and all of the eases like Power1, Power2, Power3, Power4, Back, Bounce, Circ, Cubic, Elastic, Expo, Linear, Sine, RoughEase, SlowMo, and SteppedEase (except the CustomEase, CustomWiggle, and CustomBounce). Please make sure you're using at least version 1.19.1.

//typical import
import {TweenMax, Power2, TimelineLite} from "gsap";

//or get to the parts that aren't included inside TweenMax (works as of 1.19.1):
import Draggable from "gsap/Draggable";
import ScrollToPlugin from "gsap/ScrollToPlugin";

Get CustomEase for free

Sign up for a free GreenSock account to gain access to CustomEase, a tool that lets you create literally any ease imaginable (unlimited control points). It's in the download zip at GreenSock.com (when you're logged in).

What is Club GreenSock? (video)

Sign up anytime.

Need help?

Head over to the GreenSock forums which are an excellent resource for learning and getting questions answered. Report any bugs there too please (it's also okay to file an issue on Github if you prefer).

Copyright (c) 2008-2017, GreenSock. All rights reserved.

License: GreenSock's standard "no charge" license can be viewed at https://greensock.com/standard-license. Club GreenSock members are granted additional rights. See https://greensock.com/licensing/ for details. Why doesn't GreenSock use an MIT (or similar) open source license, and why is that a good thing? This article explains it all: https://greensock.com/why-license/