NativeBase README

The project's README from github.com/GeekyAnts/NativeBase. As one markdown file: README.md.

⛔️ DEPRECATED

NativeBase ↔ gluestack

🚀 NativeBase is evolving into gluestack-ui! What was planned as NativeBase v4 is now available as gluestack-ui - our next-generation component library built for better performance, enhanced customization, and improved developer experience. Visit gluestack.io to get started!

Important Notice: Evolution to gluestack-ui

NativeBase is entering maintenance mode as we evolve into gluestack-ui. This transition represents our commitment to providing the React Native community with more powerful, flexible, and performant UI components. If you are starting a new project with NativeBase, we recommend using gluestack-ui instead. Know More.

Nativebase Logo

Financial Contributors on Open Collective npm next package npm latest package npm downloads license Follow on Twitter Github Stars

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

Website
Documentation

About GeekyAnts

NativeBase is built and maintained by GeekyAnts, a product development studio with expertise in:

Get Professional Support

Need help implementing NativeBase in your project? Contact our mobile engineering team for:

Explore all services | View our open source projects

Table of Contents

  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.

Out of the box accessibility

Supporting Utility Props

Powered by Styled System so you can rapidly build custom UI components with constraint-based utility style 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.

Nativebase Logo

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.

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.

Kitchensink App gif Kitchensink App QR code

9. Tech Stack

JavaScript, React Native, Styled System

Made with :heart: at GeekyAnts

NativeBase is an open-source project made by the tech-savvy geeks at GeekyAnts. GeekyAnts is a group of React Native experts. Do get in touch with us for any help with your React Native project. Always happy to help!

10. Compatible 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 to 2.6.1 v0.46.0 and above (does not support React 16.0.0-alpha.13)
v2.7.0 v0.56.0 and above
v3.0.0-next.36 to v3.0.0-next-41 v0.63.0 and above
v3.0.0 to latest v0.63.0 and above

11. Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

12. Changelog

Check out the changelog in the official documentation

13. Community

14. License

Licensed under the MIT License, Copyright © 2021 GeekyAnts. See LICENSE for more information.

Built with ❤️ by GeekyAnts | React Native Experts

NativeBase (GeekyAnts/NativeBase)

Searching Database…

这是什么?NativeBase 是一个面向移动优先、注重无障碍访问的 React 和 React Native 组件库:包含近 40 个 UI 组件,在 Android、iOS 和 Web 上表现一致,让你可以用一套设计系统覆盖这三个平台。
它是框架,还是引入到我的应用里的库?它是一个组件库,不是应用框架:在你自己的 React 或 React Native 应用里,用它的现成组件——按钮(button)、复选框(checkbox)、flex、stack 等——来搭建界面。它的设计灵感来自 Material UI 和 Chakra UI 这类库。
怎么把它加到我的项目里?把它安装到一个用 Expo 或 React Native CLI 创建的应用中,按照官方设置指南操作即可。Web 支持来自 react-native-web,所以同样的组件也能在浏览器里渲染。
我需要哪个版本的 React Native?v3 系列要求 React Native v0.63.0 或更高版本。技术栈是 React Native 加 Expo,无障碍访问层由一系列 React ARIA 包提供支持。
仓库里挂着弃用横幅——NativeBase 还能用吗?它已进入维护模式:开发工作转移到了后继项目 gluestack-ui,README 也建议任何新项目改用 gluestack-ui。现有应用仍然可以正常使用,但 NativeBase 本身不会再开发新功能。
gluestack-ui 是什么?新项目应该直接用它起步吗?它是 NativeBase 的后继者:原本计划作为 NativeBase v4 发布的内容,最终以 gluestack-ui 的名义推出,这是一个新一代组件库,性能更好、可定制性更强、开发体验也更佳。README 建议所有新项目都改用 gluestack-ui(gluestack.io)。
包含哪些组件?近 40 个,按布局、表单、数据展示、反馈、排版、浮层、展开收起、媒体和图标、过渡动画等分类——button、checkbox、flex 和 stack 都是其中的例子。
接入我的应用之前,能先看看实际效果吗?可以——KitchenSink 演示应用展示了所有组件的实际效果,包括按钮、表单和图标,还有一个 Todo-List 示例可以参考学习。
Creator
GeekyAnts
Size
69.3 MB
Stars
20.4K
Age
10y
Commits · 90 Days