Requirements

Node.js, operating systems, disk space and the app you want to test.

On this page
  1. Engines
  2. What has been tested where
RequirementVersionNotes
Node.js22.12 or newermotionpr doctor checks it. Development and CI of this repository use 24
Operating systemmacOS, Linux, WindowsLinux machines need system libraries once: motionpr install --with-deps
BrowserChromium, Firefox or WebKit from Playwright 1.65Downloaded by motionpr install; Chromium is the default
Disk space300–600 MB per engineMeasured on macOS arm64: Chromium 580 MB (with its headless shell), Firefox 300 MB, WebKit 320 MB. Captures add a few MB each
Your appanything that runs in a browserMotionPR drives a real page over HTTP(S); it can start your dev server

MotionPR runs entirely on your machine or CI runner. It has no account, no backend and no telemetry.

Engines

The adapters are optional. A project with only CSS transitions, CSS animations or Web Animations installs nothing extra.

EngineSupported rangeVerified withEntry point
GSAP>=3.12 <43.15.1@erenthedeveloper0/motionpr/gsap
Anime.js>=4 <54.5.0@erenthedeveloper0/motionpr/animejs
Lenis>=1.1 <21.3.27@erenthedeveloper0/motionpr/lenis

"Verified" means covered by automated tests against a real browser in this repository. Versions inside the range but other than the verified one are expected to work; versions outside it are reported as untested by motionpr doctor and in captures, and MotionPR still runs.

What has been tested where

This release was verified on macOS (arm64) with Node.js 24 and Playwright 1.65's Chromium, Firefox and WebKit. The repository's CI runs the same browser suites on Linux, once per engine. Windows paths are handled in code but no CI job runs on Windows yet. See the support matrix and Browser support.

Next: Installation.