react-native-worklets 0.8.0+ crashes

[maxoschepkov]

Before submitting a new issue

• I tested using the latest version of the library, as the bug might be already fixed.
• I tested using a supported version of react native.
• I checked for possible duplicate issues, with possible answers.

Bug summary

Hello, do you have any plans to update from preview version to the 0.8.0+ version soon?
Currently, it causes a crash on production builds on startup if we're using version which is different from preview.

Also compiling with react-native-reanimated 4.3.0 causes build fail if the version is not 0.8.0+.
So it's a dead loop.

› Compiling react-native-reanimated Pods/RNReanimated » UIEventHandlerRegistry.cpp

❌  (ios/Pods/Headers/Private/RNReanimated/reanimated/Compat/WorkletsApi.h:3:10)

  1 | #pragma once
  2 |
> 3 | #include <worklets/Compat/StableApi.h>
    |          ^ 'worklets/Compat/StableApi.h' file not found
  4 | #include <string>
  5 |
  6 | #define EXPECTED_WORKLETS_STABLE_API_VERSION "0.8.0"

Library version

0.1.1

Environment info

System:
  OS: macOS 15.6
  CPU: (14) arm64 Apple M4 Pro
  Memory: 718.77 MB / 48.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 20.19.5
    path: ~/.nvm/versions/node/v20.19.5/bin/node
  Yarn:
    version: 1.22.22
    path: ~/.nvm/versions/node/v20.19.5/bin/yarn
  npm:
    version: 10.8.2
    path: ~/.nvm/versions/node/v20.19.5/bin/npm
  Watchman:
    version: 2025.04.28.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.16.2
    path: /opt/homebrew/bin/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.2
      - iOS 26.2
      - macOS 26.2
      - tvOS 26.2
      - visionOS 26.2
      - watchOS 26.2
  Android SDK: Not Found
IDEs:
  Android Studio: 2025.1 AI-251.26094.121.2513.14007798
  Xcode:
    version: 26.2/17C52
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.16
    path: /usr/bin/javac
  Ruby:
    version: 3.4.3
    path: /opt/homebrew/opt/ruby/bin/ruby
npmPackages:
  "@react-native-community/cli":
    installed: 20.1.3
    wanted: ^20.1.3
  react:
    installed: 19.2.0
    wanted: 19.2.0
  react-native:
    installed: 0.83.4
    wanted: 0.83.4
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: true
iOS:
  hermesEnabled: true
  newArchEnabled: true

Steps to reproduce

1. Install worklets 0.8.0+
2. Build app for production

Reproducible example repository

n/a

[priyanshrastogi]

facing the same issue

[nickmccomb]

Anyone looking into this?