FINDING YOUR DIRECTION

0%
← Scrollhaus Journal

AI Website Guides · Published · 5 min read

Lenis Smooth Scroll Tutorial: Setup, GSAP & React (2026)

Lenis is a lightweight smooth scroll library that turns jumpy mouse-wheel scrolling into eased, fluid motion without hijacking the native scrollbar. This tutorial covers setup, GSAP ScrollTrigger sync, React usage and the bugs that trip people up.

Published by Amanjot Singh, founder of Scrollhaus. AI-assisted editorial work; product context, sources and corrections are documented in our editorial methodology.

A scroll-driven animated website with smooth eased scrolling
Scrollhaus Journal · AI Website Guides

Disclosure: ScrollHaus publishes this guide. Technique descriptions come from public documentation of the libraries and browser APIs named, and the live examples are ScrollHaus websites you can scroll yourself.

What is Lenis smooth scroll?

Lenis is a small open-source library that smooths scrolling. Browsers move the page in discrete steps when a mouse wheel turns. Lenis intercepts wheel and touch input, eases the movement toward the target position, and applies the result to the real scroll position. Because it uses the native scroll position, position: sticky, anchor links, accessibility tools and scroll-driven libraries keep working. That is the main reason designers choose it over older "scroll jacking" approaches.

Install and start Lenis

npm install lenis

import Lenis from 'lenis';

const lenis = new Lenis({
  duration: 1.2,
  easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
  smoothWheel: true,
});

function raf(time) {
  lenis.raf(time);
  requestAnimationFrame(raf);
}
requestAnimationFrame(raf);

Add the recommended CSS from the Lenis documentation so native smooth scrolling does not fight the library: html.lenis, html.lenis body { height: auto; } and .lenis.lenis-smooth { scroll-behavior: auto !important; }.

Sync Lenis with GSAP ScrollTrigger

If you use GSAP ScrollTrigger, tell it when Lenis scrolls and let GSAP's ticker drive Lenis so both share one clock:

import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);

lenis.on('scroll', ScrollTrigger.update);
gsap.ticker.add((time) => lenis.raf(time * 1000));
gsap.ticker.lagSmoothing(0);

Without the ticker line you run two animation loops and see jitter. See our GSAP ScrollTrigger examples for what to build on top.

Lenis in React and Next.js

Create the instance in an effect, drive it with requestAnimationFrame, and destroy it on cleanup so hot reloads and route changes do not stack instances:

useEffect(() => {
  const lenis = new Lenis();
  let id;
  const raf = (t) => { lenis.raf(t); id = requestAnimationFrame(raf); };
  id = requestAnimationFrame(raf);
  return () => { cancelAnimationFrame(id); lenis.destroy(); };
}, []);

Does Lenis work on mobile?

Touch scrolling on phones is already smooth and inertial, so Lenis leaves it native by default. That is a feature: you keep platform feel and avoid the battery cost of a custom loop. Tune syncTouch only if you need identical behavior across devices.

Common Lenis problems and fixes

Lenis plus a frame-sequence canvas

Smooth scrolling is what makes a scroll-driven film feel premium. Pair it with the image sequence canvas technique and open a live example such as CORNERSTONE or VORTA to see the result. More background: scroll animation websites and scroll animation performance.

Frequently asked questions

Does Lenis work with GSAP ScrollTrigger?

Yes. Call ScrollTrigger.update on Lenis scroll events and drive lenis.raf from the GSAP ticker so both libraries share one animation loop.

How do I use Lenis in React or Next.js?

Create the Lenis instance in a useEffect, drive it with requestAnimationFrame, and call lenis.destroy() in the cleanup function.

Why is my Lenis page not scrolling?

Usually a parent element has overflow hidden or the html height is fixed. Add the recommended Lenis CSS and remove scroll-behavior smooth.

Is Lenis bad for accessibility or SEO?

No. It uses the real scroll position, so content stays crawlable and assistive tools work. Disable it for users who prefer reduced motion.

Does Lenis run on mobile?

By default touch scrolling stays native on phones, which is usually best for performance and feel.

Browse Scrollhaus website designs and build resources →

Need help with a template, account, or project? Email admin@scrollhaus.ai.