Locomotive Scroll

A lightweight & modern scroll library for detection, animation, and smooth scrolling. Built on top of Lenis.

Documentation

Full documentation available at scroll.locomotive.ca/docs.

Quick Start

npm install locomotive-scroll

import LocomotiveScroll from 'locomotive-scroll';

const scroll = new LocomotiveScroll();

@import 'locomotive-scroll/dist/locomotive-scroll.css';

<div data-scroll data-scroll-speed="0.5">I move at half speed</div>

Features

• Lightweight — Only 9.4kB gzipped
• TypeScript First — Fully typed
• Built on Lenis — Latest stable release with improved performance
• Dual Intersection Observers — Optimized detection for triggers vs. animations
• Smart Touch Detection — Parallax auto-disabled on mobile
• Accessible — Native scrollbar, keyboard navigation, proper ARIA support

Demo

Check out the examples and playground

Support

GitHub Issues