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

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

Gravity UI — открытая дизайн-система Яндекса для веб-сервисов

Тёплый жёлтый акцент, плотный Inter 13–15 px и светлая и тёмная темы. Для кабинетов, админок и инструментов.

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

Что сделать:
1. Сохрани файл как DESIGN.md в корне проекта без изменений. Это источник правды для интерфейса: перед каждым новым экраном перечитывай его.
2. Поставь официальный пакет: `npm install @gravity-ui/uikit`. Нужен React 18 или 19. В точке входа один раз подключи стили: `import '@gravity-ui/uikit/styles/fonts.css'` и `import '@gravity-ui/uikit/styles/styles.css'`. Обязательно оберни приложение в `Provider` из пакета: `<Provider theme="system">` (значения `theme`: `light`, `dark`, `light-hc`, `dark-hc`, `system`). Иконки: `npm install @gravity-ui/icons`, использовать как `<Icon data={Gear} size={16} />`.
3. Токены Gravity UI уже лежат в CSS-переменных `--g-color-*`, `--g-border-radius-*`, `--g-spacing-*`. Не переопределяй их без необходимости. Если нужен свой акцент, переопредели `--g-color-base-brand` отдельным классом темы и проверь контраст текста на нём.
4. Собери страницу-витрину `/design-system` из официальных компонентов: кнопки (`view="action"`, `normal`, `outlined`, размеры `s`, `m`, `l`), `TextInput`, `Select`, `Tabs`, `Card`, `Modal`, `Label`, `Toaster`, `Table` из `@gravity-ui/table` для данных (ставится отдельно вместе с зависимостями: `npm install @gravity-ui/table @gravity-ui/icons @dnd-kit/core @dnd-kit/sortable lodash`). Покажи состояния (обычное, наведение, фокус, неактивно, ошибка) и переключатель темы.
5. Дальше каждый экран собирай только из компонентов Gravity UI и токенов: никаких своих цветов и скруглений «на глаз». Если чего-то не хватает, сначала предложи дополнение в DESIGN.md.

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

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

Gravity UI — открытая библиотека интерфейсов, которую Яндекс сделал для своих внутренних сервисов и выложил в open source. Она рассчитана на плотные рабочие экраны: кабинеты, админки, таблицы, настройки. Спокойная нейтральная палитра, один тёплый жёлтый акцент, небольшой Inter 13–15 px и аккуратные скругления 5–10 px.

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

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

Что внутри

  • Палитра: акцент #FFBE5C (жёлтый) с тёмным текстом, голубой для информации, красный для ошибок, зелёный для успеха. Две темы: светлая и тёмная (#221D22, чуть тёплая).
  • Шрифт Inter: основной текст 13 и 15 px, заголовки 24 и 32 px с жирностью 600.
  • Скругления от 3 до 10 px, шаг отступов 4 px.
  • Компоненты: кнопки с видами action, normal, outlined, поля, табы, карточки, модальное окно, уведомления, меню.
  • Правила русского текста: «вы», короткие кнопки, человеческие ошибки.

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

  1. Скопируйте промпт: файл DESIGN.md скопируется вместе с ним.
  2. Вставьте в Claude Code, Cursor или другого агента в папке React-проекта. Агент поставит @gravity-ui/uikit, подключит стили и тему и соберёт страницу-витрину.
  3. Дальше просите экраны («таблица заказов», «настройки профиля»): агент берёт готовые компоненты и токены.

Заметьте: у Gravity UI акцент жёлтый, а текст на нём тёмный. Если ставите свой бренд-цвет, меняйте primary и проверяйте контраст текста на нём.

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

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

  • Сайт и документация: gravity-ui.com.
  • Тема и провайдер: раздел Theming в README пакета и docs/theming.md в репозитории gravity-ui/uikit (там ThemeProvider / Provider с theme).
  • Исходники и README пакета: github.com/gravity-ui/uikit, файлы styles/themes/default.generated.css (цвета тем light и dark), styles/themes/common/typography.scss, styles/themes/common/spacing.scss, styles/fonts.scss.
  • Лицензия: MIT (LICENSE).

