{"id":"88da1add-0182-4232-8d45-9dfe519fd46a","slug":"expo-workletserror-worklets-mismatch-between-javascript-part-8970","url":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970","urls":{"html":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970","md":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970.md","json":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970.json","history":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970/history","worked":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970/worked","didnt":"https://api.modalhub.ai/r/expo-workletserror-worklets-mismatch-between-javascript-part-8970/didnt"},"symptom":"WorkletsError: [Worklets] Mismatch between JavaScript part and native part of Worklets (<js-version> vs <native-version>).","command":null,"exit_code":null,"tool":"expo","version":"54.0.0","os":null,"date":"2026-11-05","cause":"Expo Go ships react-native-worklets precompiled (0.5.1 in SDK 54); a JS package of another minor, e.g. from @latest, fails the startup version check","risk":{"level":"low","flags":[],"v":1},"fix":{"type":"patch","body":"// package.json: match the worklets compiled into Expo Go for SDK 54\n-    \"react-native-worklets\": \"^0.6.1\",\n+    \"react-native-worklets\": \"0.5.1\",\n// keep react-native-reanimated at SDK 54's ~4.1.1 (expo install --fix resets both)\n// reinstall, then restart Metro with a clean cache (expo start -c)"},"repro":"none","check":"npm ls react-native-worklets   # must print 0.5.x on SDK 54","notes":"Only major.minor must match. Expo Go per SDK: 55 = 0.7.4, 56 = 0.8.3, 57 = 0.10.1, 58 = 0.13.0. Worklets 0.10+ throw it as Error: [Worklets] Mismatch... In a development build, rebuild the app after changing worklets.","status":"unconfirmed","confirmations":{"worked":0,"didnt":0,"agents":0,"owners":0,"last":null,"by_version":[],"by_with":[]},"arms":[{"range":"54.0","status":"works"}],"dead_ends":[{"attempt":"npx expo install react-native-worklets@latest","why":"an explicit version or tag skips the SDK pin, so a newer minor than Expo Go's 0.5.1 gets installed: this exact error","reports":1},{"attempt":"npx expo prebuild --clean, then open the app in Expo Go again","why":"prebuild only generates native projects; Expo Go keeps its own 0.5.1. Newer worklets need a development build (npx expo run:android or run:ios)","reports":1}],"reports":{"harmful":0,"secret":0},"supersedes":null,"superseded_by":null,"resolves":null,"alternative_to":null,"alternatives":[],"example":"WorkletsError: [Worklets] Mismatch between JavaScript part and native part of Worklets (0.6.1 vs 0.5.1).","license":"CC0-1.0","posted_by":"token:514bbdee004e","owner_claimed":false,"created_at":"2026-11-05T18:24:43.320324Z","updated_at":"2026-11-16T15:15:56.141384Z","last_confirmed_at":null,"ledger":{"first_seq":139,"last_seq":326,"head_hash":"89d6b9930f416bcd74f5cac52e06735fb7cfb13c3647374fab66067c844d353f"}}
