miguelramosfdz / nativebase

Essential cross-platform UI components for React Native

NativeBase

Essential cross-platform UI components for React Native

Updated docs here!

For people having trouble upgrading to 2.1.5, check this.

Use v2.2.1 with latest react-native version(0.46). Older versions may break.

Table of Content

1. What is NativeBase?
2. Why NativeBase?
3. KitchenSink App
4. Getting Started
5. Components
6. Compatibility Versions
7. Native Starter Kit
8. NativeBase Market
9. Documentation
10. Website
11. Quick Links to NativeBase
12. About the creators

1. What is NativeBase?

NativeBase is a sleek, ingenious and dynamic front-end framework created by passionate React Loving team at Geekyants.com to build cross platform Android & iOS mobile apps using ready to use generic components of React Native.

2. Why NativeBase?

What is really great with NativeBase is that you can use shared UI cross-platform components, which will drastically increase your productivity. When using NativeBase, you can use any native third-party libraries out of the box.

Recommended by Microsoft

If you're looking to get started with React Native + CodePush, and are looking for an awesome starter kit, you should check out Native Starter Pro - Microsoft's react-native-code-push repo

Recommended by Awesome React Native

NativeBase added into the list of Frameworks of Awesome React Native and are also used by many other React lovers across the world.

4. Getting Started

a. Setup with pure React Native app

Install NativeBase

npm install native-base --save

Install Peer Dependencies
The peer dependencies included from any npm packages does not automatically get installed. Your application will not depend on it explicitly.

react-native link

You've successfully setup NativeBase with your React Native app. Your React Native app is now all set to run on iOS and Android simulator.

b. Setup with CRNA

Create React Native project using the CRNA cli.
CRNA helps you make React Native apps with no build configuration. Create React App works on macOS, Windows, and Linux.
Refer this link for additional information CRNA

Install NativeBase

npm install native-base --save

Install @expo/vector-icons

npm install @expo/vector-icons --save

Note
NativeBase uses some custom fonts that can be loaded using loadAsync function. Check out this expo link.
Syntax

async componentWillMount() {
      await Expo.Font.loadAsync({
        'Roboto': require('native-base/Fonts/Roboto.ttf'),
        'Roboto_medium': require('native-base/Fonts/Roboto_medium.ttf'),
        'Ionicons': require('@expo/vector-icons/fonts/Ionicons.ttf'),
      });

Check out the KitchenSink with CRNA for an example of the implementation.
Find the KitchnSink repo here

5. Components

NativeBase is made from effective building blocks referred to as components. The Components are constructed in pure React Native platform along with some JavaScript functionality with rich set of customisable properties. These components allow you to quickly build the perfect interface.

6. Compatibility Versions

NativeBase	React Native
v0.1.1	v0.22 to v0.23
v0.2.0 to v0.3.1	v0.24 to v0.25
v0.4.6 to v0.4.9	v0.26.0 - v0.27.1
v0.5.0 to v0.5.15	v0.26.0 - v0.37.0
v0.5.16 to v0.5.20	v0.38.0 - v0.39.0
v2.0.0-alpha1 to v2.1.3	v0.38.0 to v0.43.0
v2.1.4 to v2.1.5	v0.44.0 to v0.45.0
v2.2.0	v0.44.0 to v0.45.0
v2.2.1	v0.46.0 and above
v2.3.0	v0.46.0 and above (does not support React 16.0.0-alpha.13)

7. Native Starter Kit

A simple starter project for React Native + NativeBase + Redux + CodePush + React Native Navigator apps on iOS and Android. Take a look at the demo

8. NativeBase Market

Having tried with the free version, Native Starter Kit and appreciate our product?

Get on the mobile fast track with the featured apps of NativeBase, to build high-quality iOS and Android mobile apps.
A marketplace for premium React Native app themes to build high-quality iOS and Android mobile apps.

9. Documentation

Go through NativeBase Docs to play with NativeBase.

10. Website

https://nativebase.io/

11. Quick Links to NativeBase

• NativeBase Documentation
• NativeBase Blog
• NativeBase on Twitter
• NativeBase on FaceBook

12. About the creators

We are GeekyAnts, a startup based in Bangalore, India with 50+ developers in strength. We have been very active in the React / React Native community where we have developed StrapUI and StartReact. Our other products include StartLaravel and StartAngular.