logo

京东风格的轻量级 React 组件库，支持移动端 H5 和小程序开发

PRs Welcome license GitHub contributors GitHub Release Date GitHub commit activity

NutUI-React   NutUI-React

--- > Nut[nʌt]，源自电影《冰河世纪》里松鼠 Scrat "执迷不悟"，一生追求，即便引发大灾难也绝不松手的坚果。 简体中文 | [English](./README.md) ## 特性 - 🚀 70+ 高质量组件, 覆盖移动端主流场景 - 📖 基于京东 APP 11.0 视觉规范 - 🍭 支持按需引用 - 📖 详尽的文档和示例 - 💪 支持 TypeScript - 💪 支持服务端渲染（测试阶段） - 🍭 支持定制主题 - 🍭 单元测试覆盖率超过90%, 保障稳定性 - 📖 提供 Sketch 设计资源 ## 项目运行 ### 本地运行H5 ```sh # 克隆仓库 git clone https://github.com/jdf2e/nutui-react.git # 进入项目根目录 cd nutui-react # 安装依赖 pnpm install # 进入开发模式 # 浏览器访问：http://localhost:3000（如果已启动前台程序，则不需打开此地址） pnpm run dev ``` ### 本地运行 Taro 环境 **注意：在 Taro 环境新增 pnpm pre 钩子，用于 H5 或小程序预览时显示未适配鸿蒙的组件，环境变量可通过 predev:taro 命令查看。** #### 本地运行 Taro 相关的预览 ````sh # 克隆仓库 git clone https://github.com/jdf2e/nutui-react.git # 进入项目根目录 cd nutui-react # 安装依赖 pnpm install # 进入小程序开发模式 ```shell # Taro H5 pnpm dev:taro h5 # 微信小程序 pnpm dev:taro weapp # 京东小程序 pnpm dev:taro jd # 其他平台 参考 demo 目录中 package.json 的 script ```` #### 本地运行 JDTaro 相关的预览 1. 仓库根目录下增加 .npmrc 文件，增加如下配置: ```shell git-branch-lockfile=true ``` ````sh # 克隆仓库 git clone https://github.com/jdf2e/nutui-react.git # 进入项目根目录 cd nutui-react # 安装依赖 pnpm install --ignore-pnpmfile # 进入小程序开发模式 ```shell # Taro H5 pnpm dev:jdtaro h5 # 微信小程序 pnpm dev:jdtaro weapp # 京东小程序 pnpm dev:jdtaro jd # harmony cpp pnpm dev:jdtaro:jdharmonycpp ```` ## 构建版本 > AMD 环境、Webpack、Vite 等构建工具环境、服务端建议使用 es 版，非模块化环境（如通过 `