React Native Gesture Image Viewer
Guide
2.x
Guide
English
2.x

Overview

Demo of react-native-gesture-image-viewer gestures

Have you ever struggled with implementing complex gesture handling and animations when building image galleries or content viewers in React Native?

Existing libraries often have limited customization options or performance issues. react-native-gesture-image-viewer is a high-performance universal gesture viewer library built on React Native Reanimated and Gesture Handler, providing complete customization and intuitive gesture support for not only images but also videos, custom components, and any other content.

Key Features

  • 🤌 Complete Gesture Support - Pinch zoom, double-tap zoom, swipe navigation, pan when zoomed-in, and vertical drag to dismiss
  • 🏎️ High-Performance Animations - Smooth and responsive animations at 60fps and beyond, powered by React Native Reanimated
  • 🎨 Full Customization - Total control over components, styles, and gesture behavior
  • 🎛️ External Control API - Trigger actions programmatically from buttons or other UI components
  • 🧩 Multi-Instance Management - Manage multiple viewers independently using unique IDs
  • 🧬 Flexible Integration - Use with Modal, React Native Modal, ScrollView, FlatList, FlashList, Expo Image, FastImage, and more
  • 🧠 Full TypeScript Support - Great developer experience with type inference and safety
  • 🌐 Cross-Platform Support - Runs on iOS, Android, and Web with Expo Go and New Architecture compatibility
  • 🪄 Easy-to-Use API - Simple and intuitive API that requires minimal setup