@bettercms-ai/kit

中文文档
3.1.8发布于 2026/11/09MITTypeScriptES Module近 30 天下载 4967

The BetterCMS V2 Block Kit: schema language, form engine, controls and design tokens.

原始使用文档
文档目录3 节
  1. Styles
  2. Theme
  3. Imports

@bettercms-ai/kit

The BetterCMS V2 Block Kit: the schema language, the form engine that draws the Visual Editor's dock, its controls, and the design tokens. React 19, Base UI.

npm i @bettercms-ai/kit @base-ui/react @tabler/icons-react framer-motion react react-dom

Styles

  • Tailwind v4 app: import the tokens and the utility names after Tailwind.
    @import "tailwindcss";
    @import "@bettercms-ai/kit/theme.css";
    @import "@bettercms-ai/kit/tokens.css";
    @source "../node_modules/@bettercms-ai/kit/dist";
    
  • No Tailwind (a custom dock input's iframe): import "@bettercms-ai/kit/styles.css", a precompiled sheet with the tokens and every utility the kit uses. Never import it next to your own Tailwind sheet.

Theme

import { KitRoot, applyScheme } from "@bettercms-ai/kit/theme";

applyScheme(document.documentElement, "dark"); // .dark on <html>: portalled layers follow it
<KitRoot>{/* kit components */}</KitRoot>;

Imports

@bettercms-ai/kit re-exports the engine, the controls and the UI primitives. Every module is also importable by path, e.g. @bettercms-ai/kit/ui/button, @bettercms-ai/kit/schema/scale.

版本与发布记录

@bettercms-ai/kit 共发布 36 个版本,首次发布于 2026/09/29;过去 12 个月发布了 36 个版本。

版本发布日期距今
3.1.8latest2026/11/09今天
3.1.7next2026/11/08今天
3.1.62026/11/08今天
3.1.52026/11/08今天
3.1.42026/11/071 天前
3.1.32026/11/071 天前

关于 @bettercms-ai/kit 的常见问题

@bettercms-ai/kit 是什么?

The BetterCMS V2 Block Kit: schema language, form engine, controls and design tokens.

如何安装 @bettercms-ai/kit?

在项目目录运行 npm install @bettercms-ai/kit,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.2.0)、react-dom(^19.2.0)、framer-motion(^12.40.0)、@base-ui/react(^1.4.1)、@bettercms-ai/types(^1.66.0)、@tabler/icons-react(^3.48.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bettercms-ai/kit 支持 TypeScript 吗?

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

@bettercms-ai/kit 支持 ESM 还是 CommonJS?

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

@bettercms-ai/kit 可以商用吗?

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

@bettercms-ai/kit 的下载量有多少?

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

@bettercms-ai/kit 还在维护吗?

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