React Native Elements

Cross Platform React Native UI Toolkit

React Native Elements 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:

<input checked="" disabled="" type="checkbox"> Avatar
<input checked="" disabled="" type="checkbox"> Badge
<input checked="" disabled="" type="checkbox"> Button
<input checked="" disabled="" type="checkbox"> ButtonGroup
<input checked="" disabled="" type="checkbox"> Card
<input checked="" disabled="" type="checkbox"> Checkbox
<input checked="" disabled="" type="checkbox"> Form Elements
<input checked="" disabled="" type="checkbox"> HTML style headings
<input checked="" disabled="" type="checkbox"> Icon
<input checked="" disabled="" type="checkbox"> List and ListItem
<input checked="" disabled="" type="checkbox"> Pricing
<input checked="" disabled="" type="checkbox"> Rating
<input checked="" disabled="" type="checkbox"> Search Bar
<input checked="" disabled="" type="checkbox"> Slider
<input checked="" disabled="" type="checkbox"> Social Icons / Social Icon Buttons
<input checked="" disabled="" type="checkbox"> Tile

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-beta7

New Features:

<input checked="" disabled="" type="checkbox"> Button component (re-write) - @monte9
<input checked="" disabled="" type="checkbox"> Input component (re-write) - @monte9 & @xavier-villelegier
<input checked="" disabled="" type="checkbox"> Search component - Platform specific (re-write) - @xavier-villelegier
<input checked="" disabled="" type="checkbox"> Avatar component (refactored) - @monte9
<input checked="" disabled="" type="checkbox"> Production-ready screens 🔥 💯 🎸 - @monte9, @xavier-villelegier,
```
@martinezguillaume
```
<input checked="" disabled="" type="checkbox"> Launching RNE Ecosystem ✨🚀✨ - @monte9
<input checked="" disabled="" type="checkbox"> ListItem component - Platform specific (re-write) -
```
@martinezguillaume, @johot
```
<input checked="" disabled="" type="checkbox"> Themes support - NEW - @iRoachie

<input disabled="" type="checkbox"> React Native Web support - NEW - @Gregor1971 WIP -

[branch](https://github.com/react-native-training/react-native-elements/tree/rn-web) -
[PR](https://github.com/react-native-training/react-native-elements/pull/867)

v1.0 TODO:

<input checked="" disabled="" type="checkbox"> Update docs for Button component
<input checked="" disabled="" type="checkbox"> Update docs for Input component
<input checked="" disabled="" type="checkbox"> Update docs for Search component
<input checked="" disabled="" type="checkbox"> Write detailed release notes with new features & breaking changes
<input checked="" disabled="" type="checkbox"> Update react, react-native & other dependencies
<input checked="" disabled="" type="checkbox"> Update docs for ListItem component -
```
**[$20](https://opencollective.com/react-native-elements#budget)**
```
<input checked="" disabled="" type="checkbox"> Write docs for Themes support -
```
**[$20](https://opencollective.com/react-native-elements#budget)**
```

<input disabled="" type="checkbox"> Create a compelling demo/example app for RNE + RNW (Checkout

[rn-web](https://github.com/react-native-training/react-native-elements/tree/rn-web)
branch or
[this PR comment](https://github.com/react-native-training/react-native-elements/pull/867#issuecomment-362312699)
for context) -
**[$50](https://opencollective.com/react-native-elements#budget)**

<input disabled="" type="checkbox"> Write docs for React Native Web support (Checkout

[rn-web](https://github.com/react-native-training/react-native-elements/tree/rn-web)
branch or
[this PR comment](https://github.com/react-native-training/react-native-elements/pull/867#issuecomment-362312699)
for context) -
**[$50](https://opencollective.com/react-native-elements#budget)**

<input disabled="" type="checkbox"> 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.1. 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 December 2018 🎉

Test v1.0 components

You can test new features of the v1.0.0 beta releases on Expo Snack by modifying the package.json file:

"react-native-elements": "^1.0.0-beta"

This will install the latest beta release 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.

Slack Community

In case you have any other question or would like to come say Hi! to the RNE community, join our Slack team. See you on the other side! 👋😃

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Package detail

@deboxsoft/react-native-elements

readme