Taro UI is an MIT-licensed component library for developers building cross-platform interfaces with the Taro framework, delivering one set of components that runs on WeChat, Alipay and Baidu mini programs, H5 and React Native.
What it is
Taro UI is a multi-end UI component library written in TypeScript and built on top of Taro, the multi-platform development solution from 凹凸实验室. It ships ready-made components that you import directly into a Taro project — for example import { AtButton } from 'taro-ui' — and it is published to npm as the taro-ui package, with documentation hosted at https://jd-opensource.github.io/taro-ui/.
The problem it addresses is the cost of writing separate code for every target platform. Because Web, React Native and mini programs such as WeChat's all have different runtimes, teams otherwise maintain several parallel codebases. Taro's compilation tooling lets a single source tree be compiled to each target, and Taro UI supplies the interface layer for that workflow, so the same components adapt and run across 微信小程序, 支付宝小程序, 百度小程序, H5 and ReactNative rather than being reimplemented per end.
Key capabilities
- One set of components adapts and runs on WeChat mini program, Alipay mini program, Baidu mini program, H5 and ReactNative from a single codebase.
- Components are consumed through ordinary imports, such as
AtButton, and follow APIs the README describes as friendly and flexible to use.
- Two version lines match the underlying framework:
npm install [email protected] for Taro versions below 3, and npm install taro-ui@latest for Taro versions 3 and above.
- An AI Native skill can be installed with
npx skills add https://raw.githubusercontent.com/jd-opensource/taro-ui/master/packages/taro-ui-guide/SKILL.md.
- Official usage documentation and an official example project are published, the demo living at https://github.com/NervJS/taro-ui-demo.
- A QR code in the README lets readers scan and try the components inside the WeChat ecosystem directly.
- Contribution is structured through a contributing guide at
.github/CONTRIBUTING.md, a ROADMAP.md, and an issue tracker currently holding 509 open issues.
Who uses it and how
- Developers extending Taro applications who need interface components that behave consistently across mini programs and H5 from one source tree.
- Teams targeting several mini program platforms at once — WeChat, Alipay and Baidu — without maintaining a separate component set for each.
- Projects still on Taro versions below 3 that pin
[email protected], alongside projects on Taro 3 and later that take taro-ui@latest.
- Contributors and adopters following the roadmap, whose current focus is a Monorepo refactor, CSS precompilation and Taro v4 compatibility verification.
- Developers seeking help through the project's issue tracker, its WeChat communication group linked from issue #16, and the Taro-UI section of the Taro forum.
Getting started
Install the package with npm install taro-ui@latest for Taro 3 or newer (or npm install [email protected] for older Taro versions), then import the components you need, such as AtButton, and follow the documentation.
How it compares
The provided facts list no paid products this project replaces, and no comparable component libraries are named alongside it. It therefore stands alone in this registry.
When to use it — and when not
Because it is a component library under the MIT licence, adopting it means operating no database, storage or SMTP of your own; the real commitment is to the Taro toolchain and its compilation targets. Do not choose it if you are not building on Taro, or if you need Taro v4 support today, since compatibility verification is still in progress on the roadmap. Note also the 509 open issues and the README's statement that the project is actively recovering maintenance, so expect rough edges while the Monorepo refactor and CSS precompilation land.
project readme (upstream, from github) — read inline
Taro UI

一款基于 Taro 框架开发的多端 UI 组件库
特性
- 基于
Taro 开发 UI 组件
- 一套组件可以在
微信小程序,支付宝小程序,百度小程序,H5,ReactNative 多端适配运行
- 提供友好的 API,可灵活的使用组件
关于 Taro
Taro 是由 凹凸实验室 倾力打造的多端开发解决方案。现如今市面上端的形态多种多样,Web、ReactNative、微信小程序等各种端大行其道,当业务要求同时在不同的端都要求有所表现的时候,针对不同的端去编写多套代码的成本显然非常高,这时候只编写一套代码就能够适配到多端的能力就显得极为需要。
使用 Taro,我们可以只书写一套代码,再通过 Taro 的编译工具,将源代码分别编译出可以在不同端(微信小程序、H5、RN等)运行的代码。
体验
请使用微信扫一扫以下体验码

相关链接
安装
2.x
当 Taro 版本 < 3 时,使用 2.x 版本
$ npm install [email protected]
3.x
当 Taro 版本 ≥ 3 时,使用 3.x 版本
$ npm install taro-ui@latest
使用
在代码中 import 需要的组件并按照文档说明使用
import { AtButton } from 'taro-ui'
通过安装skill获取AI Native支持
npx skills add https://raw.githubusercontent.com/jd-opensource/taro-ui/master/packages/taro-ui-guide/SKILL.md
开发交流
官方微信交流群
开发计划
查看 Roadmap →
路线图
Taro UI 正在积极恢复维护中,当前重点完成 Monorepo 重构、CSS 预编译和 Taro v4 兼容性验证。详细规划请查看 ROADMAP.md。
贡献
如果你在使用 Taro UI 时遇到问题,或者有好的建议,欢迎给我们提 Issue 或 Pull Request。在开始之前,请阅读 贡献指南
License
MIT