Как получены hex: в Gravity UI многие цвета заданы с прозрачностью (например, основной текст rgba(0,0,0,0.85) на белом). Мы пересчитали их в сплошные hex на фоне темы: текст #262626, вторичный #808080, разделитель #E6E6E6 в светлой теме; #DEDDDE, #918E91, #433F43 в тёмной. Фон тёмной темы #221D22, плавающие поверхности #383438. Токена secondary как роли в Gravity UI нет, взят цвет информации #348BDC. Не сверено отдельно: размеры заголовков в компонентах (Text) мы берём из шкалы токенов, а не из каждого компонента.

DESIGN.md
---
version: alpha
name: Gravity UI
description: Открытая дизайн-система Яндекса для плотных рабочих интерфейсов. Нейтральная палитра, тёплый жёлтый акцент, Inter 13–15 px.
colors:
  primary: "#FFBE5C"
  on-primary: "#261C0E"
  secondary: "#348BDC"
  success: "#30AA6E"
  error: "#E9033A"
  light:
    surface: "#FFFFFF"
    surface-container: "#F2F2F2"
    on-surface: "#262626"
    on-surface-variant: "#808080"
    outline: "#E6E6E6"
  dark:
    surface: "#221D22"
    surface-container: "#383438"
    on-surface: "#DEDDDE"
    on-surface-variant: "#918E91"
    outline: "#433F43"
typography:
  headline-lg:
    fontFamily: Inter
    fontSize: 32px
    fontWeight: 600
    lineHeight: 1.25
  headline-md:
    fontFamily: Inter
    fontSize: 24px
    fontWeight: 600
    lineHeight: 1.17
  title-md:
    fontFamily: Inter
    fontSize: 20px
    fontWeight: 600
    lineHeight: 1.2
  body-md:
    fontFamily: Inter
    fontSize: 15px
    fontWeight: 400
    lineHeight: 1.33
  body-sm:
    fontFamily: Inter
    fontSize: 13px
    fontWeight: 400
    lineHeight: 1.38
  label-md:
    fontFamily: Inter
    fontSize: 13px
    fontWeight: 600
    lineHeight: 1.38
rounded:
  xs: 3px
  sm: 5px
  md: 6px
  lg: 8px
  xl: 10px
  full: 9999px
spacing:
  xs: 4px
  sm: 8px
  md: 16px
  lg: 24px
components:
  button-action:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.lg}"
    height: 28px
  button-normal:
    backgroundColor: "{colors.light.surface-container}"
    textColor: "{colors.light.on-surface}"
    rounded: "{rounded.lg}"
    height: 28px
  input:
    backgroundColor: transparent
    textColor: "{colors.light.on-surface}"
    rounded: "{rounded.lg}"
    height: 28px
  card:
    backgroundColor: "{colors.light.surface}"
    rounded: "{rounded.xl}"
    padding: 16px
---

## Overview

Gravity UI сделан для людей, которые работают в интерфейсе каждый день: операторы, аналитики, разработчики. Экран плотный и спокойный: нейтральный фон, мелкий читаемый Inter, один тёплый жёлтый акцент на главном действии. Ничего лишнего, чтобы данные и таблицы оставались в центре внимания. Светлая и тёмная темы равноправны.

## Colors

