NativeBase

Mobile-first, accessible components for React Native & Web to build consist...

React Native Component Toolkit

GeekyAnts/NativeBase nativebase.io/native-base

README

Financial Contributors on Open Collective

NativeBase is a mobile-first, accessible component library for building a consistent design system across android, iOS & web.

[Website](https://nativebase.io/)

[Documentation](https://docs.nativebase.io/)

1. Introduction

2. Motivation

3. Features

4. Dependencies

5. Installation & Setup

6. Components

7. Examples

8. KitchenSink App

9. Tech Stack

10. Compatible Versions

11. Contributors

12. Changelog

13. Community

14. License

1. Introduction?

NativeBase is a mobile-first, component library for React & React Native. Version 3.0 ships with complete ARIA integration, support for utility props and nearly 40 components that are consistent across Android, iOS and Web. Fast-track your dev process with NativeBase 3.0.

Recommended by Awesome React Native

NativeBase was added to the list of Frameworks of Awesome React Native and it is used by numerous React lovers across the world.

2. Motivation

Building with React Native from scratch is a tedious process with multiple steps such as adding styling, interactions, state management, responsiveness, accessibility, etc. We wanted to build and ship accessible, high-quality apps quickly.

Our inspirations include Material UI, Chakra UI, Ant Design, Braid Design System, Bootstrap, TailwindCSS & Flutter.

3. Features

Out of the Box Accessibility

Integrated with React ARIA and React Native ARIA, which provides React hooks. This enables you to build accessible design systems in no time.

Supporting Utility Props

Rich Component Library

NativeBase offers around 40 components so you can build seamlessly. It includes button, checkbox, flex, stack and more.

Highly Themeable

Themeability is one of the core elements of NativeBase. You can customise your app theme and component styles to your heart's content.

Available for Both Mobile and Web

NativeBase 3.0 is powered by React Native Web so you can build consistent UIs across Web, Android and iOS.

Responsiveness Made Easy

Instead of manually adding responsiveness, NativeBase 3.0 allows you to provide object and array values to add responsive styles.

Now with Dark Mode

Building apps with a dark mode setting just got a whole lot easier. NativeBase is now optimised for light and dark modes.

4. Dependencies

React Native, Expo

5. Installation

NativeBase is supported in Expo or React Native CLI initiated apps. Web support is made possible by react-native-web.

Refer the guides to setup NativeBase in your React app.

6. Components

NativeBase 3.0 is a rich component library with nearly 40 components.

- [Layout](https://docs.nativebase.io/box)

- [Forms](https://docs.nativebase.io/button)

- [Data Display](https://docs.nativebase.io/badge)

- [Feedback](https://docs.nativebase.io/alert)

- [Typography](https://docs.nativebase.io/text)

- [Overlay ](https://docs.nativebase.io/alert-dialog)

- [Disclosure](https://docs.nativebase.io/action-sheet)

- [Media & Icons](https://docs.nativebase.io/avatar)

- [Transition](https://docs.nativebase.io/presence-transition)

- [Other](https://docs.nativebase.io/fab)

7. Examples

Check out the Todo-List example

8. KitchenSink App

Kitchen Sink is a comprehensive demo app showcasing all the NativeBase components in action. It includes buttons, forms, icons, etc.

9. Tech Stack

JavaScript, React Native, Styled System

10. Compatible Versions

NativeBase	React
--------------------------------	----------------------------------------------------------
v0.1.1	v0.22
v0.2.0	v0.24
v0.4.6	v0.26.0
v0.5.0	v0.26.0
v0.5.16	v0.38.0
v2.0.0-alpha1	v0.38.0
v2.1.4	v0.44.0
v2.2.0	v0.44.0
v2.2.1	v0.46.0
v2.3.0	v0.46.0
v2.7.0	v0.56.0
v3.0.0-next.36	v0.63.0
v3.0.0	v0.63.0