React Native Paper — дизайн-система Material 3 для мобильных приложений
Конспект открытой библиотеки React Native Paper: темы Material 3 MD3LightTheme и MD3DarkTheme, фиолетовый акцент, Expo.
Промпт
Подключи к моему проекту (Expo, React Native) официальную библиотеку React Native Paper: пакет react-native-paper (автор Callstack, лицензия MIT, документация: callstack.github.io/react-native-paper). Ниже мой конспект DESIGN.md в открытом формате Google: токены и правила интерфейса.
Что сделать:
1. Сохрани файл как DESIGN.md в корне проекта без изменений. Перед каждым новым экраном перечитывай его.
2. Установи пакеты: npx expo install react-native-paper react-native-safe-area-context. Иконки в Expo уже есть (@expo/vector-icons). Если проект не на Expo, сверься с разделом Getting started в документации Paper для твоей версии.
3. Оберни корень приложения в PaperProvider из react-native-paper. Тему выбирай по настройке системы: MD3LightTheme или MD3DarkTheme (через useColorScheme из react-native). Если нужен свой цвет бренда, расширь тему через spread: { ...MD3LightTheme, colors: { ...MD3LightTheme.colors, primary: '...' } }. Не меняй остальные цвета.
4. Собери экран-витрину: Appbar сверху, список List.Item внутри Card, поле TextInput (mode outlined), кнопки Button трёх видов (contained, outlined, text), Chip, FAB, Dialog, Snackbar и нижняя навигация. Проверь светлую и тёмную тему и безопасные зоны (SafeAreaProvider, SafeAreaView).
5. Дальше собирай экраны только из компонентов Paper и токенов из DESIGN.md. Цвета бери из useTheme().colors, не пиши hex в стилях. Если нужного компонента нет, сначала предложи вариант, потом используй.
Тексты интерфейса на русском, на «вы», без восклицательных знаков.
Файл DESIGN.md скопируется вместе с промптом
Конспект открытой библиотеки React Native Paper для ИИ-агента. Paper реализует Material Design 3 для React Native: готовые кнопки, карточки, поля, диалоги, нижняя навигация и две темы (светлая и тёмная) с фиолетовым акцентом #6750A4. Работает в Expo и в обычном React Native, на iOS и Android.
Это не официальный продукт Google или Callstack и не замена документации. Токены и правила ниже выписаны из исходников темы и документации, чтобы агент собирал экраны из готовых компонентов. Пакет react-native-paper распространяется по лицензии MIT, вы ставите его из npm, а не копируете из конспекта.
Всё лежит в одном файле DESIGN.md (открытый формат Google): вверху токены, ниже правила словами. Агент читает файл и собирает каждый экран в одном стиле, не придумывая цвета заново.
Что внутри
Палитра Material 3 по умолчанию: светлая (#FFFBFE фон, #6750A4 акцент) и тёмная (#1C1B1F фон, #D0BCFF акцент). Вторичный #625B71, третичный #7D5260, ошибка #B3261E.
Шрифт: в приложении системный (на iOS System, на Android sans-serif, в вебе Roboto). В конспекте и превью Roboto.
Шкала текста Material 3: от headlineLarge 32 px до labelSmall 11 px.
Что не удалось сверить точно: в ветке main репозитория идёт версия 6 (alpha) с другими значениями фона (#FEF7FF и #141218), здесь взята стабильная 5.15.5. Цвет surface-container взят из слоя возвышения elevation.level2 темы. Шкала отступов в библиотеке не задана, значения 4, 8, 16, 24 px приняты по рекомендациям Material Design 3. Радиусы получены умножением roundness на множители компонентов из документации и исходников; у отдельных компонентов могут отличаться.
DESIGN.md
---
version: alpha
name: React Native Paper
description: Конспект открытой библиотеки React Native Paper (Material 3). Фиолетовый акцент, светлая и тёмная темы MD3, овальные кнопки, карточки с лёгкой тональной заливкой.
colors:
primary: "#6750A4"
on-primary: "#FFFFFF"
secondary: "#625B71"
tertiary: "#7D5260"
error: "#B3261E"
light:
surface: "#FFFBFE"
surface-container: "#F3EDF6"
on-surface: "#1C1B1F"
on-surface-variant: "#49454F"
outline: "#79747E"
primary-container: "#EADDFF"
on-primary-container: "#21005D"
surface-variant: "#E7E0EC"
outline-variant: "#CAC4D0"
dark:
surface: "#1C1B1F"
surface-container: "#2C2831"
on-surface: "#E6E1E5"
on-surface-variant: "#CAC4D0"
outline: "#938F99"
primary: "#D0BCFF"
on-primary: "#381E72"
secondary: "#CCC2DC"
tertiary: "#EFB8C8"
error: "#F2B8B5"
primary-container: "#4F378B"
on-primary-container: "#EADDFF"
surface-variant: "#49454F"
typography:
headline-lg:
fontFamily: Roboto
fontSize: 32px
fontWeight: 400
lineHeight: 1.25
headline-md:
fontFamily: Roboto
fontSize: 28px
fontWeight: 400
lineHeight: 1.29
title-lg:
fontFamily: Roboto
fontSize: 22px
fontWeight: 400
lineHeight: 1.27
title-md:
fontFamily: Roboto
fontSize: 16px
fontWeight: 500
lineHeight: 1.5
letterSpacing: 0.15px
body-lg:
fontFamily: Roboto
fontSize: 16px
fontWeight: 400
lineHeight: 1.5
letterSpacing: 0.5px
body-md:
fontFamily: Roboto
fontSize: 14px
fontWeight: 400
lineHeight: 1.43
letterSpacing: 0.25px
label-md:
fontFamily: Roboto
fontSize: 14px
fontWeight: 500
lineHeight: 1.43
letterSpacing: 0.1px
label-sm:
fontFamily: Roboto
fontSize: 12px
fontWeight: 500
lineHeight: 1.33
letterSpacing: 0.5px
rounded:
xs: 4px
sm: 8px
md: 12px
lg: 28px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
components:
button-contained:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
height: 40px
padding: 0 24px
text-input:
backgroundColor: "{colors.light.surface}"
textColor: "{colors.light.on-surface}"
rounded: "{rounded.xs}"
height: 56px
card:
backgroundColor: "{colors.light.surface-container}"
rounded: "{rounded.md}"
dialog:
backgroundColor: "{colors.light.surface-container}"
rounded: "{rounded.lg}"
---
## Overview
Paper это Material Design 3 для React Native: знакомый язык Android-приложений Google. Спокойный светлый фон с лёгким розоватым оттенком, фиолетовый акцент, овальные кнопки, карточки с тональной заливкой вместо жёстких теней. Интерфейс мягкий и дружелюбный. Темы две: светлая `MD3LightTheme` и тёмная `MD3DarkTheme`, выбирать по настройке системы. На iOS компоненты выглядят так же, как на Android: это единый дизайн, а не копия iOS.
## Colors
В Paper цвет это роли темы (`primary`, `onPrimary`, `primaryContainer`, `surface`, `onSurface`, `outline` и другие), доступные через `useTheme().colors`. Значения выбираются из тональных палитр Material 3. Роли в нашем файле:
- **Primary (#6750A4), фиолетовый:** главные кнопки, активные элементы, переключатели, фокус. Белый текст `#FFFFFF` читается хорошо. В тёмной теме роль светлее: `dark.primary` `#D0BCFF` с тёмным текстом `dark.on-primary` `#381E72`.
- **Secondary (#625B71):** второстепенные элементы, чипы, неактивные акценты.
- **Tertiary (#7D5260):** редкий контрастный акцент, например бейдж или иллюстрация.
- **Error (#B3261E):** ошибки полей и деструктивные действия. В тёмной теме `#F2B8B5`.
- **Контейнеры:** `primaryContainer` (#EADDFF, в тёмной #4F378B) для выбранных пунктов и мягких кнопок, текст на нём `onPrimaryContainer`.
- **Светлая тема:** фон `surface` (#FFFBFE), карточки и диалоги `surface-container` (#F3EDF6, это `elevation.level2`), текст `on-surface` (#1C1B1F), вторичный текст `on-surface-variant` (#49454F), граница `outline` (#79747E).
- **Тёмная тема:** фон `surface` (#1C1B1F), карточки `surface-container` (#2C2831), текст `#E6E1E5`, вторичный `#CAC4D0`, граница `#938F99`.
- Своего бренда добавляйте через замену `primary` в теме, не трогая остальные роли.
## Typography
В приложении будет системный шрифт: на iOS `System`, на Android `sans-serif` (Roboto), в вебе стек с Roboto. В конспекте и превью Roboto: шрифт Google Fonts с кириллицей. Не подключайте свои шрифты без необходимости.
Шкала Material 3 из темы (размер и высота строки в пикселях): `headlineLarge` 32/40, `headlineMedium` 28/36, `headlineSmall` 24/32, `titleLarge` 22/28, `titleMedium` 16/24 вес 500, `titleSmall` 14/20 вес 500, `bodyLarge` 16/24 (межбуквенный 0.5), `bodyMedium` 14/20 (0.25), `bodySmall` 12/16 (0.4), `labelLarge` 14/20 вес 500 (0.1), `labelMedium` 12/16 вес 500, `labelSmall` 11/16 вес 500. В коде используйте `<Text variant="bodyLarge">`.
## Layout
Поля экрана 16 px, между блоками 16–24 px, внутри карточки 16 px. Шкала отступов в библиотеке не задана, примите 4, 8, 16, 24, 32 px. Зона нажатия не меньше 48 x 48 px. Сверху `Appbar` (высота 64 px у `Appbar.Header` в Material 3), снизу `BottomNavigation` из 3–5 пунктов или `FAB`. Учитывайте безопасные зоны: `SafeAreaProvider` и `useSafeAreaInsets` из `react-native-safe-area-context`, особенно снизу и у выреза экрана.
## Elevation & Depth
Material 3 показывает возвышение тоном, а не тенью. Уровни `elevation.level0` – `level5` это всё более «закрашенные» поверхности: в светлой теме от `#F7F3F9` до `#E9E3F1`, в тёмной от `#25232A` до `#34313F`. Компонент `Surface` и `Card` принимают пропс `elevation`. Тень на Android дополнительная и лёгкая. Диалоги и меню поднимаются выше (уровни 3 и выше). Не добавляйте собственные тени.
## Shapes
Базовый `roundness` темы равен 4 px, компоненты умножают его: поля ввода 4 px, чипы 8 px, карточки 12 px, FAB 16 px, диалоги 28 px, кнопки овальные (полностью скруглённые), аватары круглые. Не задавайте произвольные радиусы.
## Motion
Короткие стандартные переходы Material 3: появление диалога и меню 150–250 мс, ripple-эффект при нажатии на Android, плавное смещение при переключении вкладок. Масштаб анимаций задаётся `theme.animation.scale`, при системной настройке «убрать анимации» ставьте 0. Анимируйте только прозрачность и положение.
## Voice & Content Strategy
- Тон: тёплый и ясный, на «вы». Без восклицательных знаков.
- Заголовки экранов короткие, с заглавной только первого слова: «Мои заказы», «Настройки».
- Кнопки это глагол: «Войти», «Сохранить», «Добавить в корзину». Не «ОК».
- Пустое состояние: одно предложение, что здесь появится, и одна кнопка.
- Ошибки в подписи поля: что не так и как исправить: «Введите номер в формате +7».
- Цены «1 990 ₽», время «14:30», даты «24 ноября».
## Components
- **PaperProvider:** корневая обёртка с темой (`MD3LightTheme` или `MD3DarkTheme`). Без неё компоненты не получат цвета.
- **Appbar:** верхняя панель с заголовком и действиями (`Appbar.Header`, `Appbar.Content`, `Appbar.Action`, `Appbar.BackAction`).
- **Button:** режимы `contained` (залитая), `contained-tonal`, `outlined`, `text`, `elevated`. Одна залитая кнопка на экран. Минимальная ширина 64 px, высота 40 px.
- **Card:** режимы `elevated`, `filled`, `outlined`, внутри `Card.Title`, `Card.Content`, `Card.Actions`.
- **TextInput:** режимы `flat` и `outlined`, подпись `label`, ошибка через `error` и `HelperText`. Высота около 56 px.
- **List.Item, List.Section, Divider:** списки настроек и меню, значок слева и действие справа.
- **Chip, Checkbox, RadioButton, Switch, SegmentedButtons:** выбор и фильтры.
- **FAB:** главное действие экрана в нижнем правом углу.
- **BottomNavigation:** нижняя навигация из 3–5 пунктов с иконками и подписями, активный пункт в `secondaryContainer`.
- **Dialog, Modal, Snackbar, Menu:** диалоги подтверждения, всплывающие слои и сообщения о результате.
## Do's and Don'ts
- Оборачивайте приложение в PaperProvider и выбирайте тему по настройке системы.
- Берите цвета из `useTheme().colors`, а не из hex в стилях.
- Проверяйте светлую и тёмную темы и безопасные зоны на iOS и Android.
- Делайте одну залитую кнопку на экран, остальные tonal, outlined или text.
- Держите зону нажатия не меньше 48 px.
- Не задавайте произвольные радиусы и тени: возвышение показывайте пропсом `elevation`.
- Не смешивайте Paper с другой библиотекой компонентов на одном экране.
- Не используйте логотипы Google, Material и Callstack в интерфейсе своего приложения.
Только файл: сохраните его как DESIGN.md в корне проекта