C
v1.0.0 — Now Available

企业级 React 组件库
Chaos UI

面向 ERP & 业务系统的企业级 React 19 组件库。148+ 组件、19 Hooks、5 工具模块,基于 Tailwind CSS 4 和 shadcn/ui 构建。

495+
组件
19
钩子
5
工具模块
8
子路径导出
三步上手

安装 & 快速开始

选择你喜欢的包管理器,一行命令安装,立即开始使用。

bash
npm install @chaos_team/chaos-ui

导入样式CSS Import

css
/* styles.css */
@import "@chaos_team/chaos-ui/styles.css";

开始使用Usage

tsx
import { Button } from "@chaos_team/chaos-ui/ui";
import { useCrud } from "@chaos_team/chaos-ui/hooks";
import { cn } from "@chaos_team/chaos-ui/lib";

export default function App() {
  return <Button>Click me</Button>;
}
@chaos_team/chaos-ui/ui@chaos_team/chaos-ui/business@chaos_team/chaos-ui/hooks@chaos_team/chaos-ui/lib@chaos_team/chaos-ui/next@chaos_team/chaos-ui/ui-icons@chaos_team/chaos-ui/styles.css@chaos_team/chaos-ui/ui/icons
为什么选择 Chaos UI

为现代企业级应用而设计

从类型安全到暗色模式,从国际化到可访问性 — 每个细节都经过精心打磨。

TypeScript 类型安全
完整的 TypeScript 类型定义,严格模式启用,体验流畅的智能提示和编译期检查。
Tailwind CSS 4 主题
基于 CSS 变量的全主题系统,OKLCH 色彩空间,支持自定义品牌色和语义化 token。
暗色模式内置
开箱即用的暗色模式,基于 .dark class 切换,支持系统偏好自动跟随。
国际化双语文档
中英文文档同步维护,内置 13 个 i18n 命名空间,覆盖常用、图表、通知等场景。
WCAG 2.1 AA 可访问性
遵循 WCAG 2.1 AA 标准,完善的 ARIA 属性、键盘导航、屏幕阅读器支持。
Tree-shaking 子路径
8 个独立导出入口,按需引入,打包体积优化,ESM + CJS 双格式。
组件概览

三大类别,全面覆盖

从基础 UI 到业务场景,从布局框架到交互模式 — 应有尽有。

60+
UI Primitives 基础组件
基于 @base-ui/react 的无障碍底层组件,覆盖表单、数据展示、导航、反馈等全场景。
ButtonDialogTableSelectDatePickerFormTabsSheetCommandToast
80+
Business 业务组件
面向 ERP 和营销平台的领域组件,涵盖审批流、聊天、报表、仪表盘等垂直场景。
DataTableCampaignCardApprovalFlowAuditLogChatMessageOrgChartWorkflowDesignerDashboardCanvasBatchSelectorReportBuilder
15+
Layout 布局组件
管理后台、工作台、详情页的布局方案,支持侧边栏、面包屑、标签页等常见布局模式。
AdminShellAppShellDashboardLayoutMasterDetailLayoutSplitScreenWizardLayout