react-native-reanimated-carousel

The best carousel component in React Native community. ⚡️

• Getting Started
• Examples

v5 beta notes

• Sizing: style controls the container size; itemWidth/itemHeight control the page size (snap distance & animation progress).
• Scroll offset shared value: use scrollOffsetValue (recommended). defaultScrollOffsetValue is deprecated but still supported.
• Progress: onProgressChange supports both a callback and SharedValue<number>.
• Pagination accessibility: Pagination.Basic and Pagination.Custom support paginationItemAccessibility for per-item a11y overrides.
• Custom animation safety: customAnimation styles are sanitized and zIndex is normalized to finite integers.

📊 Version Compatibility

| Carousel Version | Expo SDK | React Native | Reanimated | Gesture Handler | Worklets | |------------------|----------|--------------|------------|-----------------|------------| | v5.0.0-beta | 54+ | 0.80+ | 4.0.0+ | 2.9.0+ | 0.5.0+ | | v4.x | 50-53 | 0.70.3+ | 3.0.0+ | 2.9.0+ | ❌ | | v3.x | 47-49 | 0.66.0+ | 2.0.0+ | 2.0.0+ | ❌ |

Sponsors

License

MIT