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

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

Правило design-tokens для Claude Code заменяет жёстко заданные цвета семантическими токенами. Переключение светлой и тёмной темы меняет значения переменных, а не классы компонентов.

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

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

Что делает design-tokens

Правило design-tokens задаёт имена вроде --background, --foreground, --primary и --border вместо цветов blue-600 или white. Компоненты обращаются к семантическим токенам, поэтому оформление отделено от назначения цвета.

Структура использует переменные в :root, переопределения в .dark и связку @theme inline для Tailwind CSS. В примерах применяются oklch(), варианты тем через [data-theme="brand-b"] и отдельные значения для текста на фоне. Для интерфейса также предлагается проверять контраст по WCAG.

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

  • заменить жёстко заданные цвета в компонентах
  • связать оформление компонентов с семантическими переменными
  • добавить светлую и тёмную тему через .dark
  • создать варианты оформления через [data-theme]
  • перенести цвета в формат oklch()

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

  • Перепиши цвета в этом компоненте на семантические токены.
  • Добавь светлую и тёмную тему через .dark и переменные :root.
  • Замени bg-blue-600 и text-white на токены из правила design-tokens.

Как установить design-tokens

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

.claude/rules/design-tokens.md

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

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

Вопросы о design-tokens

Как установить design-tokens в Claude Code?

Добавьте в проект файл .claude/rules/design-tokens.md с содержимым правила.

Что делает design-tokens?

Правило заменяет жёстко заданные цвета семантическими токенами. Оно описывает имена переменных, варианты тем, применение в компонентах и формат oklch().

Как design-tokens задаёт тёмную тему?

Базовые значения находятся в :root, а в классе .dark задаются другие значения тех же переменных. Компоненты используют токены и получают новые цвета автоматически.

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

design-tokens.md · Apache-2.0
---
title: Design Tokens
impact: MEDIUM
impactDescription: Flexible theming and consistency
tags: design-tokens, css-variables, theming, dark-mode, oklch
---

## Design Tokens

Use semantic design tokens instead of hardcoded colors. Design tokens separate what something is from how it looks.

### Variable Architecture

```css
@import "tailwindcss";

@custom-variant dark (&:is(.dark *));

@theme inline {
  --color-background: var(--background);
  --color-foreground: var(--foreground);
  --color-primary: var(--primary);
  --color-primary-foreground: var(--primary-foreground);
}

:root {
  --background: oklch(1 0 0);
  --foreground: oklch(0.145 0 0);
  --primary: oklch(0.205 0 0);
  --primary-foreground: oklch(0.985 0 0);
}

.dark {
  --background: oklch(0.145 0 0);
  --foreground: oklch(0.985 0 0);
  --primary: oklch(0.922 0 0);
  --primary-foreground: oklch(0.205 0 0);
}
```

### Token Naming

**Base Tokens:**

- `--background` - Main page background
- `--foreground` - Primary text color
- `--muted` - Subtle backgrounds
- `--muted-foreground` - Text on muted
- `--border` - Border colors
- `--ring` - Focus ring

**Semantic Tokens:**

- `--primary` / `--primary-foreground`
- `--secondary` / `--secondary-foreground`
- `--destructive` / `--destructive-foreground`
- `--accent` / `--accent-foreground`

### Usage in Components

**Correct (semantic tokens):**

```tsx
<button className="bg-primary text-primary-foreground hover:bg-primary/90">
  Click me
</button>
```

**Incorrect (hardcoded colors):**

```tsx
<button className="bg-blue-600 text-white hover:bg-blue-700">Click me</button>
```

### Component Examples

```tsx
// Card
<div className="bg-background border border-border rounded-lg p-6">
  <h2 className="text-foreground font-semibold">Title</h2>
  <p className="text-muted-foreground">Description</p>
</div>

// Button variants
<button className="bg-primary text-primary-foreground">Primary</button>
<button className="bg-secondary text-secondary-foreground">Secondary</button>
<button className="bg-destructive text-destructive-foreground">Delete</button>

// Input
<input className="bg-background border border-border text-foreground placeholder:text-muted-foreground" />
```

### Dark Mode

Override tokens in `.dark` class:

```css
:root {
  --background: oklch(1 0 0);
  --foreground: oklch(0.145 0 0);
}
.dark {
  --background: oklch(0.145 0 0);
  --foreground: oklch(0.985 0 0);
}
```

Components automatically adapt because they reference tokens.

### Color Format: OKLCH

Use `oklch()` for better color manipulation:

```css
/* ✅ OKLCH - perceptually uniform */
--primary: oklch(0.5 0.2 250);

/* ⚠️ RGB/HSL - harder to manipulate */
--primary: rgb(100, 150, 200);
```

### Best Practices

1. **Never hardcode colors** - Always use design tokens
2. **Use semantic names** - `--primary`, not `--blue-600`
3. **Keep tokens minimal** - Start with base set, add when needed
4. **Document token purpose** - Add comments
5. **Test theme switching** - Ensure all components work in light/dark
6. **Maintain contrast** - Ensure WCAG contrast ratios

### Theme Variants

```css
:root {
  --primary: oklch(0.5 0.2 250);
}
[data-theme="brand-b"] {
  --primary: oklch(0.5 0.2 120);
}
[data-theme="brand-c"] {
  --primary: oklch(0.5 0.2 0);
}
```

### Migration

```tsx
// Before
<div className="bg-white text-gray-900 border-gray-200">Content</div>

// After
<div className="bg-background text-foreground border-border">Content</div>
```

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →
design-system-tokens OrchestKit Скилл design-system-tokens помогает строить W3C-токены для цветов, отступов и тем. Включается при создании .tokens.json и систем с тёмной темой. CX Codex +1 215установок design-system-creation secondsky Скилл design-system-creation для Claude Code собирает дизайн-систему: токены, типографику, компоненты и документацию. Фиксирует стандарты интерфейса до начала вёрстки. CX Codex +1 512установок design-tokens-skill podo Скилл design-tokens-skill помогает проектировать системы дизайн-токенов по спецификации W3C DTCG, работать с цветами, ссылками и темами. Нужен при миграции и настройке пайплайна токенов. CX Codex +1 227установок material-ui-theming mui Скилл material-ui-theming для Claude Code создаёт темы Material UI: палитры, цветовые схемы, CSS-переменные, light/dark и TypeScript-расширения. Охватывает дизайн-системы и смену визуальной идентичности приложения. CX Codex +1 701установок tailwind-v4 existential-birds Скилл tailwind-v4 для ИИ-агента, который подсказывает, как настроить Tailwind CSS v4: тема в CSS, токены дизайна, цвета OKLCH и тёмная тема. CX Codex +1 827установок tokens educlopez Скилл tokens для Claude Code и Codex. Сканирует проект, находит дизайн-токены и собирает трёхслойную систему: проверяет, какие категории есть, какие слои присутствуют, настроены ли светлая и тёмная темы. CX Codex +1 992установок

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

Весь набор →
npm Правило npm для Claude Code задаёт стандарты публикации компонентов в виде пакетов с версионированием. Настраивает package.json, сборку через tsup и директивы Tailwind. CX Codex +1 ★ 141звёзд репо registry Правило registry для Claude Code описывает публикацию UI-компонентов как исходного кода. Оно задаёт формат метаданных и шаги размещения реестра. CX Codex +1 ★ 141звёзд репо marketplaces Правило marketplaces для 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звёзд репо

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

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