- Sizing:
stylecontrols the container size;itemWidth/itemHeightcontrol the page size (snap distance & animation progress). - Scroll offset shared value: use
scrollOffsetValue(recommended).defaultScrollOffsetValueis deprecated but still supported. - Progress:
onProgressChangesupports both a callback andSharedValue<number>.
| 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+ | ❌ |
MIT