Ionic — дизайн-система для мобильных приложений на веб-технологиях
Одна кодовая база на React или Vue выглядит родным приложением на iPhone и Android. Девять цветов, вкладки, списки, жесты.
Промпт
Подключи к моему проекту дизайн-систему Ionic Framework (Ionic, лицензия MIT, https://ionicframework.com). Ниже DESIGN.md — конспект системы в открытом формате Google: вверху YAML-токены, ниже правила словами.
Что сделать:
1. Сохрани файл как DESIGN.md в корне проекта без изменений и перечитывай его перед каждым новым экраном.
2. Если проекта ещё нет — создай через Ionic CLI: `npm install -g @ionic/cli`, затем `ionic start <имя> tabs --type=react` (или `--type=vue`, если я пишу на Vue). Если проект уже есть на React — поставь `@ionic/react` и `@ionic/react-router`, вызови `setupIonicReact()` до рендера и подключи CSS Ionic: `core.css`, `normalize.css`, `structure.css`, `typography.css` и утилиты (`padding.css`, `flex-utils.css` и остальные из документации). Тёмную тему подключи по системной настройке: `@ionic/react/css/palettes/dark.system.css`. Сверяйся с документацией той версии, которая встала.
3. Цвета из токенов задай через переменные Ionic в `theme/variables.css`: `--ion-color-primary`, `-contrast`, `-shade`, `-tint` и так для всех девяти цветов. Если я меняю primary — пересчитай shade (на 12% темнее) и tint (на 10% светлее), как делает генератор цветов Ionic.
4. Собери экран-витрину во вкладке «Компоненты»: шапка `IonHeader` с большим заголовком, `IonList` со строками и свайпом, `IonCard`, кнопки всех цветов и размеров, `IonInput` с подписью и ошибкой, `IonToggle`, `IonSegment`, `IonModal` снизу с точками остановки, `IonToast`. Проверь на видах iPhone и Android.
5. Дальше каждый экран собирай только из компонентов `Ion*` и токенов. Не рисуй свои кнопки и вкладки: Ionic сам подстраивает их под платформу. Для сборки в App Store и Google Play используй Capacitor (`ionic capacitor add ios` / `android`).
Тексты интерфейса — на русском, на «вы», как в разделе Voice & Content Strategy.
Файл DESIGN.md скопируется вместе с промптом
Ionic Framework — открытый набор компонентов (MIT), который превращает веб-приложение на React, Vue или Angular в мобильное. Каждый компонент знает две «моды»: на iPhone выглядит по правилам iOS, на Android — по Material. Через Capacitor то же приложение собирается в App Store и Google Play, а в браузере работает как PWA.
DESIGN.md ниже — наш конспект для ИИ-агента: девять цветов Ionic из исходников 9-й версии, тёмная палитра, размеры и скругления обеих мод, правила экранов и текстов на русском. Агент ставит официальный пакет и собирает экраны из готовых компонентов ion-*, а не рисует кнопки с нуля.
Что внутри
Цвета: primary #0054E9, secondary, tertiary, success, warning, danger и нейтральные light, medium, dark, у каждого есть контрастный цвет текста, тень и подсветка.
Тёмная тема: отдельная палитра Ionic (у Android фон #121212, у iPhone чистый чёрный), подключается одним CSS-файлом.
Две моды: iOS (кнопки 14 px скругления, системный шрифт) и Material (кнопки 4 px, Roboto, подписи заглавными).
Компоненты: вкладки внизу, шапка с заголовком, списки, карточки, модальные окна снизу, свайп по строке, обновление потягиванием.
Как пользоваться
Скопируйте промпт: файл DESIGN.md скопируется вместе с ним.
Вставьте в Claude Code или Cursor в папке проекта. Агент поставит Ionic, подключит темы и соберёт экран-витрину со вкладками.
Проверяйте на телефоне: ionic serve открывает приложение в браузере, а в инструментах разработчика можно включить вид iPhone или Android.
Кнопки и карточки: button.ios.vars.scss, button.md.vars.scss, card.ios.vars.scss, card.md.vars.scss в том же репозитории.
Сверено с версией @ionic/core 9.0.13.
DESIGN.md
---
version: alpha
name: Ionic
description: Компоненты для мобильных приложений на веб-технологиях. Девять цветов, две моды (iOS и Material), тёмная палитра.
colors:
primary: "#0054E9"
on-primary: "#FFFFFF"
secondary: "#0163AA"
tertiary: "#6030FF"
success: "#2DD55B"
warning: "#FFC409"
error: "#C5000F"
medium: "#636469"
light:
surface: "#FFFFFF"
surface-container: "#F4F5F8"
on-surface: "#000000"
on-surface-variant: "#636469"
outline: "#D9D9D9"
dark:
primary: "#4D8DFF"
on-primary: "#000000"
surface: "#121212"
surface-container: "#1E1E1E"
on-surface: "#FFFFFF"
on-surface-variant: "#989AA2"
outline: "#363636"
typography:
headline-lg:
fontFamily: Roboto
fontSize: 34px
fontWeight: 700
lineHeight: 1.2
headline-md:
fontFamily: Roboto
fontSize: 20px
fontWeight: 500
lineHeight: 1.3
body-md:
fontFamily: Roboto
fontSize: 16px
fontWeight: 400
lineHeight: 1.5
body-sm:
fontFamily: Roboto
fontSize: 14px
fontWeight: 400
lineHeight: 1.45
label-md:
fontFamily: Roboto
fontSize: 14px
fontWeight: 500
lineHeight: 1.2
rounded:
sm: 4px
md: 8px
lg: 14px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
padding: 16px
components:
button-ios:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
rounded: "{rounded.lg}"
height: 3.1em
button-md:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
rounded: "{rounded.sm}"
height: 36px
card-ios:
rounded: "{rounded.md}"
card-md:
rounded: "{rounded.sm}"
item:
backgroundColor: "{colors.light.surface}"
height: 44px
---
## Overview
Ionic — для мобильных приложений, которые пишутся один раз на React, Vue или Angular и работают на iPhone, Android и в браузере. Система не навязывает свой бренд: она старается выглядеть «как родное приложение» на каждой платформе. Поэтому главное правило — брать компоненты Ionic как есть, а фирменность добавлять цветом primary, иконками и текстами.
## Colors
У Ionic девять именованных цветов. У каждого четыре значения: основной, контрастный (цвет текста на нём), shade (на 12% темнее, для нажатия) и tint (на 10% светлее, для наведения).
- **Primary (#0054E9):** главное действие, активная вкладка, переключатели и ссылки.
- **Secondary (#0163AA) и Tertiary (#6030FF):** второстепенные кнопки и акценты.
- **Success (#2DD55B), Warning (#FFC409), Danger (#C5000F):** статусы. Текст на success и warning чёрный, на danger белый.
- **Light (#F4F5F8), Medium (#636469), Dark (#222428):** нейтральные. Medium — вторичный текст и иконки.
- **Светлая тема:** фон белый, текст чёрный, разделители и ступени фона получаются смешиванием текста с фоном (5%, 10%, 15% и далее).
- **Тёмная тема:** у Android фон `#121212`, строки и карточки `#1E1E1E`; у iPhone фон чёрный `#000000`, карточки `#1C1C1D`. Primary в тёмной теме светлее, `#4D8DFF`, и текст на нём чёрный: поэтому в токенах он вынесен в `dark.primary` и `dark.on-primary`.
## Typography
На Android и в браузере — Roboto, на iPhone — системный шрифт San Francisco, Ionic выбирает сам. Большой заголовок экрана на iPhone 34 px жирным, обычный заголовок шапки — 17 px (iOS) или 20 px (Material). Текст в строках 16 px, подписи 14 px. Ionic учитывает системный размер шрифта (Dynamic Type), поэтому размеры не фиксируйте в пикселях в своих стилях: используйте типографику компонентов.
## Layout
Экран — это `IonPage` с шапкой `IonHeader` и прокручиваемым `IonContent`. Основная навигация — вкладки внизу (`IonTabs`), 3–5 штук. Стандартный отступ 16 px (`ion-padding`), между группами 24 px. Безопасные зоны (вырез, полоска «домой») Ionic учитывает сам через `--ion-safe-area-*`. На планшете и в браузере используйте `IonSplitPane`: меню слева, контент справа.
## Elevation & Depth
На iPhone глубина — через сгруппированные списки на сером фоне и полупрозрачную шапку. На Android — тени у карточек, плавающей кнопки и шапки при прокрутке. Не добавляйте свои тени поверх компонентов: каждая мода рисует их по своим правилам.
## Shapes
Кнопки: 14 px скругления на iOS (большие 16 px), 4 px на Material. Карточки: 8 px на iOS, 4 px на Material. Чипсы и переключатели — круглые. Модальное окно снизу (sheet) — со скруглёнными верхними углами.
## Motion
Переходы между экранами Ionic анимирует сам: на iOS экран выезжает справа, на Android всплывает снизу. Используйте встроенные жесты: свайп назад на iOS, свайп по строке `IonItemSliding`, потягивание для обновления `IonRefresher`, точки остановки у `IonModal`. Своих анимаций не добавляйте без нужды, учитывайте `prefers-reduced-motion`.
## Voice & Content Strategy
- Тон: дружелюбный и короткий, на «вы». Экран телефона маленький: одно действие — одна короткая фраза.
- Заголовки экранов — одно-два слова: «Заказы», «Профиль», «Настройки».
- Кнопки — глагол: «Сохранить», «Оформить заказ», «Войти». На Material подписи кнопок заглавными, это делает Ionic, пишите обычным регистром.
- Вкладки — существительные в одно слово: «Главная», «Каталог», «Корзина», «Профиль».
- Ошибки — что случилось и что делать: «Нет интернета. Проверьте подключение и потяните экран вниз».
- Даты «24 ноября», время «14:30», цены «1 990 ₽».
## Components
- **IonButton:** `fill` solid (главное действие), outline, clear (в шапке и тексте). Размеры small, default, large. `expand="block"` — кнопка во всю ширину внизу формы.
- **IonHeader / IonToolbar / IonTitle:** на iOS большой заголовок (`collapse="condense"`), который сжимается при прокрутке. Кнопка «Назад» — `IonBackButton`.
- **IonTabs / IonTabBar:** вкладки внизу с иконками Ionicons и подписями.
- **IonList / IonItem:** основа экранов настроек и списков; `inset` на iOS даёт сгруппированные блоки. `IonItemSliding` — действия свайпом (удалить, в архив).
- **IonCard:** заголовок, подзаголовок и текст; для ленты и карточек товаров.
- **IonInput / IonTextarea / IonSelect:** подпись `labelPlacement="floating"` или `stacked`, подсказка `helperText`, ошибка `errorText`.
- **IonToggle, IonCheckbox, IonRadio, IonSegment:** переключатели и выбор режима.
- **IonModal:** окно снизу с точками остановки (`breakpoints`), для фильтров и деталей.
- **IonToast, IonAlert, IonActionSheet:** уведомления, подтверждения и меню действий в стиле платформы.
- **IonFab:** плавающая кнопка главного действия на Android-экранах со списком.
## Do's and Don'ts
- Берите готовые компоненты `Ion*`: они сами меняют вид под iPhone и Android.
- Задавайте бренд через `--ion-color-primary` и его shade, tint и contrast, а не стилями отдельных кнопок.
- Проверяйте каждый экран в обеих модах и в тёмной теме.
- Не рисуйте свои вкладки, шапки и модальные окна поверх Ionic: потеряются жесты и безопасные зоны.
- Не используйте светлый primary с белым текстом: проверяйте контраст contrast-цвета.
- Не прячьте основную навигацию в «бургер» на телефоне, если пунктов меньше шести: используйте вкладки.
Только файл: сохраните его как DESIGN.md в корне проекта