react-native-reanimated-carousel is a carousel component for React Native that delivers smooth, performant swiping and scrolling across iOS, Android, and Web platforms using Reanimated v2 for animations and Gesture Handler for touch interactions.
The component solves the problem of building efficient, customizable carousel experiences in React Native without relying on platform-specific implementations. It leverages Reanimated's native thread animations and Gesture Handler's gesture recognition to achieve 60fps performance while supporting features like infinite looping, snap-to-item behavior, and RTL layout normalization. The API emphasizes explicit configuration through named parameters for layout type, item animation style, snap mode, and orientation, with TypeScript types providing clarity on available options.
Teams building image galleries, product showcases, or any horizontal scrolling interface in React Native should consider this tool. It suits projects targeting Expo or React Native CLI setups that can accommodate the required peer dependencies. The component includes a built-in Pagination component with loop-aware interpolation and accessible interactive dots, reducing boilerplate for common carousel UI patterns. The tool is appropriate for applications prioritizing animation performance and customization depth over minimal bundle size.
Development activity shows consistent refinement of the API surface, with the project having undergone a significant restructuring that introduced a smaller, more focused named-only API with improved TypeScript support. The maintainers have established clear version compatibility documentation across Expo SDK, React Native, Reanimated, and Gesture Handler versions, helping developers navigate the dependency landscape. Migration guidance from earlier versions is provided, indicating attention to the upgrade path for existing users.
