Библиотека дизайна / Дизайн-системы

Дизайн-системыВебСветлыйТёмныйМинимализмБесплатно

shadcn/ui — нейтральная дизайн-система на Tailwind для React-продуктов

Чёрно-белая тема neutral на CSS-переменных, Inter, радиус 10 px. Компоненты копируются в проект. Tailwind v4.

shadcn/ui — нейтральная дизайн-система на Tailwind для React-продуктов
Промпт
Подключи к моему проекту дизайн-систему shadcn/ui (автор shadcn, лицензия MIT; ниже наш конспект для ИИ-агента, не официальный продукт). Ниже файл DESIGN.md в открытом формате Google: вверху YAML-токены, ниже правила словами.

Что сделать:
1. Сохрани файл как DESIGN.md в корне проекта без изменений. Это источник правды для интерфейса: перед каждым новым экраном перечитывай его.
2. Подготовь проект. Для Vite: `npm install tailwindcss @tailwindcss/vite`, в `src/index.css` строка `@import "tailwindcss";`, в `vite.config.ts` плагины `react()` и `tailwindcss()` и алиас `@` на `./src` (такой же алиас в `tsconfig.json` и `tsconfig.app.json`), `npm install -D @types/node`. Затем выполни `npx shadcn@latest init -t vite -b radix -p nova` (для Next.js — `-t next`): это библиотека компонентов Radix и пресет Nova с базовым цветом neutral, его токены совпадают с DESIGN.md. Без флагов CLI задаёт вопросы и в неинтерактивном режиме падает. Пресет ставит шрифт Geist (`@fontsource-variable/geist`) — замени его на Inter. Шрифт Inter (400, 500, 600, 700) подключи с Google Fonts и задай как основной в теме.
3. Токены темы уже появятся в CSS как переменные (`--background`, `--foreground`, `--primary`, `--primary-foreground`, `--secondary`, `--muted-foreground`, `--border`, `--card`, `--destructive`, `--radius`) для `:root` и `.dark`. Сверь их с DESIGN.md и проверь контраст. Если нужен бренд-цвет, меняй только `--primary` и `--primary-foreground` в обеих темах, остальное не трогай. Переключатель темы ставит класс `dark` на `html`.
4. Добавь компоненты командой `npx shadcn@latest add button input card dialog tabs table badge dropdown-menu sonner` и собери страницу-витрину `/design-system`: палитра обеих тем с hex-кодами, шкала шрифтов, все компоненты в состояниях (обычное, наведение, фокус, неактивно, ошибка), переключатель темы. Компонент `sonner` берёт тему из `next-themes`: оберни приложение в `ThemeProvider` из `next-themes` с `attribute="class"`, иначе тосты не переключатся вместе с классом `dark`.
5. Дальше каждый экран собирай только из этих компонентов и токенов: никаких своих цветов и скруглений «на глаз». Если чего-то не хватает, сначала предложи дополнение в DESIGN.md.

Тексты интерфейса на русском, на «вы», как описано в разделе Voice & Content Strategy.

Файл DESIGN.md скопируется вместе с промптом

shadcn/ui — не пакет компонентов, а набор готового кода: команда shadcn add копирует компонент прямо в ваш проект, и он становится вашим. Основа — Radix UI и Tailwind CSS, вся тема живёт в CSS-переменных. Базовая тема neutral чёрно-белая, спокойная, с радиусом 10 px: подходит для SaaS, кабинетов и любых продуктов, где бренд-цвет добавляется поверх нейтральной основы.

Это наш конспект для ИИ-агента, а не официальный продукт. Значения токенов сверены с реестром тем shadcn/ui (MIT), цвета из oklch переведены в hex. Логотипы и фирменные иллюстрации мы не используем.

Всё лежит в одном файле DESIGN.md (открытый формат Google): вверху токены, ниже правила словами. Агент инициализирует shadcn/ui, подключает тему и собирает экраны из компонентов.

