Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

AOS (Animate On Scroll)

by Michał Sajnóg

Small JS library that fades, slides and zooms elements in as you scroll, set with data-aos attributes in HTML.

Web animation examples and effects Code libraryOpen sourceminimal

GitHub repoWebsite
Rows of cards using AOS fade-up, zoom-in and flip-left, each card held at 0, 20, 40, 60, 80 and 100 % of its entrance so a still picture shows the motion; dashed boxes mark the final place.
Made by AgentGid with aos 2.3.4 (npm tarball, sha512 checked against the registry). MIT license; the cards and labels are our own. The frozen in-between states are only for the still picture, on a real page each card animates in 0.05 to 3 seconds.

2. Commercial use: raw.githubusercontent.com

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell”

MIT allows use in paid sites and products.

raw.githubusercontent.com

License checked Nov 5, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error

AOS: page blocks that fade in as you scroll

AOS (Animate On Scroll) is a small free script that makes parts of a page fade, slide, zoom or flip into place when the visitor scrolls to them. You or your AI assistant add one attribute to an element, such as data-aos="fade-up", and call one start function. Its last release is from 2018, so it suits simple sites more than new app projects.

Where you can use it

Landing page sections that appear on scroll

Make feature blocks, screenshots and quotes on a landing page fade or slide in as the visitor reaches them.

Cards that come in one after another

Cards that come in one after another

Let pricing cards, team photos or feature tiles appear in a short sequence instead of all at once.

Animate once, not on every pass

On long pages, show each block's entrance only the first time, so scrolling back up does not replay every effect.

Calmer pages on phones

Switch the effects off on phones or tablets, or under your own rule such as narrow screens.

Trigger from another block

Start an element's animation when a different block reaches the screen, for example a fixed button that appears with a section.

Portfolio and case-study pages Idea

Reveal project images and short captions one by one as a visitor reads down a portfolio or case-study page.

AOS (Animate On Scroll) popularity

47 / 100
Gid Score, same scale as developer tools
28,057
GitHub stars
324.9K
npm downloads, last 7 days
+14.9% in 4 weeks
6
AI-agent projects using it, from our repo scan of 4,817
AOS (Animate On Scroll): downloads per weeknpm, aos 324,927
AOS (Animate On Scroll): GitHub starsmichalsnik/aos 28,057

Downloads from api.npmjs.org, stars from GitHub, checked Nov 17, 2026. How the Gid Score is calculated

How to start

Tell your AI assistant

“Add AOS 2.3.4 (self-hosted aos.css and aos.js) to the landing page, use data-aos="fade-up" with small delays on the feature cards, call AOS.init({ once: true }) and disable it when the user prefers reduced motion.”

Or install it yourself.

npm install aos --save
Show codeStep 1 or Step 2

Start AOS once on the page.

AOS.init();

Mistakes to avoid

Following the GitHub front page (aos@next) for a project that ran npm install aos
Use the version 2 README (master branch) for aos 2.3.4, or install aos@next on purpose and pin 3.0.0-beta.6

npm install aos gives 2.3.4, while the front-page README documents the 3.0 beta (for example the mirror option and aos:in events).

Leaving the animations on for people who asked their system for less motion
Pass disable: window.matchMedia('(prefers-reduced-motion: reduce)').matches to AOS.init

Version 2.3.4 has no reduced-motion check of its own (none in its CSS or script in our demo); disable accepts any condition.

data-aos-duration="4000" or data-aos-delay="125"
Use 50 to 3000 in steps of 50, or add your own CSS rule for other values

The timing values exist only as prepared CSS rules.

<div aos="fade-up"> (attribute from old tutorials)
<div data-aos="fade-up">

The plain aos attribute stopped working in version 2.0.0.

Loading aos.css and adding data-aos without calling AOS.init()
Always call AOS.init() after the script loads

The CSS hides elements before their entrance (fade effects start at opacity 0), so without the script they stay invisible; seen in our demo files.

License

MIT license. Free for personal and paid sites, and you may change and share the code. Keep the copyright and license notice with copies of the code you ship.

Commercial use
Yes

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com

Credit
Not needed

“The above copyright notice and this permission notice shall be included in all” raw.githubusercontent.com

Inside your app or game
Can ship inside your app

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com

Pass the files on to your users
Allowed

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is AOS (Animate On Scroll) free for commercial use? The full answer Not legal advice. Check the license page before you ship.

For your agent

License rules tell your agent what it may do with AOS (Animate On Scroll). Paste them into your prompt or AGENTS.md.

License rules
- AOS (Animate On Scroll) (Web animation examples and effects, UI animation (Lottie, Rive)). Small JS library that fades, slides and zooms elements in as you scroll, set with data-aos attributes in HTML. Price: free; commercial use OK; no credit needed. Style: minimal.
  Connect: npm aos.
  Get files: npm install aos (or CDN), call AOS.init(), add data-aos="fade-up" to elements (js, css, html).
  Rule: Keep the MIT notice if you redistribute the code.
  License: https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/aos/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install aos
How an agent gets files
npm install aos (or CDN), call AOS.init(), add data-aos="fade-up" to elements.

Formats: js, css, html

Repository
API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Scroll animations: AOS (MIT)
This card for machines

Alternatives

AOS (Animate On Scroll) This page

Free Commercial OK npm

Scroll-driven Animations demos

Pick native CSS scroll-driven animations when you want reveal and parallax effects in plain CSS with no script to load.

Free Commercial OK Download

GSAP (GreenSock)

Pick GSAP with its free ScrollTrigger plugin for scroll effects with timelines, pinning and scrubbing tied to the scroll position.

Free Commercial OK npm

Animate.css

Pick Animate.css when you need ready keyframe effects added by a class name, for example on page load or on click.

Free With conditions npm

three.js examples

Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.

Free Commercial OK npm

React Three Fiber examples

Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.

Free Commercial OK npm

All web animation examples and effects

Questions

Do I need to write JavaScript?

Only one line, AOS.init(), plus the data-aos attributes in your HTML.

Which effects are there?

Fade, flip, slide and zoom effects in several directions, with a choice of easing curves.

Can I turn it off on phones?

Yes. Set disable to 'mobile', 'phone' or 'tablet', or to your own condition or function.

What if content is added to the page later?

AOS watches the page for changes and re-reads new elements; call AOS.refresh() if positions change in other ways.

Can I use it in a commercial site?

Yes. It is MIT licensed.