GitHub - react-native-training/react-native-elements: Cross Platform React Nativ... - JOYK Joy of Geek, Geek News, Link all geek

README.md

React Native Elements

Cross Platform React Native UI Toolkit

Get Started

Installation

Follow these instructions to install React Native Elements !

Usage

Start using the components or try it on Snack here.

import { Button } from 'react-native-elements';

<Button />;

Components included:

RNE Ecosystem:

React Native Elements also serves as a platform that connects small teams/individuals that needs help developing their RN app with open source contributors that are willing to build complex UI screens & animated interactions for ???.

Here are some of the screens that our developers have created so far:

If this sounds interesting and you would like to participate, kindly open a new issue with the design & spec of the UI screen that you need to be developed. One of our developers will respond to your issue with an estimate of time & cost.

It's built on top of RNE & Open Collective. If you have any feedback or would like to know more details about this kindly contact Monte Thakkar.

Expo Demo App

Checkout the official React Native Elements App on Expo which uses all of the React Native Elements components.

If you are looking to contribute to the React Native Elements App, click here to view the implementation & run the RNE expo app locally.

v1.0 Roadmap ???

Current release: 1.0.0-beta2

New Features:

Button component (re-write) - @monte9
Input component (re-write) - @monte9 & @xavier-villelegier
Search component - Platform specific (re-write) - @xavier-villelegier
Avatar component (refactored) - @monte9
Production-ready screens ??? - @monte9, @xavier-villelegier, @martinezguillaume
Launching RNE Ecosystem ✨?✨ - @monte9
ListItem component - Platform specific (re-write) - @martinezguillaume, @johot WIP
Themes support - NEW - @iRoachie WIP
React Native Web support - NEW - @Gregor1971 WIP - branch - PR

v1.0 TODO:

Update docs for Button component
Update docs for Input component
Update docs for Search component
Write detailed release notes with new features & breaking changes
Update react, react-native & other dependencies
Update docs for ListItem component (Pending rewrite of component) - $20
Write docs for Themes support (Pending completion of theme support) - $20
Create a compelling demo/example app for RNE + RNW (Checkout rn-web branch or this PR comment for context) - $50
Write docs for React Native Web support (Checkout rn-web branch or this PR comment for context) - $50
Recreate Settings page on iOS & android (to show listItem + searchBar + themes components) - WIP - @martinezguillaume

Feel free to reach out to us on our Slack channel if you have any questions about what to work on.

Release plan:

Since this is a beta release, any new installation of react-native-elements will get v0.19.0. If you would like to try out our v1.0.0 beta releases (we highly suggest you do), run the following command:

yarn add react-native-elements@beta

Since v1 has a lot of API changes (many of which are breaking changes due to re-written components), the v1.0.0 beta releases are meant to give our users a heads up and give them plenty of time to migrate their apps to v1.

The official v1.0.0 will be released around mid-March 2018 ?

Test v1.0 components

You can test new features of the v1.0.0 beta releases on Expo Snack by doing this:

import { Button } from 'react-native-elements'; // 1.0.0-beta2

This will install the v1.0.0-beta2 version of React Native Elements.

Documentation

View the full docs here

Contributing

Interested in contributing to this repo? Check out our Contributing Guide and submit a PR for a new feature/bug fix.

First Contributors

We encourage everyone to contribute & submit PR's especially first-time contributors. Look for the label good first issue on the issues. Click here to see them.

If there is something you's like to see or request a new feature, please submit an issue or a pull request.