mrousavy/react-native-mmkv
React Native Mmkv
react-native-mmkv is a synchronous mobile persistence system that provides an encrypted key-value store for mobile applications. It serves as a high-performance wrapper for the MMKV storage engine, eliminating asynchronous overhead by reading and writing values directly to disk.
The project distinguishes itself through shared app group storage, which allows data access across multiple application extensions via a shared filesystem directory. It also provides state-synced storage hooks that automatically trigger component updates when stored key-value pairs change.
The system covers a broad range of mobile data management capabilities, including multi-instance storage isolation, data migration utilities, and storage health optimization. Security is handled through private-key encryption to protect persisted data and ensure storage file confidentiality.
Features
- Synchronous Native Execution - Eliminates asynchronous promise latency by executing data retrieval and persistence through blocking C++ calls on the main thread.
- Application State Synchronization - Syncs application state with local storage using hooks that trigger immediate UI updates when values change.
- Synchronous Implementations - Provides a high-performance synchronous key-value store that eliminates the overhead of asynchronous calls.
- Persistence Layers - Provides a synchronous persistence layer that reads and writes values directly to disk to eliminate asynchronous overhead.
- Key-Value - Implements a high-performance key-value storage engine based on MMKV for mobile applications.
- Local Persistence Modules - Serves as a high-performance local storage solution specifically designed for the React Native ecosystem.
- Memory-Mapped I/O - Uses memory-mapped file I/O to enable near-instantaneous read and write operations by mapping files directly into virtual address space.
- Encrypted Device Persistence - Protects sensitive key-value data on mobile devices using private-key encryption to prevent unauthorized file access.
- Encrypted Key-Value Stores - Provides a secure key-value storage solution that protects persisted data using private key encryption.
- Symmetric Encryption - Employs symmetric encryption to protect persisted data before it is written to the disk.
- Persistence Sync Hooks - Offers state-synced storage hooks that automatically trigger component updates when stored key-value pairs change.
- Reactive State Syncing - Implements a callback mechanism that notifies JavaScript subscribers of native data changes to trigger reactive UI updates.
- React State Bindings - Ships state-synced storage hooks that automatically trigger React component updates when stored values change.
- Cross-Target Data Sharing - Enables data access across a main application and its extensions by using a shared filesystem directory.
- Per-Instance Data Isolation - Isolates data sets into separate containers using unique identifiers to decouple global settings from user-specific data.
- User Data Management - Manages isolated storage containers to organize global settings and user-specific information on mobile devices.
- Shared App Instances - Allows a main application and its extensions to read and write the same data via a shared app group directory.
- JavaScript Native Interfaces - Provides direct C++ JSI bindings to eliminate serialization overhead between JavaScript and the native storage engine.
- Storage Encryption - Provides private-key encryption for key-value pairs to ensure the confidentiality of the underlying storage files.
- App Group Directories - Points the storage engine to a shared filesystem directory to enable data access across multiple application extensions.
