@cuxt/chama

基于 shadcn/ui Nova 预设的 React 组件库，使用 Base UI 作为底层 primitives，样式基于 Tailwind CSS v4。

安装

pnpm add @cuxt/chama

peer dependencies（必须安装，版本 ≥ ^19 / ^1.8）

• react ^19
• react-dom ^19
• @base-ui/react ^1.8
• lucide-react
• class-variance-authority
• cn

强制安装（dependencies，无需手动安装）

• tailwindcss ^4
• tw-animate-css
• @fontsource-variable/geist
• shadcn ^4

配置样式

在你的项目入口 CSS 中（例如 src/app.css）：

@import "tailwindcss";
@import "@cuxt/chama/style.css";

/* 让 Tailwind v4 扫描组件库代码以生成对应的工具类 */
@source "../node_modules/@cuxt/chama/dist";

使用

import { Button } from "@cuxt/chama";

export function App() {
  return <Button variant="outline">点击我</Button>;
}

组件

| 名称 | 描述 | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Button | 基于 Base UI Button 的多态按钮，支持 variant（default / outline / secondary / ghost / destructive / link）与 size（default / xs / sm / lg / icon / icon-xs / icon-sm / icon-lg） | | buttonVariants | 由 class-variance-authority 导出的样式变体，可直接用于自定义组件 |

开发

pnpm install
pnpm run build   # vp pack：构建库产物到 dist/
pnpm run check   # vp check：lint + format + type-check

发布

# 首次发布前确保已在 npm 创建 organization @cuxt
npm login
npm publish

# 后续发布
pnpm exec bumpp      # 交互式 bump 版本
npm publish

License

MIT © cuxt