К основному содержанию
правило CX Codex

registry — правило для Claude Code: что делает и как установить

Правило registry для Claude Code описывает публикацию UI-компонентов как исходного кода. Оно задаёт формат метаданных и шаги размещения реестра.

Apache-2.0 ★ 141 обновлён 2026-11-17

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/registry.md
Открыть на GitHub

Что делает registry

Правило registry описывает реестры, которые отдают проекту исходный код компонентов вместо собранного пакета. Оно объясняет разницу между registry и npm, показывает импорт локального компонента и перечисляет поля JSON: зависимости, registryDependencies, файлы и категорию.

Для публикации создаётся каталог с JSON в public/, настраиваются заголовки в vercel.json, затем выполняется vercel --prod. Установка компонента выполняется через npx shadcn@latest add с адресом JSON. Запись без зависимостей, связанных компонентов, файлов или категории считается неполной.

Какие задачи решает

  • описать отличие registry от npm-пакета
  • сформировать JSON-метаданные UI-компонента
  • настроить публикацию реестра через vercel.json
  • добавить компонент через npx shadcn@latest add

Примеры запросов агенту

  • Опиши, чем registry отличается от npm для UI-компонентов.
  • Проверь JSON реестра для metric-card и найди недостающие поля.
  • Составь шаги публикации компонента через vercel.json и vercel --prod.

Как установить registry

Вручную: положить файлы

.claude/rules/registry.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о registry

Как установить registry в Claude Code?

Разместите файл правила по пути .claude/rules/registry.md.

Что делает registry?

Правило описывает распространение компонентов в виде исходного кода. Оно задаёт структуру JSON для зависимостей, связанных элементов, файлов и категории, а также показывает публикацию через Vercel и установку через npx shadcn@latest add.

Какие поля нужны в JSON реестра компонента?

Запись включает name, type, description, dependencies, registryDependencies, files и category. В files указываются тип, путь и содержимое файла.

Исходный текст

registry.md · Apache-2.0
---
title: Component Registries
impact: LOW
impactDescription: Source code distribution
tags: registry, shadcn, distribution, cli, source-code
---

## Component Registries

Registries distribute **source code**, not compiled packages. This enables true component ownership and customization.

### Core Concept

**Bad:**

```typescript
// Traditional npm - compiled dependency
import { Button } from "some-ui-library";
```

**Good:**

```typescript
// Registry-based - source code in your project
import { Button } from "@/components/ui/button";
```

### Registry Metadata Format

**Bad:**

```json
{
  "name": "announcement",
  "type": "registry:component",
  "description": "A compound badge component"
  // Missing dependencies, registryDependencies, files, and category
}
```

**Good:**

```json
{
  "name": "announcement",
  "type": "registry:component",
  "description": "A compound badge component",
  "dependencies": ["class-variance-authority", "lucide-react"],
  "registryDependencies": ["badge"],
  "files": [
    {
      "type": "registry:component",
      "path": "announcement.tsx",
      "content": "..."
    }
  ],
  "category": "ui"
}
```

### Quick Publishing

**1. Create structure:**

```
my-component/
├── public/
│   └── metric-card.json
└── vercel.json
```

**2. Configure headers (`vercel.json`):**

**Example:**

```json
{
  "headers": [
    {
      "source": "/(.*).json",
      "headers": [
        { "key": "Access-Control-Allow-Origin", "value": "*" },
        { "key": "Content-Type", "value": "application/json" }
      ]
    }
  ]
}
```

**3. Deploy:**

**Example:**

```bash
vercel --prod
```

**4. Users install via:**

**Example:**

```bash
npx shadcn@latest add https://your-project.vercel.app/metric-card.json
```

### Component JSON Structure

**Example:**

```json
{
  "name": "metric-card",
  "type": "registry:component",
  "description": "Display metrics with icon and trend",
  "dependencies": ["lucide-react"],
  "registryDependencies": ["card"],
  "files": [
    {
      "type": "registry:component",
      "path": "metric-card.tsx",
      "content": "import { Card } from '@/components/ui/card'\n\nexport function MetricCard({ title, value }) {\n  return <Card><h3>{title}</h3><p>{value}</p></Card>\n}"
    }
  ],
  "category": "ui"
}
```

