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