0.1.0 • Published 9 months ago

react-native-onboard-component v0.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

Onboarding Swiper for React Native

A smooth and customizable onboarding swiper/slider for your React Native applications.

Features

  • Horizontal swipe to navigate between slides.
  • Customizable buttons for navigation.
  • Supports both text and custom React components for navigation buttons.
  • Customizable styles for title, description, and image.
  • Indicator dots to represent the slide position.

Installation

npm install react-native-onboard-component

Or using yarn:

yarn add react-native-onboard-component

Usage

Here's a basic example of how to use the Onboarding Swiper:

import OnboardingSwiper from 'react-native-onboard-component';

const slidesData = [
  {
    image: require('./path-to-image1.png'),
    title: 'Welcome',
    description: 'Description for first slide.',
  },
  // ... Add more slides as needed.
];

function App() {
  return (
    <OnboardingSwiper
      data={slidesData}
      onDone={() => {
        console.log('Onboarding completed!');
      }}
    />
  );
}

export default App;

Props

Here's a list of all the available props:

PropTypeDescriptionDefault
dataArray of SlideDataThe data for the slides.Required
deactiveColorstringThe color of the inactive dots.'#e8f1fe'
activeColorstringThe color of the active dot.'#2871e3'
onDonefunctionCallback fired after the onboarding is completed.None
nextLabelstring OR ReactNodeLabel for the 'Next' button.'Next'
doneLabelstring OR ReactNodeLabel for the 'Done' button.'Done'
bottomContainerStyleStylePropCustom style prop for the button container.None
buttonColorstringThe color of the navigation button text.'#2871e3'
titleStyleStylePropCustom style prop for the slide title.None
descriptionStyleStylePropCustom style prop for the slide description.None
textContainerStyleStylePropCustom style prop for the text container of each slide.None
imageStyleStylePropCustom style prop for the slide images.None

Important Note

For optimal display, the aspect ratio of images used should be 9:19, i.e., 1080x2280 pixels.

License

MIT

0.1.0

9 months ago