An open API service indexing awesome lists of open source software.

https://github.com/zonayedpca/react-native-welcome

Simple way to add interactive user instruction to let your user know about your app before start using it...
https://github.com/zonayedpca/react-native-welcome

react-native react-native-instruction react-native-slider react-native-welcome react-native-welcome-screen

Last synced: about 2 months ago
JSON representation

Simple way to add interactive user instruction to let your user know about your app before start using it...

Awesome Lists containing this project

README

        

# react-native-welcome

[![Build Status](https://travis-ci.com/zonayedpca/react-native-welcome.svg?token=LXmMpgxtChnPA2Z3yHVr&branch=master)](https://travis-ci.com/zonayedpca/react-native-welcome)

Welcome your user with useful instructions. Check out these screenshots:

![Welcome Screen](https://user-images.githubusercontent.com/18544717/67630621-a9e80b00-f8b0-11e9-8ac6-79a78604aee0.jpg) ![Middle Screen](https://user-images.githubusercontent.com/18544717/67630623-a9e80b00-f8b0-11e9-8c01-2369dfe37f60.jpg) ![Just Another Screen](https://user-images.githubusercontent.com/18544717/67630624-a9e80b00-f8b0-11e9-9588-6cf2aa2b3b61.jpg) ![As many as you want](https://user-images.githubusercontent.com/18544717/67630933-03eacf80-f8b5-11e9-9bed-df517609635d.jpg) ![Last Screen](https://user-images.githubusercontent.com/18544717/67630626-aa80a180-f8b0-11e9-9a3e-13ddd4aeda3b.jpg)

## Getting started

Simply add it as a dependency:

`$ npm install --save react-native-welcome`

Or if you're using yarn:

`$ yarn add react-native-welcome`

That's it! You're ready to go!

## Usage

Simply import it:

```javascript
import Welcome from "react-native-welcome";
```

And then Use it in a screen, you must need to set your screen so that it can take entire screen. It will take as much as it gets:

```javascript

```

### Props

It has a default starter appearance. But you can always modify it as much as you want by utilizing these props:

- `bgColor`: Defines the color of entire background. Default is set to `#fff`

- children: Pass the elements as `children` to show them on the screen individually.

```javascript

Welcome!!!
Peace be upon you
Make something great
Pass your elements as children to control this area
Once you are done, can skip it

```

- `elementContainerStyle`: Defines the styling of the each elements' container mentioned above. Defaults to:

```javascript
{{
flex: 1,
width: SCREEN_WIDTH,
}}
```

- `barBgColor`: The background color of the StatusBar. Defaults to `#eee`

- `barStyle`: The style of the StatusBar content. Defaults to `dark-content`. Also can be `light-content`(React native defaults)

- `showIndicator`: Show indicators for the each screens. Defaults to `false`, can be `true`

- `onDone`: is invoked when the user goes at the last screen and choose to finish the welcome screens

- `navStyle`: Defines the styling for the nav for the screens. Defaults to:

```javascript
{{
padding: 20,
borderTopWidth: 2,
backgroundColor: "#eee",
borderColor: "#333"
}}
```

- `prevArrow`: Defines the element for previous screen button. Can be anything.

- `nextArrow`: Defines the element for screen screen button. Can be anything.

- `doneIcon`: Defines the element for finished screen button. Can be anything.

- `dotColor`: Defines the color of the active dots in the nav. Defaults to `#fff`

- `dotBg`: Defines the color of the inactive dots in the nav. Defaults to `#000`