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 и в вебе, так что можно построить одну дизайн-систему сразу для всех трёх платформ.
Это фреймворк или библиотека, которую я просто добавляю в своё приложение?Это библиотека компонентов, а не фреймворк для приложений: вы собираете интерфейс из готовых элементов — button, checkbox, flex, stack и других — внутри своего приложения на React или React Native. На неё вдохновили такие библиотеки, как Material UI и Chakra UI.
Как добавить её в свой проект?Установите её в приложение, созданное через Expo или React Native CLI, следуя официальным руководствам по настройке. Поддержка веба обеспечивается через 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, сгруппированных по категориям: раскладка, формы, отображение данных, уведомления, типографика, оверлеи, раскрытие (disclosure), медиа и иконки, анимации и другие — среди примеров button, checkbox, flex и stack.
Можно ли увидеть библиотеку в деле, прежде чем встраивать её в своё приложение?Да — демо-приложение KitchenSink показывает все компоненты в работе: кнопки, формы, иконки и не только. Есть также пример Todo-List, который можно изучить.
Creator
GeekyAnts
Size
69.3 MB
Stars
20.4K
Age
10y
Commits · 90 Days