React-Native Components (RNComponents)

This project is a UI components repository that I usually use in mobile Applications.
Explore the docs

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

In order to reduce the effort to make new components in every new React-Native/Expo project I'm making this repository to store usefull UI components. It's used plain react-native components, react-native-reanimated v2 and react-native-gesture-handler packets to make animations and gesture interactions.

Here's a list of the components made so far:

• Banner
• Modal
• Numpad
• Swipe to complete button
• Page wrapper

(back to top)

Built With

• React-Native
• Expo

(back to top)

Getting Started

This is an example of how set up this project locally. To get a local copy up and running follow these simple steps.

Prerequisites

• expo

  yarn global add expo-cli

  or

  npm install -g expo-cli

  Install Expo Go app in your phone to run the project.

Installation

1. Clone the repo

   git clone https://github.com/sebastiaohns/RNComponents.git

2. Install NPM packages

   yarn

   or

   npm install

3. Run expo

   expo start

(back to top)

Usage

Below there's a demostration video of the components being used. Each component has a demo file that can be run and used to understand the funcionality of the component, also showing how to use it.

• Banner: pop up element that slide in from bottom to the center of the page.

  

• Modal: pop up element that slide in the bottom of the page.

  

• Numpad: in screen keypad that is used to insert values.

  

• Swipe button: element that use swipe gesture to trigger funcionality.

  

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Sebastião Santos - [email protected]

Project Link: https://github.com/sebastiaohns/RNComponents

(back to top)