Installation

Install @erenthedeveloper0/motionpr as a development dependency and run the motionpr command.

On this page
  1. Why @alpha
  2. What gets installed
  3. Try it without a project
npmShell
npm install -D @erenthedeveloper0/motionpr@alpha

The package is @erenthedeveloper0/motionpr. The command it installs is motionpr, which every guide runs through npx (or pnpm exec, yarn, bunx):

Shell
npx motionpr --version

Why @alpha

MotionPR is in alpha. Its versions are prereleases (0.2.0-alpha) and they are published on npm's alpha dist-tag. Naming the tag installs the newest alpha; once MotionPR has a stable release, npm install -D @erenthedeveloper0/motionpr will install that instead. A semver range such as ^0.2.0 never matches a prerelease, so nobody receives an alpha by accident.

What gets installed

PartWhere it runsNotes
motionpr CLI and the Node APINode.jsUses playwright-core, zod, commander, pixelmatch, pngjs, …
@erenthedeveloper0/motionpr/gsapyour app (browser)Dependency-free module; does nothing unless MotionPR is capturing
@erenthedeveloper0/motionpr/animejsyour app (browser)Same
@erenthedeveloper0/motionpr/lenisyour app (browser)Same
Report viewer templatecopied into reportsOne HTML file with the viewer and its fonts; reports load nothing remote
Demo appmotionpr demoThe bundled Halcyon demo site in two variants
Browser buildsmotionpr installDownloaded separately into Playwright's cache; never part of the package

GSAP, Anime.js and Lenis are optional peer dependencies. MotionPR never bundles them: the adapters work with the copy your app already uses.

Try it without a project

Shell
npx @erenthedeveloper0/motionpr@alpha install   # Chromium, once per machine (or: install firefox)
npx @erenthedeveloper0/motionpr@alpha demo

demo captures the bundled demo app in two versions, compares them and opens a real report. See motionpr demo.

Next: Browser setup.