react-native-worklets

About

The React Native multithreading library

Live mirror of the GitHub README. Updated whenever the repo's default branch changes.

Reanimated & Worklets

This repository contains two main packages:

• React Native Reanimated — a library for creating smooth animations and interactions in React Native,
• React Native Worklets — a library that enables multi-threaded JavaScript execution in React Native applications.

Create smooth animations with an excellent developer experience.

Reanimated 4 is here! Check out our documentation page for more information

Nightly CI state

Installation

Check out the detailed installation instructions for Reanimated and instructions for Worklets their dedicated documentation pages.

Compatibility

Reanimated 4.x and Worklets support 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

You can find more information about Reanimated and Worklets, their API references and more in their dedicated documentation pages:

• Reanimated — https://docs.swmansion.com/react-native-reanimated/
• Worklets — https://docs.swmansion.com/react-native-worklets/

Examples

The source code for the example (showcase) app is under the apps/common-app directory. If you want to play with the API but don't feel like trying it on a real app, you can run the example project. Check Example README for installation instructions.

License

Reanimated and Worklets libraries are 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, Worklets or other Software Mansion libraries.

Reanimated and Worklets are 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

Common 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-worklets

We catch react-native-worklets 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-worklets/ 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. 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. 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-worklets/` — every match confirms the package is bundled. The matching `sourcesContent[i]` for `node_modules/react-native-worklets/package.json` gives you the exact installed version.

3. 3

   Read the version directly from package.json

   Run `jq -r '. as $m | $m.sources | to_entries[] | select(.value | endswith("node_modules/react-native-worklets/package.json")) | $m.sourcesContent[.key] | fromjson | .version' bundle.js.map`. Sourcemap Explorer automates the same query in the popup.

Recent versions

FAQ

Keep reading on Sourcemap Explorer