@darkalpha/nova-ui

中文文档
0.9.0发布于 2026/11/14MITTypeScriptES Module构建来源已验证近 30 天下载 2084

Nova UI设计系统的有色可取,可访问,可主题反应组件.

中文使用文档
文档目录4 节
  1. 入境点
  2. 丰富的文本编辑器
  3. 使用 Tailwind CSS v4 的应用程序
  4. 主题提供

@darkalpha/nova-ui (法语)

色彩丰富,可访问,可主题反应组件.

pnpm add @darkalpha/nova-ui
import { Button, ThemeProvider } from "@darkalpha/nova-ui";
import "@darkalpha/nova-ui/styles.css";

<ThemeProvider theme="ocean" brand={{ primary: "#0f766e" }}>
  <Button>Get started</Button>
</ThemeProvider>;

入境点

导入目录
@darkalpha/nova-ui组件, ThemeProvider, (中文(简体) ), ThemeScript钩子, cn,以及符号 API(createTheme, (中文(简体) ), registerTheme, (中文(简体) ), auditContrast. ) (中文(简体) )
@darkalpha/nova-ui/styles.css需要一次(除非您使用) tailwind.css) (中文(简体) ). Tokens, 重设范围到 .nv-theme,以及组件样式。 没有全球飞行前.
@darkalpha/nova-ui/themes.css可选的 所有预设为 [data-nv-theme="…"] 零JS主题的块.
@darkalpha/nova-ui/react-hook-form反应-hook-form(任何解析器,如zod)的可选约束. 要求数 react-hook-form 7.55;从未被主条目装入.
@darkalpha/nova-ui/rich-text-editorRichTextEditor 财务报告和审定财务报表 RichTextViewer,基于Tiptap/ProseMilrror。 Tiptap 是一个可选的对等依赖: 只有当您使用编辑器( 命令下面) 时才会安装它 。 它的风格已经进入了 styles.css。 。 。 .
@darkalpha/nova-ui/kavehKaveh品牌套件(logo家族、品牌元素、页面部分、卡片)和Yalda/Nowruz季节性艺术品。 与 kaveh, (中文(简体) ), kaveh-yalda 财务报告和审定财务报表 kaveh-nowruz 主题.
@darkalpha/nova-ui/tailwind.css对于Tailwind v4应用程序, 改为 styles.css数字 : @import "tailwindcss"; @import "@darkalpha/nova-ui/tailwind.css";

丰富的文本编辑器

Tiptap 没有安装 Nova UI 。 导入的应用程序 @darkalpha/nova-ui/rich-text-editor 加上一点:

pnpm add @tiptap/core @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/extensions @tiptap/suggestion @tiptap/extension-bubble-menu @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-subscript @tiptap/extension-superscript @tiptap/extension-table @tiptap/extension-text-align @tiptap/extension-text-style @tiptap/extension-typography

使用 Tailwind CSS v4 的应用程序

导入 tailwind.css 从您的 CSS 条目中删除 styles.css 导入 :

@import "tailwindcss";
@import "@darkalpha/nova-ui/tailwind.css";

Nova UI号作为源头(仓库、范围基地、材料、代用品等) 作为 bg-primary加上一个 @source 对于组件,所以您的构建生成 和你的部分公用事业。 正在装入已预编译的 styles.css 也给你们两个分别排序的 utilities 分层: .flex-col 然后可以跟随图书馆的 sm:flex-row 并在每个宽度上获胜. 带有类前缀( N)prefix(tw)),使用时 styles.css 取而代之; 前缀 公用事业不能与组件相撞.

主题提供

Prop类型默认
theme预设名称、注册编号或 ThemeDefinition"vibrant"
brand{ primary?, secondary?, accent?, neutral? } (hex) (英语)—— 说
overrides{ light?: {...}, dark?: {...} } 语义符号—— 说
mode 编号 : defaultMode 编号 : onModeChange"light" | "dark" | "system"主题偏好, 否则 "system"
storageKey持续模式( 以 <ThemeScript>(中文(简体) )—— 说
radius"none" | "sm" | "md" | "lg" | "xl"从主题
density"compact" | "comfortable" | "spacious"从主题
fonts{ sans?, display?, mono? }从主题
motion"system" | "reduce""system"
dir"ltr" | "rtl"继承,否则 "ltr"

完整的文档、符号参考和主题游乐场都在 apps/docs。 。 。 .

同伴依赖性 : react 财务报告和审定财务报表 react-dom 18.2+或19 (中文(简体) ).

版本与发布记录

@darkalpha/nova-ui 共发布 13 个版本,首次发布于 2026/11/04;过去 12 个月发布了 13 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.0latest2026/11/14今天
0.8.02026/11/104 天前
0.7.02026/11/104 天前
0.6.02026/11/095 天前
0.5.12026/11/095 天前
0.5.02026/11/086 天前

关于 @darkalpha/nova-ui 的常见问题

@darkalpha/nova-ui 是什么?

Nova UI设计系统的有色可取,可访问,可主题反应组件.

如何安装 @darkalpha/nova-ui?

在项目目录运行 npm install @darkalpha/nova-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.2.0 || ^19.0.0)、react-dom(^18.2.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@darkalpha/nova-ui 支持 TypeScript 吗?

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

@darkalpha/nova-ui 支持 ESM 还是 CommonJS?

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

@darkalpha/nova-ui 可以商用吗?

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

@darkalpha/nova-ui 的下载量有多少?

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

@darkalpha/nova-ui 还在维护吗?

最新版本 0.9.0 发布于 2026/11/14(今天);至今共发布 13 个版本,其中过去 12 个月发布了 13 个;首次发布于 2026/11/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。