v 1.0.0

KUMO UI

Cloudflare 用于构建现代 Web 应用的组件库。
基于 Base UI 构建，提供无障碍且符合设计系统的 UI 组件。

Kumo 使得构建无障碍应用变得简单。它自动处理键盘导航、焦点管理和 ARIA 属性，让开发者可以专注于业务逻辑，而无需深究每一个无障碍细节。

01. 安装

主要包

                                $ pnpm add
                                        @cloudflare/kumo
                                COPY
                            

对等依赖 (Peer Dependencies)

                                $ pnpm add react react-dom
                                        @phosphor-icons/react
                                COPY
                            

02. 使用方法

基础引用

import { Button, Input, Dialog } from "@cloudflare/kumo";
import "@cloudflare/kumo/styles";

精细导入 (Tree-Shaking)

import { Button } from "@cloudflare/kumo/components/button";

Base UI 原语

Kumo 重新导出了所有 Base UI 原语以支持高级用例：

import { Popover } from "@cloudflare/kumo/primitives/popover";

03. 命令行工具 (CLI)

直接从命令行查询组件文档，提高开发效率。

# 列出所有组件

                                $ npx @cloudflare/kumo
                                        ls
                                COPY
                            

# 获取特定组件文档 (例如 Button)

                                $ npx @cloudflare/kumo doc
                                        Button
                                COPY
                            

# 获取所有文档

                                $ npx @cloudflare/kumo
                                        docs
                                COPY
                            

04. 开发指南

快速开始

$ pnpm install

$ pnpm dev // port 4321

$ pnpm --filter @cloudflare/kumo test

创建新组件

$ pnpm --filter @cloudflare/kumo new-component

请参阅 AGENTS.md 获取全面的开发文档，包括：

组件模式和样式系统
语义颜色令牌
开发工作流
CI/CD 流水线
Figma 插件