react-native-reanimated
More powerful alternative to Animated library for React Native.
About
More powerful alternative to Animated library for React Native.
Live mirror of the GitHub README. Updated whenever the repo's default branch changes.
Create smooth animations with an excellent developer experience.
Reanimated 4 is here! Check out our documentation page for more information
Nightly CI state
![Lint clang-tidy [Nightly]](https://github.com/software-mansion/react-native-reanimated/actions/workflows/lint-clang-tidy-nightly.yml/badge.svg){kind=icon}
![Use frameworks Reanimated build check [Nightly]](https://github.com/software-mansion/react-native-reanimated/actions/workflows/use-frameworks-reanimated-build-check-nightly.yml/badge.svg){kind=icon}
Installation
Check out the installation section of our docs for the detailed installation instructions.
Compatibility
React Native Reanimated 4.x supports only the New React Native architecture and three latest React Native versions.
If your app still runs on the old architecture, please consider adopting the New Architecture or stay with latest 3.x release.
Documentation
Check out our dedicated documentation page for info about this library, API reference and more: https://docs.swmansion.com/react-native-reanimated/
License
Reanimated library is licensed under The MIT License.
Credits
This project has been built and is maintained thanks to the support from Shopify, Expo.io and Software Mansion
Community Discord
Join the Software Mansion Community Discord to chat about Reanimated or other Software Mansion libraries.
Reanimated is created by Software Mansion
Since 2012 Software Mansion is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – Hire us.
Quick facts
npm install react-native-reanimatedCommon pairings
Packages this one expects to find in the same project. Each is also a Sourcemap Explorer detection target.
How Sourcemap Explorer detects react-native-reanimated
We catch react-native-reanimated from two complementary signals: bundled source paths and the embedded package.json. Modern bundlers (webpack, Vite, esbuild, Rollup, Turbopack) preserve the original node_modules/react-native-reanimated/ paths inside the JavaScript sourcemap's sources[] array — that's the canonical signal. When the matching package.json is also captured in sourcesContent[], we read the exact version field — patch number included. No regex guessing, no version inference.
- 1
Confirm the site exposes sourcemaps
In DevTools Network, check the response headers of any application script for `SourceMap` or `X-SourceMap`. Failing that, fetch the script's last 4 KB and look for a `//# sourceMappingURL=` comment.
- 2
Find the package in the bundle
Open DevTools → Network → reload. Click any application script and look at its sourcemap. Inside, search `sources[]` for entries matching `node_modules/react-native-reanimated/` — every match confirms the package is bundled. The matching `sourcesContent[i]` for `node_modules/react-native-reanimated/package.json` gives you the exact installed version.
- 3
Read the version directly from package.json
Run `jq -r '. as $m | $m.sources | to_entries[] | select(.value | endswith("node_modules/react-native-reanimated/package.json")) | $m.sourcesContent[.key] | fromjson | .version' bundle.js.map`. Sourcemap Explorer automates the same query in the popup.
Recent versions
FAQ
What is react-native-reanimated used for?
More powerful alternative to Animated library for React Native.
How can I tell if a website is using react-native-reanimated?
Open the page in Chrome with the Sourcemap Explorer extension installed and read the Stack tab. We catch `react-native-reanimated` from two complementary signals: `node_modules/react-native-reanimated/` paths inside the JavaScript sourcemap, and the embedded `package.json` we read for exact-version detection. Without the extension you can do the same lookup manually in DevTools — the steps are listed in the "How Sourcemap Explorer detects" section above.
What is the latest version of react-native-reanimated?
4.3.1, as published on the npm registry. The "Recent versions" table on this page lists the most recent 8 releases with their release dates. Sourcemap Explorer reports the version actually bundled into a site, which can lag the latest release by months on real-world deployments.
Where can I read more?
Project homepage: https://docs.swmansion.com/react-native-reanimated. Source code: https://github.com/software-mansion/react-native-reanimated. Published on npm: https://www.npmjs.com/package/react-native-reanimated. Licensed as MIT.
Keep reading on Sourcemap Explorer
Detection deep dives
Alternative tools
Detected by Sourcemap Explorer
When a bundle ships sourcemaps, we read the embedded package.json for react-native-reanimated and report the precise version. Without sourcemaps, an import / require in the page's scripts is enough to flag it.