expo-image

A cross-platform, performant image component for React Native and Expo.

Main features

• Designed for speed
• Support for many image formats (including animated ones)
• Disk and memory caching
• Supports BlurHash and ThumbHash - compact representations of a placeholder for an image
• Transitioning between images when the source changes (no more flickering!)
• Implements the CSS object-fit and object-position properties (see contentFit and contentPosition props)
• Uses performant SDWebImage and Glide under the hood

Supported image formats

Format	Android	iOS	Web
WebP	✅	✅	✅ ~96% adoption
PNG / APNG	✅	✅	✅ / ✅ ~96% adoption
AVIF	✅	✅	⏳ ~79% adoption
HEIC	✅	✅	❌ not adopted yet
JPEG	✅	✅	✅
GIF	✅	✅	✅
SVG	✅	✅	✅
ICO	✅	✅	✅
ICNS	❌	✅	❌

API documentation

• Documentation for the latest release

Installation

Currently expo-image can be used only with Expo SDK47 in development builds and bare React Native apps with configured Expo modules. It is not available in Expo Go and Snack yet.

Add the package to your dependencies with the following commands:

npx expo install expo-image
npx pod-install

Contributing

Contributions are very welcome! Please refer to guidelines described in the contributing guide.