npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@blacurrant/motion-lint

v1.0.0

Published

High-performance motion linter & compositor contract auditor for React, Vue, Svelte, and CSS. Enforce 120 FPS fluid interfaces and ban animation jank.

Readme

motion-lint

120 FPS Compositor Contract & Motion Auditor for React, Vue, Svelte, and CSS. Enforce zero-reflow transforms, tokenized spring physics, and eliminate animation jank in CI/CD and AI agent workflows.

npm version License: MIT Author: Nishant Choudhary Solana Sponsor


Why motion-lint?

Most web animations feel cheap not because of poor design taste, but because of accidental main-thread layout thrashing.

Animating height, width, top, or using transition: all forces the browser's Blink/WebKit engine to recalculate layout geometry for the entire DOM on every single animation frame (an 8.3ms window at 120Hz). On desktop M-series Macs, brute CPU conceals the damage; on mobile devices and battery-saver mode, frame rates drop to a stuttering 18 FPS.

motion-lint performs instant static analysis on your components and stylesheets, scoring your codebase from 0 to 100 with actionable compositor-safe fixes.

Read the engineering thesis: Why Your React Animations Feel Cheap (And How to Build 120 FPS Fluid Interfaces).


Quick Start

Run instantly with zero installation:

npx @blacurrant/motion-lint src/

Or install as a dev dependency in your project:

npm install -D motion-lint
# or
pnpm add -D motion-lint

Add to package.json:

{
  "scripts": {
    "lint:motion": "motion-lint src/ components/ styles/"
  }
}

Rules Enforced

| Rule ID | Name | Severity | Description | | :--- | :--- | :--- | :--- | | ML001 | layout-thrashing | Error | Flags animating layout properties (height, width, top, left, margin, padding). Suggests transform: translate3d/scale or clip-path. | | ML002 | ban-transition-all | Error | Flags transition: all and Tailwind transition-all which cause accidental reflows on viewport resize. | | ML003 | missing-will-change | Info | Detects active transform transitions lacking will-change: transform GPU layer promotion. | | ML004 | cheap-easing | Warn | Flags linear or default symmetric browser ease curves. Suggests tokenized asymmetric cubic beziers. | | ML005 | reduced-motion | Warn | Verifies root @media (prefers-reduced-motion: reduce) accessibility token collapse. | | ML006 | framer-springs | Warn | Audits Framer Motion spring physics (flags muddy high-damping values > 50). |


Output Example

◆ MOTION-LINT v1.0.0 — 120 FPS Compositor Contract & Motion Linter
  Enforcing zero-reflow transforms, tokenized spring physics, and fluid web UI

● src/components/Drawer.jsx
   REF_ERR  L9: [ML001] Framer Motion animating layout property 'height' on main thread.
     › animate={{ height: isOpen ? 320 : 0 }}
     → Fix: Replace 'height' with scaleX/scaleY or use Framer Motion's GPU-accelerated 'layout' / 'layoutId' prop.

   WARN  L6: [ML002] Tailwind 'transition-all' triggers layout calculations on unexpected DOM shifts.
     › <div className="drawer-container transition-all">
     → Fix: Replace 'transition-all' with 'transition-transform' or 'transition-opacity'.

----------------------------------------------------------------------
MOTION HEALTH AUDIT:
  Files Scanned:   18
  Motion Score:    88/100 [Grade: A]
  Compositor Violations: 1 error, 2 warnings, 0 suggestions
  Scan Duration:   4ms

⚡ Built by Nishant Choudhary (Creative Developer & Design Engineer)
  Portfolio & Case Studies: https://nishant.world
  Solana Tip Jar / Sponsor: F9DJTXa6xP7mdG1niMNDhqcM3vDq8LZvg25JqJXGvDTf

Claude Code & OpenBot Skill Integration

motion-lint includes a native Claude Code / OpenBot Skill definition (SKILL.md). When installed in .agents/skills/motion-lint or Claude Code skills directory, AI coding agents automatically run motion-lint on generated frontend components to ensure they adhere to 120 FPS compositor standards before committing code.


CI/CD GitHub Actions Integration

Fail PRs that introduce layout-thrashing animations:

name: Motion Health CI
on: [push, pull_request]

jobs:
  audit-motion:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx @blacurrant/motion-lint src/ --format=json

Support & Attribution

Crafted by Nishant Choudhary — Design Engineer & Creative Developer specializing in GPU shaders, motion systems, and SaaS frontend architecture.