# @buildkitgg/shadcn-baseui-nova 中文文档

规范地址：https://npmcn.com/package/%40buildkitgg/shadcn-baseui-nova/

版本：0\.5\.0
npm 元数据更新时间：2026-11-06T17:41:09.250Z
中文译文更新时间：2026-11-08T20:50:04.934Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40buildkitgg/shadcn-baseui-nova
原文对照：https://npmcn.com/package/%40buildkitgg/shadcn-baseui-nova/?lang=original
项目主页：https://github.com/betterapps-hq/buildkit/tree/main/packages/shadcn/shadcn-baseui-nova#readme
源码仓库：https://github.com/betterapps-hq/buildkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：808 kB，152 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：15 个
- peer 依赖：react ^19\.2\.0，react-dom ^19\.2\.0
- 首次发布：2026-10-22T21:14:56.462Z
- 最新版本发布：2026-11-06T17:41:08.832Z
- 近 30 天下载量：2102（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

上流的shadcn Base UI组件为新星风格,有编译的CSS和TypeScript声明.

## 安装

```sh
npm install @buildkitgg/shadcn-baseui-nova
```

也可以使用：`pnpm add @buildkitgg/shadcn-baseui-nova`、`yarn add @buildkitgg/shadcn-baseui-nova`、`bun add @buildkitgg/shadcn-baseui-nova`

## README

# @builtkitgg/shadcn-basui-nova 页面存档备份,存于互联网档案馆

来源于被钉住的上游Shadcn Base UI目录. 不编辑已生成的组件 .

使用依赖性别名选择此样式 :

```sh
pnpm add @buildkitgg/shadcn-baseui-kit@npm:@buildkitgg/shadcn-baseui-nova
```

```tsx
import { Button } from "@buildkitgg/shadcn-baseui-kit"
import "@buildkitgg/shadcn-baseui-kit/styles.css"
```

Buildkit的shadcn管理器使用相同的对等依赖并继承这个选择. 在应用程序条目中导入样式一次 . 使用 `styles-no-reset.css` 当应用程序已经提供 Tailwind 的重置。 颜色和光/暗模式仍可定制 通过 CSS 变量。 样式选择是安装时间,而不是运行时间 .

Tailwind 4 应用程序导入 `tailwind.css` 与 Tailwind 代替编译样式; 它记录组件扫描 自动。 不导入 Tailwind 的应用程序 `styles.css`。不将这些路径或导入管理器样式表与 尾风源条目.

根出口 `ShadcnLocalizationProvider` (英语默认), `useShadcnLocalization`,以及 `setCn`。见 [本地化和RTL](https://github.com/betterapps-hq/buildkit/blob/main/docs/shadcn/localization.md) 财务报告和审定财务报表 [样式](https://github.com/betterapps-hq/buildkit/blob/main/docs/shadcn/theming.md)。 。 。 .

## 设计符号

通过相同的别名读取所选样式的默认值 :

```js
import { readFile } from "node:fs/promises"
const url = import.meta.resolve("@buildkitgg/shadcn-baseui-kit/tokens.json")
const tokens = JSON.parse(await readFile(new URL(url), "utf8"))
```

`tokens.json` 是一个 DTCG 解析器( 2025. 10) 有光和暗的主题。 每个符号都有类型和描述 路径是其 CSS 变量的名称在每一个连字符(`card.foreground` 实值 `--card-foreground`) (中文(简体) ). 应用程序 CSS 不包含超文本 。 见 [设计符号](https://github.com/betterapps-hq/buildkit/blob/main/docs/shadcn/styles.md#design-tokens)。 。 。 .

[从独立的包里搬走](https://github.com/betterapps-hq/buildkit/blob/main/docs/shadcn/migration.md)。 。 。 .

[设置、维护和释放检查](https://github.com/betterapps-hq/buildkit/blob/main/docs/shadcn/styles.md)。 。 。 .

## 常见问题

### @buildkitgg/shadcn-baseui-nova 是什么？

上流的shadcn Base UI组件为新星风格,有编译的CSS和TypeScript声明\.

### 如何安装 @buildkitgg/shadcn-baseui-nova？

在项目目录运行 npm install @buildkitgg/shadcn-baseui-nova，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.2\.0）、react-dom（^19\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @buildkitgg/shadcn-baseui-nova 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @buildkitgg/shadcn-baseui-nova 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @buildkitgg/shadcn-baseui-nova 可以商用吗？

@buildkitgg/shadcn-baseui-nova 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @buildkitgg/shadcn-baseui-nova 的下载量有多少？

根据 npm 官方下载统计，@buildkitgg/shadcn-baseui-nova 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,102 次，日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @buildkitgg/shadcn-baseui-nova 还在维护吗？

最新版本 0\.5\.0 发布于 2026/11/07（2 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/10/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。