Skip to content
Get packs

react-native-swiper

A swipeable carousel component for React Native apps, with looping, autoplay and pagination dots.

GitHub Download v1.6.0
Stars
10.5k
Forks
2.3k
Licence
MIT
Language
JavaScript
Last update
9 months ago
Type
Library

What it is

react-native-swiper is a JavaScript component library for React Native that displays a set of pages you can swipe through horizontally or vertically, such as image carousels or onboarding screens. You wrap your views in a Swiper element and it handles the swiping, optional looping, autoplay, and pagination indicators. It is a developer tool: you add it to a React Native project rather than running it on its own.

  • Show a rotating banner of promotional images at the top of a home screen
  • Build a three-screen onboarding flow with swipe navigation
  • Display a looping product photo gallery with dot indicators
  • Show numbered pages with previous and next buttons using showsButtons

Great for

  • React Native developers who need a swipeable image or content carousel
  • Teams building onboarding or welcome screens with several pages
  • Developers who want built-in autoplay and dot pagination without writing them from scratch

Not ideal for

  • Non-developers looking for a finished app, since it is a component to build into your own project
  • Projects that need very custom gesture behavior beyond what the documented props provide, as the README covers a fixed set of options
  • Anyone using a React Native version far from the 0.60-era examples mentioned in the changelog, without checking compatibility first
Step-by-step guide: how to use react-native-swiperInstall, first run, examples, tips and FAQs
react-native-swiper alternatives

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js · React Native project (react-native-cli is referenced in the README)

    Install the library

    npm i react-native-swiper --save
  2. 2

    Run it

    • Create or open a React Native project
    • Install the package with npm
    • Import Swiper from 'react-native-swiper' in your component
    • Wrap two or more View elements inside a Swiper element and run the app
  3. 3

    Get the most out of it

    • Use showsButtons={true} to add previous and next controls
    • Set autoplay to true to rotate slides automatically
    • Customize dots with dotColor, activeDotColor, dotStyle and activeDotStyle as described in the changelog
    • Use onIndexChanged to react when the user swipes to a new page
    • Use loadMinimal options listed in the changelog to reduce rendering for long slide lists

Downloads

Source code (.zip)master branch · straight from GitHubRelease v1.6.0Release notes and source

Strengths

  • Simple setup: wrap child views in a Swiper element and it works, as shown in the README's basic example
  • Covers common needs such as looping, autoplay, pagination dots and navigation buttons
  • MIT licensed and widely starred, with a changelog showing ongoing releases

Trade-offs

  • The README is truncated and the latest release is marked as a release candidate in the changelog, so check the current documentation before relying on it
  • Installation for the newer version uses a @next tag, which may be less stable than the default release
  • Documentation links to older image hosts and some examples reference old React Native versions

How it compares

ProjectStarsTypeLevelUpdatedBest for
react-native-swiper (this)10.5kLibrarybeginner9 months agoReact Native developers who need a swipeable image or content carousel
react-native-elements25.9kLibraryintermediate6 months agoReact Native developers who want ready-made UI components
react-native-web22.2kLibraryintermediate4 days agoDevelopers who already use React Native and want the same components on the web
NativeBase20.4kLibraryintermediate9 months agoTeams maintaining an existing app already built on NativeBase
react-native-maps16kLibraryintermediate17 days agoReact Native developers adding a map screen to an iOS or Android app
react-native-paper14.5kLibraryintermediate4 days agoReact Native developers who want ready-made Material Design components

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.