4.0.0 (2025-10-20)

react-native-mmkv V4 is the next major evolution of the library - it features:

• A full rewrite to Nitro! 🔥
  • ..this implies that V4 now works again on the old-architecture, until react-native 0.82 at least.
• react-native-mmkv V4 now uses MMKVCore from CocoaPods/Gradle instead of shipping it as source - this means you can use the native MMKV library from your native code again without causing duplicate symbols!
• Make set(...) throw a useful Error when the value couldn't be saved
• Adds useMMKVKeys()
• Make remove(...) return a bool
• Add AppGroup again
• Make remove(...) and clearAllKeys() invoke listeners properly

‼️ Before upgrading, please read the V4 upgrade guide. ‼️

✨ Features

• add React Native Harness (#918) (cbcb4bd)
• Throw if set(...) was not successful (#921) (0d3b833)
• Upgrade MMKVCore to 2.2.4 (Android) (#912) (cf77676)
• Upgrade Nitro to 0.30.0 (#923) (03dd7c9)
• Upgrade to Nitro 0.31 (#929) (176e4f3)
• Upgrade to react-native 0.82.0 (#930) (5f7d595)

🐛 Bug Fixes

• Fix example app build for Xcode 26 (#922) (965a549)
• Notify listeners when keys get removed (remove/clearAll) (#920) (09643c3)
• Throw if key is empty in set(...) (#919) (3d3b793)

4.0.0-beta.12 (2025-09-26)

This release removes the need to manually add MMKVCore to your Podfile. If you have it in your Podfile, remove it:

- pod 'MMKVCore', :defines_modules => true

✨ Features

• Update MMKVCore to 2.2.4 which defines Modules (#910) (ddaf5a8)

🐛 Bug Fixes

• Fix example app bundle identifiers (#906) (0be150e)

📚 Documentation

• Point V3 README links to V3 branch docs (16f6cef)

4.0.0-beta.11 (2025-09-23)

This beta is finally the release-candidate for V4 since we added back 32-bit support. 🥳
‼️ If you want to try it, please read the V4 upgrade guide. ‼️

✨ Features

• Use our MMKV fork to support 32-bit again (#887) (43e68b5)

📚 Documentation

• Clarify V4 upgrade guide (62a1615)

4.0.0-beta.10 (2025-09-18)

🐛 Bug Fixes

• Add support for React Native 0.79 or below (#891) (4f9a2ab)
• Fix optional config on Web (#893) (96dba4c)
• Rename createMMKV.mock.ts to createMockMMKV.ts to prevent mock conflicts (#889) (8e6bfdf)

3.3.3 (2025-09-18)

3.3.2 (2025-09-18)

🐛 Bug Fixes

• Fix TurboModule not found error by checking both names (941129a)

4.0.0-beta.9 (2025-09-15)

✨ Features

• Make remove(...) return a bool (#882) (2b9068e)
• Upgrade Nitro (and switch to nitrogen) (2f5ac5a)

🐛 Bug Fixes

• Fix Expo plugin for android (#880) (d7fccf5)

📚 Documentation

• Add V3 docs back (a78f660)
• Update docs for V4 (a6e0fbe)
• Update README.md (#885) (74d00bb)

3.3.1 (2025-09-04)

🐛 Bug Fixes

• Bump CXX standard to 20 (#841) (1d86ae5)

4.0.0-beta.8 (2025-09-01)

✨ Features

• Add Expo Config Plugin for 64-bit archs only (#876) (23717d9)
• Implement AppGroup (#877) (6b84d9c)
• use jest not bun for tests, contributing docs (#872) (dea5c23)

📚 Documentation

• Add v4 upgrade guide (2cf798c)
• Rename from new MMKV (0ba547f)

4.0.0-beta.7 (2025-08-29)

🐛 Bug Fixes

• Fix .hpp not included in npm package (2d1a4a9)