### Registry vs npm

| Aspect        | Registry          | npm             |
| ------------- | ----------------- | --------------- |
| Distribution  | Source code       | Compiled        |
| Ownership     | Full control      | Dependency lock |
| Customization | Modify freely     | Fork/override   |
| Updates       | Manual copy       | `npm update`    |
| Bundle size   | Only what you use | Full package    |

### Best Practices

**For Authors:**

1. Document dependencies
2. Version components
3. Provide examples
4. Test compatibility
5. Use semantic naming

**For Consumers:**

1. Review source code
2. Check dependencies
3. Customize freely
4. Track updates
5. Test thoroughly

### When to Use

**Use registries when:**

- Sharing with community
- Users need source ownership
- Building for specific frameworks
- Quick distribution needed

**Use npm when:**

- Distributing compiled code
- Need version management
- Framework-agnostic libraries
- Complex build processes

© maxtrigify · Apache-2.0 · maxtrigify/Otto

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
MCP Registry Monitor nirholas MCP-сервер MCP Registry Monitor следит за официальным реестром MCP и присылает уведомления о новых серверах, обновлениях версий и удалениях в Discord, Slack, почту или вебхук. CX Codex +1 ★ 32звёзд репо UI Registry mrityunjay-tiwari MCP-сервер UI Registry подключает агента к 12 библиотекам компонентов формата shadcn. Помогает находить готовые блоки интерфейса, сравнивать варианты и выравнивать стили. CX Codex +1 ★ 7звёзд репо iros-registry-automation NomaDamas Скилл iros-registry-automation готовит выписки из корейского реестра IROS и помогает вести сессию в браузере. Нужен при работе с выписками по недвижимости и юрлицам. CX Codex +1 11 500установок faa-aircraft-registry-mcp-server cyanheads MCP-сервер faa-aircraft-registry-mcp-server ищет записи реестра гражданских воздушных судов США, расшифровывает N-номера и проверяет статус регистрации без API-ключа. CX Codex +1 1 820установок offer-claims-registry aaron-he-zhu Скилл offer-claims-registry ведёт реестр рекламных заявлений и предложений: сохраняет формулировки, подтверждения, условия и сроки проверки. Запросите доказательство для цифры или обновите условия оффера. CX Codex +1 1 100установок channel-registry aaron-he-zhu Скилл channel-registry ведёт единый реестр соцканалов бренда: аккаунты, состояния, ритм публикаций, права на UGC и адаптации тона. Факты пишутся в append-only поток событий, из которого пересобираются представления. CX Codex +1 1 100установок

Из того же набора18

Весь набор →
npm Правило npm для Claude Code задаёт стандарты публикации компонентов в виде пакетов с версионированием. Настраивает package.json, сборку через tsup и директивы Tailwind. CX Codex +1 ★ 141звёзд репо marketplaces Правило marketplaces для Claude Code систематизирует поиск и интеграцию компонентов из внешних реестров. Оно помогает агенту оценивать качество готового кода перед добавлением в проект. CX Codex +1 ★ 141звёзд репо design-tokens Правило design-tokens для Claude Code заменяет жёстко заданные цвета семантическими токенами. Переключение светлой и тёмной темы меняет значения переменных, а не классы компонентов. CX Codex +1 ★ 141звёзд репо composition Правило composition для Claude Code помогает разбивать крупные UI-компоненты на небольшие субагенты с четкими задачами. Оно применяется при проектировании библиотек и сложных интерфейсов. CX Codex +1 ★ 141звёзд репо overview Правило overview для Claude Code задаёт принципы создания доступных и составных UI-компонентов. Оно подключается при проектировании компонентов и их API. CX Codex +1 ★ 141звёзд репо types Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах. CX Codex +1 ★ 141звёзд репо data-attributes Правило data-attributes для Claude Code задаёт паттерны data-state и data-slot для стилизации состояний и связи компонентов. CX Codex +1 ★ 141звёзд репо principles Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой