Installation

📋 Requirements

	Minimum
React Native	0.71
iOS	15.1
Node	20

Both architectures supported; RN 0.82 removed Legacy Architecture, so that half only matters on 0.81 and below.

Platform support per provider

	iOS / macOS	Android	Web
icloudKV	native	-	-
cloudKit	native	REST	REST
cloudKitEncrypted	native	-	-
icloudDocuments	native	-	-
googleDrive	REST	REST	REST

An unavailable provider rejects with ERR_UNSUPPORTED_PLATFORM instead of silently doing nothing. Choosing a provider covers the trade-offs.

📦 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/ entitlement keys: see Installation.