Installation
react-native-nitro-thumbnail is a Nitro module. Installing it is two packages plus a
pod install — no manual linking, no config plugin.
Add the package and the Nitro runtime
npm install react-native-nitro-thumbnail react-native-nitro-modules⚠️
react-native-nitro-modules is a required peer dependency — it provides the Nitro
runtime. Installing react-native-nitro-thumbnail alone will not work.
Install iOS pods
cd ios && pod installRebuild the app
Native code changed, so rebuild (a Fast Refresh / Metro reload is not enough):
npx react-native run-ios # or run-androidExpo
This is a native module, so it needs an Expo dev build — it does not run in Expo Go. No config plugin is required:
npx expo install react-native-nitro-thumbnail react-native-nitro-modules
npx expo prebuild && npx expo run:ios # or run:androidRequirements
Requires React Native 0.75+ with the New Architecture enabled. This library is New-Architecture-only — there is no old-architecture build.
| Platform | Engine | Minimum |
|---|---|---|
| 🍎 iOS | AVAssetImageGenerator | iOS 13 (async image(at:) on 16+, copyCGImage fallback below) |
| 🤖 Android | MediaMetadataRetriever | minSdk 24 (getScaledFrameAtTime on API 27+, scale-after fallback below) |
| 🌐 Web | <video> → <canvas> → toBlob | modern browsers |
Next: head to the Quick Start.