kumo README

The project's README from github.com/cloudflare/kumo. As one markdown file: README.md.

Kumo

Cloudflare's component library for building modern web applications.

Kumo provides accessible, design-system-compliant UI components built on Base UI. It handles keyboard navigation, focus management, and ARIA attributes so you can build accessible applications without thinking through every detail.

image

Installation

pnpm add @cloudflare/kumo

Peer Dependencies

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

Usage

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

Granular Imports (Tree-Shaking)

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

Base UI Primitives

Kumo re-exports all Base UI primitives for advanced use cases:

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

CLI

Query component documentation from the command line:

npx @cloudflare/kumo ls          # List all components
npx @cloudflare/kumo doc Button  # Get component docs
npx @cloudflare/kumo docs        # Get all docs

Development

See AGENTS.md for comprehensive development documentation including:

Quick Start

pnpm install
pnpm dev                    # Start docs site at localhost:4321
pnpm --filter @cloudflare/kumo test

Figma Plugin

# Optional: enable token sync during build
# cp packages/kumo-figma/scripts/.env.example packages/kumo-figma/scripts/.env
# $EDITOR packages/kumo-figma/scripts/.env  # set FIGMA_TOKEN (and optionally FIGMA_FILE_KEY)

pnpm --filter @cloudflare/kumo-figma build
# In Figma: Plugins > Development > Import plugin from manifest...
# Select: packages/kumo-figma/src/manifest.json

Creating Components

pnpm --filter @cloudflare/kumo new-component

Documentation

License

MIT

kumo (cloudflare/kumo)

Searching Database…

4.1K ·GitHub
Что это такое?Kumo — это библиотека компонентов от Cloudflare для создания современных веб-приложений: доступные UI-компоненты, соответствующие дизайн-системе, построенные на базе Base UI.
Это фреймворк или библиотека, которую я устанавливаю в своё приложение?Это библиотека, а не фреймворк: вы устанавливаете пакет @cloudflare/kumo из npm и импортируете в своё приложение только те UI-компоненты, которые нужны.
Как добавить её в проект?Установите npm-пакет @cloudflare/kumo и импортируйте его компоненты. У пакета есть peer-зависимости, поэтому добавьте их в проект вместе с ним. Документация по использованию — на kumo-ui.com.
Где можно посмотреть компоненты вживую?Живая документация размещена на kumo-ui.com.
Почему он построен на Base UI?Base UI предоставляет базовые доступные примитивы — обработку клавиатуры, управление фокусом, ARIA, — поэтому Kumo просто добавляет дизайн-систему Cloudflare поверх, не переписывая эту «сантехнику» заново, и при этом реэкспортирует примитивы для сложных случаев.
Насколько Kumo зрелый проект?Он молодой — репозиторий стал публичным в конце октября 2025 года, — но у него уже около 4 000 звёзд на GitHub, а за спиной стоит Cloudflare.
Creator
cloudflare
Size
6.3 MB
Stars
4.1K
Age
11mo
Commits · 90 Days