Skip to content

🎨 太白 @lintaibai UI ​

太白 UI —— 天工开源项目的统一 UI 组件库,采用 shadcn/ui 模式,把组件源码直接复制到你的项目里。


📦 项目简介 ​

太白 UI 是天工开源项目沉淀的统一 UI 组件库,覆盖 Vue3 / React 等主流框架,提供一致的视觉风格和交互体验。

✨ 核心特性 ​

  • 🎨 统一风格:跨框架一致的视觉规范和交互体验
  • 🧩 多端适配:Web / App / 小程序 一套设计体系
  • ⚡ 开箱即用:按需引入,组件即文档
  • 📦 主题定制:CSS 变量驱动,快速换肤

💡 设计初衷 ​

为什么要做统一的 UI 组件库?

  • 🔸 各端组件风格不统一,维护成本高
  • 🔸 重复封装相同组件,浪费时间
  • 🔸 业务组件无法复用,扩展性差

目标:一套设计体系,多端一致呈现,沉淀天工全栈生态的组件资产。


⚙️ 工作原理 ​

太白 UI 采用 shadcn/ui 模式——不安装整个组件库,而是把你需要的组件源码直接复制到你的项目里,你拥有完全控制权。

用户执行: npx @lintaibai/ui add button
    ↓
CLI 临时安装 @lintaibai/vue 到临时目录
    ↓
从 node_modules/@lintaibai/vue/src/components/button/index.vue 读源码
    ↓
把源码写入用户项目的 components/ui/button/
    ↓
删除临时安装的 @lintaibai/vue

核心优势:

  • ✅ 组件源码直接放进你的项目,可随意修改
  • ✅ 组件库更新了,CLI 自动跟着更新,不用维护两套模板
  • ✅ 按需安装,用哪个装哪个,不打包多余代码
  • ✅ CSS 变量驱动,跨组件风格一致

🚀 快速开始 ​

安装组件 ​

bash
# 自动检测项目框架(Vue/React)
npx @lintaibai/ui add button

# 手动指定框架
npx @lintaibai/ui add button vue
npx @lintaibai/ui add button react

生成的文件结构 ​

你的项目/
└── components/
    └── ui/
        └── button/
            └── index.vue    # 或 index.tsx

📦 支持的框架 ​

框架包名状态
Vue3@lintaibai/vue迭代更新
React@lintaibai/react规划中

🧩 可用组件 ​

组件说明
button6 种变体按钮
input输入框
dialog对话框
tabs标签页
card卡片
badge徽标
tag标签
switch开关

📁 项目结构 ​

packages/
├── taibai-shared/        # 共享样式与工具
├── ui-taibai-vue/        # Vue 组件库源码
├── ui-taibai-react/      # React 组件库源码(规划中)
└── ui-cli/               # CLI 安装工具
    ├── cli.js
    └── templates/

📄 License ​

MIT

Released under the MIT License.