Cached image component for Expo's managed workflow

Usage no npm install needed!

<script type="module">
  import reactNativeExpoCachedImage from '';



npm version

Cached image component for Expo's managed workflow

⚙️ Installation

yarn add react-native-expo-cached-image

🚀 Quick Start

import CachedImage from 'react-native-expo-cached-image';

// In render()
<CachedImage style={styles.imageStyle} source={{ uri: '' }}/>

The CachedImage component downloads the image to the user's local filesystem using a deterministic hash of the URI as the path key. If the image is already downloaded, it will be rendered without re-downloading.


CachedImage is a direct wrapper of the standard React Native Image and matches it's API. As such, all of the standard props are available as props to CachedImage. Styles are also passed down.


CachedImage can optionally be used as a wrapper of React Native's ImageBackground. To do so, pass in the prop isBackground={true}.

import CachedImage from 'react-native-expo-cached-image';

// In render()
<CachedImage style={styles.imageStyle} isBackground={true} source={{ uri: '' }}/>

💬 Contact

Twitter Follow

Submit an issue (above in the issues tab)

🙏🏻 Compatibility

CachedImage Has been tested with the react-native Expo managed workflow. If you have success with other workflows let us know!

👏 Contributing

We love help! Contribute by forking the repo and opening pull requests.

Please ensure that your code passes the existing tests and linting. Write tests to test your changes if applicable.

Don't make stylistic or whitespace changes without contacting maintainers - we probably won't approve unsolicited stylistic changes.

All pull requests should be submitted to the "master" branch.

yarn lint
yarn test