Что внутри

  • Палитра neutral: основной цвет почти чёрный #171717 (в тёмной теме светло-серый #E5E5E5), серая шкала, красный #E7000B для ошибок. Акцентов по умолчанию нет, бренд-цвет задаёте вы.
  • Две темы: светлая и тёмная (#0A0A0A), переключаются классом dark.
  • Шрифт Inter: заголовок 36 px, основной текст 16 px, подписи 14 px.
  • Радиус от 6 до 14 px (база 10 px), сетка Tailwind с шагом 4 px.
  • Компоненты: button, input, card, dialog, tabs, table, dropdown-menu, badge, sonner и ещё десятки.
  • Правила русского текста: «вы», короткие кнопки, человеческие ошибки.

Как пользоваться

  1. Скопируйте промпт: файл DESIGN.md скопируется вместе с ним.
  2. Вставьте в Claude Code, Cursor или другого агента в папке проекта на Vite или Next.js. Агент настроит Tailwind v4, выполнит npx shadcn@latest init и соберёт страницу-витрину.
  3. Дальше просите экраны («страница тарифов», «таблица клиентов»): агент добавляет нужные компоненты командой shadcn add и собирает экран.

В шаблонах shadcn по умолчанию может стоять Geist или системный шрифт. В этом конспекте взят Inter: он есть на Google Fonts и поддерживает кириллицу.

Откуда токены

Сверялись по официальным источникам:

Как получены hex: значения в shadcn заданы в oklch, мы пересчитали их в sRGB: oklch(0.205 0 0) = #171717, oklch(0.145 0 0) = #0A0A0A, oklch(0.985 0 0) = #FAFAFA, oklch(0.97 0 0) = #F5F5F5, oklch(0.556 0 0) = #737373, oklch(0.922 0 0) = #E5E5E5, oklch(0.577 0.245 27.325) = #E7000B. Граница в тёмной теме oklch(1 0 0 / 10%) наложена на фон и даёт #232323. Соответствие ролей: surface = background, surface-container = card (в светлой теме взят secondary, #F5F5F5, потому что карточка там белая), on-surface = foreground, on-surface-variant = muted-foreground, outline = border. Не сверено: размеры заголовков взяты со страницы Typography документации, но сами компоненты не задают шкалу, так что это рекомендации shadcn, а не жёсткие токены. В документации h1 extrabold (800), в конспекте 700: превью подключает Inter только до 700.

DESIGN.md
---
version: alpha
name: shadcn/ui neutral
description: Нейтральная дизайн-система shadcn/ui. Чёрно-белая основа, Inter, радиус 10 px, тема на CSS-переменных и Tailwind v4.
colors:
  primary: "#171717"
  on-primary: "#FAFAFA"
  secondary: "#F5F5F5"
  error: "#E7000B"
  secondary-dark: "#262626"
  light:
    surface: "#FFFFFF"
    surface-container: "#F5F5F5"
    on-surface: "#0A0A0A"
    on-surface-variant: "#737373"
    outline: "#E5E5E5"
  dark:
    primary: "#E5E5E5"
    on-primary: "#171717"
    error: "#FF6467"
    surface: "#0A0A0A"
    surface-container: "#171717"
    on-surface: "#FAFAFA"
    on-surface-variant: "#A1A1A1"
    outline: "#232323"
typography:
  headline-lg:
    fontFamily: Inter
    fontSize: 36px
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: -0.025em
  headline-md:
    fontFamily: Inter
    fontSize: 30px
    fontWeight: 600
    lineHeight: 1.2
    letterSpacing: -0.025em
  title-md:
    fontFamily: Inter
    fontSize: 20px
    fontWeight: 600
    lineHeight: 1.4
  body-md:
    fontFamily: Inter
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
  body-sm:
    fontFamily: Inter
    fontSize: 14px
    fontWeight: 400
    lineHeight: 1.43
  label-md:
    fontFamily: Inter
    fontSize: 14px
    fontWeight: 500
    lineHeight: 1
rounded:
  sm: 6px
  md: 8px
  lg: 10px
  xl: 14px
  full: 9999px
spacing:
  xs: 4px
  sm: 8px
  md: 16px
  lg: 24px
  xl: 32px
components:
  button-default:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.md}"
    height: 36px
    padding: 0 16px
  button-outline:
    backgroundColor: "{colors.light.surface}"
    textColor: "{colors.light.on-surface}"
    rounded: "{rounded.md}"
    height: 36px
  input:
    backgroundColor: transparent
    textColor: "{colors.light.on-surface}"
    rounded: "{rounded.md}"
    height: 36px
  card:
    backgroundColor: "{colors.light.surface}"
    rounded: "{rounded.xl}"
    padding: 24px
---

## Overview

shadcn/ui даёт нейтральную, почти бесцветную основу: белый и чёрный, серая шкала, тонкие границы и мягкие скругления. Интерфейс тихий и аккуратный, ничего не спорит с содержимым. Бренд-цвет добавляется поверх, одной заменой `primary`. Подходит для SaaS, кабинетов, документации и любых продуктов, где важна чистота и скорость. Светлая и тёмная темы равноправны.

## Colors

