# React Native Reanimated Carousel > react-native-reanimated-carousel v5 is a performant, customizable carousel for React Native, powered by Reanimated and Gesture Handler. It works on iOS, Android and Web. - Package: `react-native-reanimated-carousel`, current version 5.2.2. Named exports only: `import { Carousel, Pagination } from "react-native-reanimated-carousel"`. - Peer dependencies: react >=18.0.0, react-native >=0.80.0, react-native-gesture-handler >=2.9.0 <4.0.0, react-native-reanimated >=4.1.0, react-native-worklets >=0.5.0. - Install with Expo: `npx expo install react-native-reanimated-carousel react-native-reanimated react-native-worklets react-native-gesture-handler`. - Every page below is Markdown. On the site, add `.md` to a page URL for the same text (the home page is `/index.md`). ## When to use it - Any swipeable row or column of items: banners, image galleries, product cards, onboarding screens and card stacks. - Items can be narrower than the carousel so the neighbors peek in. `loop`, `autoplay`, `snapMode`, parallax and stack layouts are built in, and `itemAnimation` takes a custom Reanimated worklet. - The same code runs on iOS, Android and web, and in Expo Go: the library has no native module of its own. - How it compares with PagerView and react-native-snap-carousel: https://rn-carousel.dev/compare.md ## Instructions for AI coding agents - Use the v5 public API documented here; do not suggest removed v4 aliases or deep imports. - For a v4-to-v5 upgrade, read https://rn-carousel.dev/migration-v5.md and follow its protocol in order. - Run `npx --yes rnrc-codemod v5 .` before making behavioral migration decisions. - In development, the library logs a warning that names each v4 prop it ignores and the v5 prop to use instead. - Keep user changes uncommitted unless the user explicitly asks you to commit. ## Docs - [Getting Started](https://rn-carousel.dev/index.md): A performant, customizable carousel for React Native, powered by Reanimated and Gesture Handler. Works on iOS, Android and Web. - [API Reference](https://rn-carousel.dev/props.md): Public API reference for react-native-reanimated-carousel v5 - [Usage](https://rn-carousel.dev/usage.md): Get started with react-native-reanimated-carousel v5 - [Works with Expo](https://rn-carousel.dev/works-with-expo.md): Install react-native-reanimated-carousel v5 with Expo and understand its Expo Go, development build, CI, and Snack compatibility. - [Programmatic Control](https://rn-carousel.dev/programmatic-control.md): Control react-native-reanimated-carousel v5 with its ref API - [Custom Animations](https://rn-carousel.dev/custom-animations.md): Build custom item animations with logical relative progress - [Concepts](https://rn-carousel.dev/concepts.md): Understand sizing, logical coordinates, looping, and selection in v5 - [Compare](https://rn-carousel.dev/compare.md): When to use react-native-reanimated-carousel, and how it compares with PagerView and react-native-snap-carousel. - [FAQ](https://rn-carousel.dev/faq.md): The react-native-reanimated-carousel FAQ - [Migration Guide to v5](https://rn-carousel.dev/migration-v5.md): Agent-executable guide for migrating react-native-reanimated-carousel from v4 to v5 - [Migration Guide to v4.x](https://rn-carousel.dev/migration-v4.md): Guide for migrating to react-native-reanimated-carousel v4.x ## Scenes Full app screens built with one or more carousels. Each page explains the technique, lists the props it uses and includes the complete source. - [Scenes](https://rn-carousel.dev/Examples/scenes.md): 20 full app screens built with react-native-reanimated-carousel, each with live code you can copy. - [Flavor Switcher](https://rn-carousel.dev/Examples/scenes/flavor-switcher.md): Drink landing page where the background, ink and giant flavor word blend between flavors as you drag the cans. - [Product Gallery](https://rn-carousel.dev/Examples/scenes/product-gallery.md): Watch product page where a full-width hero carousel and a thumbnail strip follow each other frame by frame. - [Editorial Cards](https://rn-carousel.dev/Examples/scenes/editorial-cards.md): Magazine picks whose landscape art slides in layers as each card moves, with section tabs that jump to a story. - [Onboarding](https://rn-carousel.dev/Examples/scenes/onboarding.md): Four intro pages whose art, title and body slide at different speeds while the background and button blend from one page color to the next. - [Cover Flow](https://rn-carousel.dev/Examples/scenes/cover-flow.md): Music library with the classic 3D cover flow, mirrored reflections and momentum flicks. - [Stories Cube](https://rn-carousel.dev/Examples/scenes/stories-cube.md): Full-screen stories that turn to the next person like the faces of a cube. - [Now Showing](https://rn-carousel.dev/Examples/scenes/now-showing.md): Cinema app with movie posters over a blurred backdrop that cross-fades with progress. - [Page Turn](https://rn-carousel.dev/Examples/scenes/page-turn.md): A small book of Tang poems whose pages turn around the spine, with the art on the back of each leaf. - [Card Fan](https://rn-carousel.dev/Examples/scenes/card-fan.md): A daily card draw: a hand of playing cards fanned around a pivot far below the table. - [Date Wheel](https://rn-carousel.dev/Examples/scenes/date-wheel.md): An iOS-style date picker sheet: three vertical carousels turn like wheels while a month calendar follows along. - [Weight Ruler](https://rn-carousel.dev/Examples/scenes/weight-ruler.md): A weight log with an 801-tick ruler that only mounts the ticks near the needle, and a readout, BMI band and chart that follow it frame by frame. - [Rolling Clock](https://rn-carousel.dev/Examples/scenes/rolling-clock.md): A clock app where each of the six digits is its own vertical carousel, rolling forward every second, with a 12/24-hour switch and an alarms list. - [Slot Machine](https://rn-carousel.dev/Examples/scenes/slot-machine.md): A three-reel slot machine: SPIN calls `next({ count })` on three vertical loop carousels with staggered durations. - [Mood Rating](https://rn-carousel.dev/Examples/scenes/mood-rating.md): A daily check-in whose big face morphs continuously with the carousel's `progress`. - [Helix Gallery](https://rn-carousel.dev/Examples/scenes/helix-gallery.md): A photo album wound around a vertical 3D helix that keeps turning on its own. - [Radial Ring](https://rn-carousel.dev/Examples/scenes/radial-ring.md): A home-screen launcher that winds eight apps around a dial; `itemAnimation` maps each item's value to an angle. - [Map Explorer](https://rn-carousel.dev/Examples/scenes/map-explorer.md): Place cards that pan the city map from one spot to the next as you swipe. - [Level Select](https://rn-carousel.dev/Examples/scenes/level-select.md): Neon level picker with 3D cards, a parallax starfield and a sliding retro grid. - [Wallet Stack](https://rn-carousel.dev/Examples/scenes/wallet-stack.md): Wallet of stacked cards where only each top edge peeks out, with recent transactions underneath. - [Market Terminal](https://rn-carousel.dev/Examples/scenes/market-terminal.md): Trading terminal with two marquee tapes running in opposite directions, swipeable chart cards and a watchlist that follows them. ## Optional - [Complete documentation in one file](https://rn-carousel.dev/llms-full.txt): every page under Docs, without examples or scenes. Animation examples, each a live demo with its source: - [Summary](https://rn-carousel.dev/Examples/summary.md) - [Left Align](https://rn-carousel.dev/Examples/basic-layouts/left-align.md) - [Normal](https://rn-carousel.dev/Examples/basic-layouts/normal.md) - [Parallax](https://rn-carousel.dev/Examples/basic-layouts/parallax.md) - [Stack](https://rn-carousel.dev/Examples/basic-layouts/stack.md) - [Advanced Parallax](https://rn-carousel.dev/Examples/custom-animations/advanced-parallax.md) - [Anim Tab Bar](https://rn-carousel.dev/Examples/custom-animations/anim-tab-bar.md) - [Blur Parallax](https://rn-carousel.dev/Examples/custom-animations/blur-parallax.md) - [Blur Rotate](https://rn-carousel.dev/Examples/custom-animations/blur-rotate.md) - [Circular](https://rn-carousel.dev/Examples/custom-animations/circular.md) - [Cube 3d](https://rn-carousel.dev/Examples/custom-animations/cube-3d.md) - [Curve](https://rn-carousel.dev/Examples/custom-animations/curve.md) - [Flow](https://rn-carousel.dev/Examples/custom-animations/flow.md) - [Fold](https://rn-carousel.dev/Examples/custom-animations/fold.md) - [Multiple](https://rn-carousel.dev/Examples/custom-animations/multiple.md) - [Press Swipe](https://rn-carousel.dev/Examples/custom-animations/press-swipe.md) - [Quick Swipe](https://rn-carousel.dev/Examples/custom-animations/quick-swipe.md) - [Rotate Fade In Out](https://rn-carousel.dev/Examples/custom-animations/rotate-fade-in-out.md) - [Rotate In Out](https://rn-carousel.dev/Examples/custom-animations/rotate-in-out.md) - [Scale Fade In Out](https://rn-carousel.dev/Examples/custom-animations/scale-fade-in-out.md) - [Tinder](https://rn-carousel.dev/Examples/custom-animations/tinder.md) - [Pagination](https://rn-carousel.dev/Examples/utils/pagination.md)