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

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

Правило styling для Claude Code задаёт стандарты вёрстки компонентов на Tailwind CSS. Направляет агента объединять классы через tailwind-merge, clsx и CVA.

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

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

Что делает styling

Правило предписывает использовать утилиту cn из связки clsx и tailwind-merge вместо обычной склейки строк. Без этого конфликтующие утилитарные классы Tailwind применяются одновременно, приводя к непредсказуемому интерфейсу.

Инструкция фиксирует строгий порядок классов: базовые стили, варианты пропсов, условные классы по состоянию и пользовательские переопределения через className в самом конце. Для компонентов с несколькими вариантами правило требует выносить схемы class-variance-authority (CVA) за пределы функций компонентов и выводить типы TypeScript через VariantProps.

Динамические классы вроде строк шаблонов правило запрещает, требуя передавать произвольные значения через переменные CSS в атрибуте style. Для работы по этим стандартам в проекте нужны пакеты clsx, tailwind-merge и class-variance-authority.

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

  • Устранить конфликты классов Tailwind при объединении пропсов
  • Задать архитектуру вариантов кнопок и полей ввода через CVA
  • Передавать динамические цвета в разметку через CSS-переменные
  • Выстроить порядок наложения базовых и условных стилей

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

  • Напиши компонент Button с вариантами через CVA и утилиту cn
  • Отрефактори карточку, чтобы className пользователя перебивал базовые стили
  • Сделай переключение состояний через clsx без конфликтов Tailwind

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

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

.claude/rules/styling.md

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

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

Вопросы о styling

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

Сохраните содержимое правила в файл .claude/rules/styling.md в корне вашего проекта.

Что делает правило styling?

Оно учит ИИ-ассистента использовать правильный порядок объединения стилей Tailwind, собирать хелпер cn и проектировать варианты интерфейса через CVA.

Что нужно для работы styling?

В проекте должны быть установлены библиотеки clsx, tailwind-merge и class-variance-authority.

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

styling.md · Apache-2.0
---
title: Component Styling with Tailwind CSS
impact: HIGH
impactDescription: Predictable, maintainable styling patterns
tags: styling, tailwind, cn, clsx, tailwind-merge, cva, class-variance-authority
---

## Component Styling with Tailwind CSS

Use Tailwind CSS with intelligent class merging (`tailwind-merge`), conditional classes (`clsx`), and variant APIs (CVA).

### The `cn` Utility Function

```tsx
import { type ClassValue, clsx } from "clsx";
import { twMerge } from "tailwind-merge";

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}
```

**Why:** Without `tailwind-merge`, conflicting classes both apply. The `cn` utility resolves conflicts intelligently.

### Class Merging

**Incorrect:**

```tsx
// Without tailwind-merge, conflicting classes both apply
className = "bg-red-500 bg-blue-500"; // Both classes apply, causing conflicts
className = "px-4 py-2 px-8"; // Both px-4 and px-8 apply
```

**Correct:**

```tsx
twMerge("bg-red-500", "bg-blue-500"); // "bg-blue-500"
twMerge("px-4 py-2", "px-8"); // "py-2 px-8"
twMerge("text-sm", "text-lg"); // "text-lg"
```

### Component Pattern: Order Matters

Apply classes in this order:

1. **Base styles** (always applied)
2. **Variant styles** (based on props)
3. **Conditional styles** (based on state)
4. **User overrides** (className prop)

**Incorrect:**

```tsx
// Wrong order: user className comes before variants, preventing overrides
className={cn(className, variant === 'primary' && 'bg-blue-500')}
```

**Correct:**

```tsx
const Component = ({
  className,
  variant,
  isActive,
  ...props
}: ComponentProps) => {
  return (
    <div
      className={cn(
        "rounded-lg border bg-white shadow-sm", // 1. Base
        variant === "primary" && "bg-blue-500", // 2. Variants
        isActive && "ring-2 ring-blue-500", // 3. Conditionals
        className // 4. User overrides
      )}
      {...props}
    />
  );
};
```

### Conditional Classes with `clsx`

```tsx
cn("base", isActive && "active");
cn("base", { active: isActive, disabled: isDisabled });
cn(["base", isLarge ? "text-lg" : "text-sm"]);
```

### Class Variance Authority (CVA)

For components with multiple variants:

```tsx
import { cva, type VariantProps } from "class-variance-authority";

const buttonVariants = cva(
  "inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium transition-all",
  {
    variants: {
      variant: {
        default: "bg-blue-500 text-white hover:bg-blue-600",
        destructive: "bg-red-500 text-white hover:bg-red-600",
        outline: "border border-gray-300 bg-transparent hover:bg-gray-50",
        ghost: "hover:bg-gray-100",
      },
      size: {
        default: "h-9 px-4 py-2",
        sm: "h-8 px-3 text-sm",
        lg: "h-10 px-6",
        icon: "h-9 w-9",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
);

type ButtonProps = React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants>;

export const Button = ({ className, variant, size, ...props }: ButtonProps) => {
  return (
    <button
      className={cn(buttonVariants({ variant, size }), className)}
      {...props}
    />
  );
};
```

