Repository: locomotivemtl/locomotive-scroll

Stars: 8750

README.md Copy Chapter

Locomotive Scroll


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

Documentation Copy Chapter

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

Quick Start Copy Chapter

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 Copy Chapter

- 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 Copy Chapter

Check out the examples and playground

Support Copy Chapter

GitHub Issues