Beta v1.0.5 — Active Development
Documentation

ANIMATE GSAP
EASELY.JS

Easely.js is a simple tool designed to help you add professional animations to your website without writing complex JavaScript.

Scroll to Learn
Step 01

🛠️ Add it to your site

Copy and paste these lines into your HTML file just before the closing </body> tag.

"Perfect for personal portfolios and freelance projects."
<!-- 1. Load GSAP & ScrollTrigger (Required) -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>

<!-- 2. Load Easely.js v1.0.5 -->
<script src="https://cdn.jsdelivr.net/npm/@pstarz7/easely@1.0.5/dist/easely.umd.js"></script>

<!-- 3. Initialize the Magic -->
<script>
  window.addEventListener('load', () => {
    Easely.init({
      duration: 1.5,
      ease: "power4.out"
    });
  });
</script>
The Presets

Pick your "Movement"

Live demonstration of looping presets.

fade

Smoothly fades in from 0% to 100% opacity.

blur-up

Starts blurry and clear up (Premium aesthetic).

slide-up

Slides up from the bottom into position.

slide-down

Slides down from the top into position.

zoom-in

Scales up from a small size to normal.

The Control Panel

Fine-tune your motion with these attributes.

Attribute Value Description
data-ez-durationnumberAnimation length in seconds (e.g. 2)
data-ez-delaynumberWait time before start (e.g. 0.5)
data-ez-scrolltrueAnimate only when visible in viewport
data-ez-startstringTrigger position (e.g. top 80%)
data-ez-scrubnumberTie motion to scroll speed (Parallax)
data-ez-staggernumberDelay between child elements
data-ez-oncefalseRepeat animation every time you scroll

Troubleshooting

1. The Flashing Problem

Add this to your CSS to prevent elements showing before JS loads:

[data-ez] { opacity: 0; }

2. Early Triggering

Use custom start positions to move the trigger point higher:

data-ez-start="top 60%"