**Key points:**

- Define CVA variants **outside** the component
- Use `VariantProps<typeof variants>` for TypeScript types
- Always merge with `className` prop using `cn`

### Best Practices

**1. Extract Repeated Patterns:**

```tsx
export const focusRing = 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500';
export const disabled = 'disabled:pointer-events-none disabled:opacity-50';

className={cn(focusRing, disabled, className)}
```

**2. Use CSS Variables for Dynamic Values:**

**Incorrect:**

```tsx
// Dynamic class generation (not detected by Tailwind)
<div className={`bg-[${dynamicColor}]`} />
```

**Correct:**

```tsx
// CSS variables
<div
  className="bg-[var(--color)]"
  style={{ "--color": dynamicColor } as React.CSSProperties}
/>
```

**3. Document Variants:**

```tsx
type ButtonProps = {
  /** The visual style @default "default" */
  variant?: "default" | "destructive" | "outline" | "ghost";
  /** The size @default "default" */
  size?: "sm" | "default" | "lg" | "icon";
};
```

### Common Patterns

**State-Based Styling:**

```tsx
<div
  className={cn(
    "transition-all",
    isOpen ? "opacity-100 translate-y-0" : "opacity-0 translate-y-4"
  )}
/>
```

**CVA with Additional Conditionals:**

```tsx
<div
  className={cn(
    baseVariants({ variant, size }),
    isActive && "ring-2 ring-blue-500",
    isDisabled && "opacity-50 cursor-not-allowed",
    className
  )}
/>
```

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →

Сначала — styling от других авторов.

styling calesthio Правило styling для Claude Code и Codex: задаёт стили mobject'ов в ManimGL — заливку, обводку, прозрачность, свечение и матовость. Держит оформление анимаций консистентным. CX Codex +1 ★ 78 316звёзд репо styling Devin-AXIS Правило styling для единообразного оформления React-компонентов: семантические цвета вместо сырых значений, встроенные варианты компонентов, условные классы через cn(). CX Codex +1 ★ 7 523звёзд репо ux-design-systems hoodini Скилл ux-design-systems помогает настроить дизайн-токены, базовые React-компоненты и переключение тем. Пригодится при сборке собственной библиотеки интерфейсов. CX Codex +1 ★ 301звёзд репо ui-styling claudekit Скилл ui-styling для сборки доступных интерфейсов на shadcn/ui и Tailwind CSS: компоненты, темы, тёмная тема, адаптивные сетки и canvas-дизайн. CX Codex +1 52 100установок shadcn-ui existential-birds Учит агента строить UI-компоненты по паттернам shadcn/ui — CVA-варианты, составные компоненты, data-slot-атрибуты. CX Codex +1 358установок shadcn-code-review existential-birds Скилл shadcn-code-review проверяет React-компоненты на базе shadcn/ui, Radix и Tailwind CSS на доступность, работу с CVA и шаблоны asChild. Помогает находить ошибки в кастомной вёрстке. CX Codex +1 206установок tailwindcss-advanced-components JosiahSiegel Скилл tailwindcss-advanced-components для Claude Code помогает собирать варианты React-компонентов на Tailwind CSS с CVA, compound variants и cn. Описывает паттерны в стиле shadcn/ui. CX Codex +1 253установок styling-nativewind-v4-expo tristanmanchester Скилл styling-nativewind-v4-expo помогает настроить NativeWind v4 и Tailwind CSS v3 в Expo, устранить ошибки сборки Metro и правильно верстать мобильные компоненты. CX Codex +1 423установок

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

Весь набор →
as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо state Правило state для Claude Code задаёт паттерны управляемого и неуправляемого состояния React-компонентов. Оно включается при проектировании API компонентов. CX Codex +1 ★ 141звёзд репо accessibility Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG. CX Codex +1 ★ 141звёзд репо polymorphism Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as. CX Codex +1 ★ 141звёзд репо definitions Правило definitions для Claude Code классифицирует UI-артефакты и задаёт точные названия для компонентов, блоков, шаблонов и паттернов. CX Codex +1 ★ 141звёзд репо components-build Скилл components-build для Claude Code помогает создавать, проверять и перерабатывать переиспользуемые компоненты React по спецификации components.build. Он подключается к задачам об API компонентов, доступности, стилях и типах TypeScript. CX Codex +1 ★ 141звёзд репо otto-design Скилл otto-design для Claude Code задаёт процесс проектирования интерфейсов Otto в Paper перед сборкой в SwiftUI. Включается при запросах на мокапы, редизайн или изменение экранов и карточек приложения. CX Codex +1 ★ 141звёзд репо

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

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