- **Primary (#FFBE5C), жёлтый:** главная кнопка (`view="action"`), выделение, активные элементы. Текст на нём тёмный (`on-primary` #261C0E), не белый.
- **Secondary (#348BDC), голубой:** информационные плашки, ссылки внутри данных, подсказки. Не для кнопок.
- **Success (#30AA6E) и Error (#E9033A):** статусы, уведомления и ошибки полей. В тёмной теме красный чуть светлее (#E5325D), зелёный #4DB09B.
- Светлая тема: фон `light.surface`, поверхности и подсветка строк `light.surface-container`, границы `light.outline`, текст `light.on-surface`, вторичный `light.on-surface-variant`.
- Тёмная тема: фон `dark.surface` (#221D22, с лёгким тёплым оттенком), плавающие слои `dark.surface-container`, границы `dark.outline`.
- В исходной системе вторичные цвета заданы прозрачностью чёрного или белого поверх фона. В коде используйте переменные `--g-color-*`, а не эти hex.

## Typography

Inter для всего интерфейса. Основной текст в рабочих экранах 13 px (`body-sm`), в формах и описаниях 15 px (`body-md`). Заголовки страниц 24 px, крупные заголовки 32 px, жирность 600. Подписи и метки 13 px с жирностью 600. Код и ключи набирайте системным моноширинным шрифтом. Не больше трёх размеров на экране. Шрифт подключается из пакета (`fonts.css`), в шаблонах других систем может быть иначе.

## Layout

Сетка отступов с шагом 4 px: внутри компонентов 4–12 px, между блоками 16–24 px. Рабочие экраны занимают всю ширину с полями 16–24 px, текст и формы не шире 720 px. Шапка с поиском и профилем сверху, навигация слева 240–280 px, на телефоне навигация прячется в меню. Таблицы и списки плотные: строка 36–40 px.

## Elevation & Depth

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

## Shapes

Шкала скруглений: 3 px (чекбоксы, мелкие метки), 5 и 6 px (поля, кнопки малых размеров), 8 px (кнопки, карточки, выпадающие списки), 10 px (модальные окна, крупные панели). Метки-таблетки и переключатели круглые. Не смешивайте скругления в одном ряду элементов.

## Motion

Анимация короткая и функциональная: появление выпадающих слоёв, смена состояния кнопки, раскрытие. 100–200 мс с лёгким замедлением. Анимируются `opacity` и `transform`. При `prefers-reduced-motion` движения отключаются.

## Voice & Content Strategy

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

## Components

- **Кнопки:** `action` (залита primary, тёмный текст, одна на экран), `normal` (серая подложка), `outlined` (граница), `flat` (только текст). Размеры s 24, m 28, l 36, xl 44 px, скругление 8 px. Неактивная: прозрачность 40%.
- **Поля ввода:** граница `outline`, высота 28 px (m) или 36 px (l), подпись сверху, подсказка и ошибка снизу (`body-sm`). Фокус: граница primary. Ошибка: граница и текст error.
- **Табы:** подчёркивание под активным пунктом цветом primary, высота 36–40 px.
- **Карточки:** фон `surface`, граница `outline`, скругление 10 px, отступ 16 px.
- **Таблица:** строки 36–40 px, разделители `outline`, заголовки колонок `label-md` на `on-surface-variant`, числа выровнены вправо.
- **Метки (Label):** высота 20–28 px, скругление 6 px или полностью круглые, цвет по смыслу: info, success, danger, warning.
- **Модальное окно:** ширина 400–640 px, скругление 10 px, затемнение фона, кнопки справа внизу.
- **Уведомления (Toaster):** справа внизу, закрываются сами через 5 секунд.

## Do's and Don'ts

- Делайте одну залитую жёлтую кнопку (`action`) на экран, остальные действия `normal` или `outlined`.
- Ставьте тёмный текст на жёлтом, а не белый.
- Берите цвета и размеры из переменных `--g-*`, не из hex в стилях компонентов.
- Проверяйте контраст: текст на фоне не ниже 4.5:1, вторичный и иконки 3:1.
- Не используйте жёлтый для ошибок и предупреждений рядом с кнопкой-акцентом: путаются смыслы.
- Не показывайте логотипы Яндекса и не выдавайте продукт за сервис Яндекса.

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

Похожие