photo-viewer
A React Native photo viewer component with double-tap zoom, captions, and animated presentation.
What is photo-viewer?
React Native Photo Viewer is a native photo viewer component for React Native apps that provides an interactive, gallery-like experience for viewing images. It solves the need for a polished, performant image viewer with gestures like double-tap zoom and flick-to-dismiss, supporting both remote and local images.
React Native developers building mobile apps that require image galleries or photo viewing features, such as social media, e-commerce, or photography applications.
Developers choose this library because it wraps mature native libraries (NYTPhotoViewer and FrescoImageViewer), ensuring smooth animations and platform-consistent gestures, while offering easy integration and support for captions, GIFs, and multiple image sources.
Overview
A photo picture viewer for React Native
Use Cases
Best For
- Adding a photo gallery to a React Native social media app
- Implementing product image viewers in e-commerce mobile apps
- Creating image-heavy content viewers for news or magazine apps
- Building photography or portfolio apps with zoomable images
- Displaying user-generated content with captions and summaries
- Showing GIFs and animated images in a native viewer
Not Ideal For
- Apps targeting Android API levels above 25, as the library enforces an outdated targetSdkVersion
- Projects needing a zero-configuration, drop-in image viewer without manual native linking or dependency management
- Teams requiring deep UI customization beyond basic caption colors and standard gestures
- Expo-managed workflows, since it requires native code modifications and linking
Pros & Cons
Pros
Built on NYTPhotoViewer (iOS) and FrescoImageViewer (Android), ensuring platform-specific smooth animations and gestures like double-tap zoom and flick-to-dismiss for a polished feel.
Handles remote URLs, local files, Camera Roll images, and GIFs seamlessly, as demonstrated in the usage examples with various source types.
Allows titles and summaries with customizable hex colors (e.g., titleColor: '#f90000'), enhancing content presentation in galleries without extra styling.
Includes double-tap to zoom and swipe-down to dismiss, providing a native-like interactive experience that matches user expectations on iOS and Android.
Cons
Requires manual linking of frameworks on iOS (CocoaPods, Carthage, or manual) and Fresco initialization on Android, with multiple error-prone steps detailed in the README.
Forces targetSdkVersion to 25, which is below current Android standards and may cause compatibility issues with newer APIs or security updates.
Known issues and workarounds are mentioned without comprehensive solutions, and advanced customization beyond basic props is not well-documented.
Frequently Asked Questions
Related Projects
react-native-vector-iconsCustomizable Icons for React Native with support for image source and full styling.
lottie-react-nativeLottie wrapper for React Native.
react-native-mapsReact Native Mapview component for iOS + Android
react-native-gifted-chat💬 The most complete chat UI for React Native
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.