{
 "slug": "aos",
 "name": "AOS (Animate On Scroll)",
 "author": "Michał Sajnóg",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Small JS library that fades, slides and zooms elements in as you scroll, set with data-aos attributes in HTML.",
 "category": {
  "slug": "motion-examples",
  "name": "Web animation examples and effects"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "minimal"
 ],
 "logo_url": "https://agentgid.com/media/avatars/michalsnik.png",
 "logo_letter": "A",
 "links": {
  "repo": "https://github.com/michalsnik/aos",
  "website": "https://michalsnik.github.io/aos/",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/aos/demo.jpg",
  "alt": "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.",
  "caption": "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."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "michalsnik.github.io/aos",
    "url": "https://michalsnik.github.io/aos/"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
   "note": "MIT allows use in paid sites and products.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install aos. No key or account is needed.",
   "source": {
    "label": "github.com/michalsnik/aos",
    "url": "https://github.com/michalsnik/aos"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "Keep the MIT notice if you redistribute the code."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-05",
  "commercial_use_page": "https://agentgid.com/assets/aos/commercial-use/"
 },
 "overview": {
  "heading": "AOS: page blocks that fade in as you scroll",
  "body": "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."
 },
 "uses": [
  {
   "title": "Landing page sections that appear on scroll",
   "text": "Make feature blocks, screenshots and quotes on a landing page fade or slide in as the visitor reaches them.",
   "idea": false,
   "image": null
  },
  {
   "title": "Cards that come in one after another",
   "text": "Let pricing cards, team photos or feature tiles appear in a short sequence instead of all at once.",
   "idea": false,
   "image": "https://agentgid.com/assets/aos/demo.jpg"
  },
  {
   "title": "Animate once, not on every pass",
   "text": "On long pages, show each block's entrance only the first time, so scrolling back up does not replay every effect.",
   "idea": false,
   "image": null
  },
  {
   "title": "Calmer pages on phones",
   "text": "Switch the effects off on phones or tablets, or under your own rule such as narrow screens.",
   "idea": false,
   "image": null
  },
  {
   "title": "Trigger from another block",
   "text": "Start an element's animation when a different block reaches the screen, for example a fixed button that appears with a section.",
   "idea": false,
   "image": null
  },
  {
   "title": "Portfolio and case-study pages",
   "text": "Reveal project images and short captions one by one as a visitor reads down a portfolio or case-study page.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "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.",
  "install": "npm install aos --save",
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Start AOS once on the page.",
    "source": "AOS.init();"
   },
   {
    "tab": "Step 2",
    "intro": "Add data-aos with an effect name to each element, and data-aos-* attributes to tune it.",
    "source": "<div data-aos=\"fade-up\" data-aos-anchor-placement=\"top-center\">"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Following the GitHub front page (aos@next) for a project that ran npm install aos",
   "fix": "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",
   "why": "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).",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Leaving the animations on for people who asked their system for less motion",
   "fix": "Pass disable: window.matchMedia('(prefers-reduced-motion: reduce)').matches to AOS.init",
   "why": "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.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "data-aos-duration=\"4000\" or data-aos-delay=\"125\"",
   "fix": "Use 50 to 3000 in steps of 50, or add your own CSS rule for other values",
   "why": "The timing values exist only as prepared CSS rules.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "<div aos=\"fade-up\"> (attribute from old tutorials)",
   "fix": "<div data-aos=\"fade-up\">",
   "why": "The plain aos attribute stopped working in version 2.0.0.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "Loading aos.css and adding data-aos without calling AOS.init()",
   "fix": "Always call AOS.init() after the script loads",
   "why": "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.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install aos",
  "repo": "https://github.com/michalsnik/aos",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install aos (or CDN), call AOS.init(), add data-aos=\"fade-up\" to elements.",
  "formats": [
   "js",
   "css",
   "html"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Scroll animations: AOS (MIT)",
  "rules_text": "- 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.\n  Connect: npm aos.\n  Get files: npm install aos (or CDN), call AOS.init(), add data-aos=\"fade-up\" to elements (js, css, html).\n  Rule: Keep the MIT notice if you redistribute the code.\n  License: https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/aos/)",
  "agent_md": "https://agentgid.com/assets/aos/agent.md",
  "card_json": "https://agentgid.com/assets/aos/card.json"
 },
 "popularity": {
  "gid_score": 47,
  "stars": 28057,
  "downloads_7d": 324927,
  "downloads_7d_label": "324.9K",
  "downloads_change_4w_pct": 14.9,
  "eco": "npm",
  "package": "aos",
  "repo": "michalsnik/aos",
  "agent_projects": 6,
  "agent_projects_total": 4817,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     197461
    ],
    [
     "2025-11-24",
     199426
    ],
    [
     "2025-12-01",
     230418
    ],
    [
     "2025-12-08",
     229940
    ],
    [
     "2025-12-15",
     214716
    ],
    [
     "2025-12-22",
     142421
    ],
    [
     "2025-12-29",
     129014
    ],
    [
     "2026-01-05",
     200318
    ],
    [
     "2026-01-12",
     211525
    ],
    [
     "2026-01-19",
     224811
    ],
    [
     "2026-01-26",
     234585
    ],
    [
     "2026-02-02",
     234120
    ],
    [
     "2026-02-09",
     228799
    ],
    [
     "2026-02-16",
     224639
    ],
    [
     "2026-02-23",
     240842
    ],
    [
     "2026-03-02",
     231027
    ],
    [
     "2026-03-09",
     244523
    ],
    [
     "2026-03-16",
     225817
    ],
    [
     "2026-03-23",
     221417
    ],
    [
     "2026-03-30",
     225285
    ],
    [
     "2026-04-06",
     233307
    ],
    [
     "2026-04-13",
     230860
    ],
    [
     "2026-04-20",
     228417
    ],
    [
     "2026-04-27",
     246482
    ],
    [
     "2026-05-04",
     224259
    ],
    [
     "2026-05-11",
     236810
    ],
    [
     "2026-05-18",
     240959
    ],
    [
     "2026-05-25",
     221843
    ],
    [
     "2026-06-01",
     253968
    ],
    [
     "2026-06-08",
     261670
    ],
    [
     "2026-06-15",
     311089
    ],
    [
     "2026-06-22",
     258917
    ],
    [
     "2026-06-29",
     244398
    ],
    [
     "2026-07-06",
     241831
    ],
    [
     "2026-07-13",
     257527
    ],
    [
     "2026-07-20",
     255684
    ],
    [
     "2026-07-27",
     257763
    ],
    [
     "2026-08-03",
     267633
    ],
    [
     "2026-08-10",
     252609
    ],
    [
     "2026-08-17",
     269327
    ],
    [
     "2026-08-24",
     268995
    ],
    [
     "2026-08-31",
     287764
    ],
    [
     "2026-09-07",
     191227
    ],
    [
     "2026-09-14",
     268459
    ],
    [
     "2026-09-21",
     295106
    ],
    [
     "2026-09-28",
     329747
    ],
    [
     "2026-10-05",
     286764
    ],
    [
     "2026-10-12",
     241809
    ],
    [
     "2026-10-19",
     253279
    ],
    [
     "2026-10-26",
     393293
    ],
    [
     "2026-11-02",
     354034
    ],
    [
     "2026-11-09",
     324927
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     28047
    ],
    [
     "2026-11-08",
     28047
    ],
    [
     "2026-11-09",
     28048
    ],
    [
     "2026-11-10",
     28047
    ],
    [
     "2026-11-11",
     28051
    ],
    [
     "2026-11-12",
     28051
    ],
    [
     "2026-11-13",
     28051
    ],
    [
     "2026-11-14",
     28053
    ],
    [
     "2026-11-15",
     28054
    ],
    [
     "2026-11-16",
     28055
    ],
    [
     "2026-11-17",
     28057
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "aos",
   "name": "AOS (Animate On Scroll)",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "scroll-driven-animations-style",
   "name": "Scroll-driven Animations demos",
   "why": "Pick native CSS scroll-driven animations when you want reveal and parallax effects in plain CSS with no script to load.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "gsap",
   "name": "GSAP (GreenSock)",
   "why": "Pick GSAP with its free ScrollTrigger plugin for scroll effects with timelines, pinning and scrubbing tied to the scroll position.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "animate-css",
   "name": "Animate.css",
   "why": "Pick Animate.css when you need ready keyframe effects added by a class name, for example on page load or on click.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "npm"
  },
  {
   "slug": "threejs-examples",
   "name": "three.js examples",
   "why": "Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "react-three-fiber-examples",
   "name": "React Three Fiber examples",
   "why": "Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Do I need to write JavaScript?",
   "a": "Only one line, AOS.init(), plus the data-aos attributes in your HTML."
  },
  {
   "q": "Which effects are there?",
   "a": "Fade, flip, slide and zoom effects in several directions, with a choice of easing curves."
  },
  {
   "q": "Can I turn it off on phones?",
   "a": "Yes. Set disable to 'mobile', 'phone' or 'tablet', or to your own condition or function."
  },
  {
   "q": "What if content is added to the page later?",
   "a": "AOS watches the page for changes and re-reads new elements; call AOS.refresh() if positions change in other ways."
  },
  {
   "q": "Can I use it in a commercial site?",
   "a": "Yes. It is MIT licensed."
  }
 ],
 "at_a_glance": {
  "latest_version": "2.3.4",
  "last_commit": "2024-03-26",
  "runtime": "No framework; a script tag (UMD build with its helpers bundled in dist/aos.js) or a bundler import plus dist/aos.css.",
  "key_needed": false,
  "formats": "js, css, html"
 },
 "good_to_know": [
  "The stable version is 2.3.4 from October 2018. Version 3 is still a beta (3.0.0-beta.6).",
  "The project's main page on GitHub describes the unfinished version 3. Version 2 instructions are on a separate page.",
  "In version 2, blocks animate back out when you scroll up past them, unless you set the once option.",
  "Animation length and delay only work from 50 to 3000 milliseconds, in steps of 50. Other values need a few lines of your own CSS.",
  "It runs in the visitor's browser; no account, key or outside service is involved."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "michalsnik.github.io/aos",
    "url": "https://michalsnik.github.io/aos/"
   },
   {
    "label": "github.com/michalsnik/aos",
    "url": "https://github.com/michalsnik/aos"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/michalsnik/aos/blob/master/README.md"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/michalsnik/aos/blob/next/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/michalsnik/aos/blob/next/LICENSE"
   },
   {
    "label": "npm: aos/latest",
    "url": "https://registry.npmjs.org/aos/latest"
   },
   {
    "label": "npm: aos",
    "url": "https://registry.npmjs.org/aos"
   },
   {
    "label": "api.github.com/repos/michalsnik/aos",
    "url": "https://api.github.com/repos/michalsnik/aos"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/michalsnik/aos/next/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/aos/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
