Skip to content

v1.8 • Motion • 4kb gzipped • MIT

ScrollCue

Scroll-linked animation driven by the platform timeline, with a clean fallback where it is missing.

★ 6.1kGitHub
↓ 10.4k / week● MIT● TS 5.0+
scrollcue-preview.png
Abstract preview graphic for ScrollCue

// why scrollcue

Off the main thread

Uses scroll-driven animations where available, so the effect keeps running while JavaScript is busy elsewhere.

● 60fps● 1ms frame cost● 0 deps

// stack

Graceful fallback

Falls back to an observer-driven path in older browsers, with the same declarative API.

ScrollCue started as a single file in a client project and stayed small on purpose. It does one job, it does it in 4kb gzipped, and it has no runtime dependencies.

Getting started

Install it, import it, call it:

npm i scrollcue-js

Uses scroll-driven animations where available, so the effect keeps running while JavaScript is busy elsewhere.

What it does not do

It does not manage your state, style your components or ship a plugin system. Those are your decisions, and keeping them out is what keeps the bundle honest.

  • Compositor-driven
  • Honest fallback
  • MIT licensed, commercially friendly

Features

Compositor-driven

Native scroll timelines mean no scroll listener and no layout thrash.

Honest fallback

The fallback path is intentionally simpler rather than a heavier polyfill.

Sixty frames, measured

Performance is asserted in CI against a recorded trace, not assumed.

Compositor friendly

Animates transform and opacity only, so nothing triggers layout.

Fully controllable

Play, pause, reverse and seek, all from a plain object.

Respects reduced motion

Reads the user preference and falls back to an instant state change.

Get ScrollCue v1.8

9 files • .min.js 4kb • .zip 43kb • sha384 verified

Changelog

v1.8 Feb 13 2026 • latest
  • Native scroll timeline support
  • Observer fallback simplified
  • Reduced-motion handling built in
v1.7.4 Dec 24 2025
  • Safari 16 compatibility fixes
  • Bundle size reduced by eleven percent
v1.7.3 Sep 22 2025
  • Improved error messages for invalid options
  • Added twenty regression tests
View full archive →

// related

Related products

Sep 10 • v2.0

ChartForge

Canvas charts in twelve lines. Responsive, accessible and dark-mode ready, with no D3 learning curve.

View →
Aug 30 • v3.2.1

MotionEase

Physics-based micro-animations with a single call. Spring curves that feel right without a tuning session.

View →
Aug 19 • v1.9.4

FormFlow

Validation and multi-step logic that works the same in React, Vue and vanilla. Your markup stays yours.

View →

Make it move today.

MIT licensed. Commercial friendly. Five-minute setup.