Skip to main content

Installation

📋 Requirements​

Minimum
React Native0.71
iOS15.1
Node20

Both architectures are supported. RN 0.82 removed the Legacy Architecture, so it only matters on 0.81 and below.

Platform support per provider​

iOS / macOSAndroidWeb
icloudKVnative--
cloudKitnativeRESTREST
cloudKitEncryptednative--
icloudDocumentsnative--
googleDriveRESTRESTREST

An unavailable provider rejects with ERR_UNSUPPORTED_PLATFORM; it never silently does nothing. Trade-offs: Choosing a provider.

📦 Installation​

npx expo install react-native-cloud-sync

Add the config plugin, then rebuild:

{
"expo": {
"plugins": [
["react-native-cloud-sync", {
"containerIdentifier": "iCloud.com.your.app"
}]
]
}
}

Bare React Native and manual ios/ entitlements: see Installation.