- **Primary (#171717), почти чёрный:** главная кнопка, активные элементы, выбранные состояния. Текст на нём `on-primary` (#FAFAFA). В тёмной теме роли меняются местами: `dark.primary` (#E5E5E5) с текстом #171717.
- **Secondary (#F5F5F5):** вторичная кнопка, фон бейджей и подсветка при наведении. В тёмной теме `secondary-dark` (#262626).
- **Error (#E7000B):** ошибки полей и деструктивные действия. В тёмной теме `dark.error` (#FF6467).
- Акцентных цветов в базовой теме нет. Если нужен бренд-цвет, замените `primary` и `on-primary` в обеих темах, остальные токены не меняйте.
- **Светлая тема:** фон `light.surface`, карточки и подложки `light.surface-container`, границы и разделители `light.outline`, основной текст `light.on-surface`, вторичный `light.on-surface-variant`.
- **Тёмная тема:** фон `dark.surface` (#0A0A0A), карточки `dark.surface-container` (#171717), границы `dark.outline` (в коде это белый с прозрачностью 10%).
- Цвета в коде берите из переменных (`bg-background`, `text-foreground`, `border-border`), а не из hex.

## Typography

Inter для всего интерфейса (в шаблонах shadcn может стоять Geist или системный шрифт, в конспекте принят Inter с кириллицей). Заголовок страницы 36 px с жирностью 700 и плотным трекингом, заголовок раздела 30 px и 600. Основной текст 16 px, подписи, поля и кнопки 14 px, подпись кнопок и полей средней жирности (500). Моноширинный системный шрифт для кода. Не больше трёх размеров на экране, жирность 400, 500, 600 и 700.

## Layout

Отступы кратны 4 px (шаг Tailwind): внутри компонентов 8–16 px, карточек 24 px, между блоками 24–32 px, между секциями лендинга 64–96 px. Контент не шире 1280 px по центру, текст и формы не шире 640 px. Поля страницы 16 px на телефоне, 24–32 px на десктопе. Кабинет: боковая панель 256 px слева, сверху строка с поиском и профилем, контент в карточках.

## Elevation & Depth

Глубина почти плоская: карточка отделяется тонкой границей 1 px `outline` и фоном `surface-container`. Тени лёгкие и только у карточек с действием и всплывающих слоёв: `0 1px 2px rgba(0,0,0,0.05)` у карточки, средняя тень у меню, диалога и всплывающих подсказок. Не усиливайте тени.

## Shapes

Радиус задаётся одной переменной `--radius` (10 px), остальные ступени считаются от неё: 6 px (`sm`, мелкие элементы, чекбоксы), 8 px (`md`, кнопки и поля), 10 px (`lg`, карточки малого размера), 14 px (`xl`, карточки, диалоги). Бейджи, аватары и переключатели круглые. Меняя радиус, меняйте только переменную `--radius`.

## Motion

Короткие переходы 150–200 мс, анимация открытия диалогов и меню плавная с затуханием (`fade` и небольшое смещение). Анимируются `opacity` и `transform`. При `prefers-reduced-motion` движение отключается.

## Voice & Content Strategy

- Тон: спокойный, ясный, на «вы». Без восклицательных знаков и маркетинговых обещаний.
- Регистр: с заглавной только первое слово (заголовки, кнопки, пункты меню).
- Кнопки называют результат: «Создать проект», «Сохранить», «Пригласить». Не «ОК» и не «Отправить».
- Пустые состояния объясняют, что здесь появится, и дают одну кнопку.
- Ошибки: что случилось и что делать, под полем: «Укажите адрес почты в формате name@example.com».
- Числа: пробел между разрядами (12 500), даты «24 ноября», время «14:30», деньги «1 990 ₽».

## Components

- **Кнопки:** default (залита primary), secondary (серая подложка), outline (граница `outline`, прозрачная), ghost (только текст, подсветка при наведении), destructive (error), link. Высота 36 px (по умолчанию), 32 и 40 px (sm и lg), радиус 8 px. На экране одна default-кнопка. Фокус: кольцо 3 px с прозрачностью 50% цвета `ring`. Неактивная: прозрачность 50%.
- **Поля ввода:** прозрачный фон, граница 1 px `outline`, высота 36 px, радиус 8 px, подпись сверху (`label-md`), подсказка или ошибка снизу (`body-sm`). Фокус: граница и кольцо `ring`. Ошибка: граница и текст error.
- **Карточка (card):** фон `surface` (в тёмной `surface-container`), граница `outline`, радиус 14 px, отступ 24 px, заголовок `title-md`, описание `body-sm` на `on-surface-variant`.
- **Диалог (dialog):** ширина до 512 px, радиус 10 px, затемнение фона, кнопки справа внизу.
- **Вкладки (tabs):** сегмент на подложке `surface-container`, активная вкладка на `surface`.
- **Таблица (table):** строки 48 px, разделители `outline`, заголовки колонок `label-md` на `on-surface-variant`, числа выровнены вправо.
- **Бейдж (badge):** высота 22 px, круглый, цвет primary, secondary, outline или destructive.
- **Уведомление (sonner):** снизу справа, закрывается через 4 секунды.

## Do's and Don'ts

- Делайте одну залитую default-кнопку на экран, остальные действия outline, secondary или ghost.
- Берите цвета из переменных темы (`background`, `foreground`, `primary`, `border`), а не hex в компонентах.
- Меняйте бренд-цвет только через `--primary` и `--primary-foreground` в обеих темах.
- Проверяйте контраст: текст на фоне не ниже 4.5:1, вторичный текст и иконки 3:1.
- Не добавляйте новые цвета, тени и скругления «на глаз»: сначала дополните DESIGN.md.
- Не правьте файлы компонентов ради одной страницы: меняйте тему, а не код отдельного экрана.

Только файл: сохраните его как DESIGN.md в корне проекта

Похожие