Обзор

Преимущества

• Адаптивность — библиотека подстраивается под размер экрана: удобно на смартфонах, планшетах и компьютерах.

• Мультиплатформенность — VKUI «мимикрирует» под iOS и Android, сохраняя стиль vk.com ↗ и m.vk.com ↗. Интерфейсы выглядят естественно в любом окружении.

• Цветовые схемы — есть светлая и тёмная темы, что важно для доступности.

Поддерживаемые браузеры

Каждый год мы повышаем минимальные версии браузеров на основе статистики ВКонтакте. Текущие версии:

Chrome >= 84
Safari >= 15
Firefox >= 115
Edge >= 109
Opera >= 90
Android >= 84
iOS >= 15
ChromeAndroid >= 84
FirefoxAndroid >= 115
Samsung >= 14

Используемые полифилы

Компоненты используют или могут использовать следующие полифилы:

• CSS logical properties and values ↗ — в CSS-бандле @vkontakte/vkui/dist/vkui.css при базовой установке трансформируются в обычные свойства; при установке ESNext-версии решение о полифиле вы принимаете сами.

Релизный цикл

Версионирование — по semver ↗. Сроки выпуска:

• Патчи (x.y.Z) — по мере исправлений;
• Миноры (x.Y.z) — один-два раза в месяц;
• Мажоры (X.y.z) с обратно несовместимыми изменениями — раз в год.

Начни сейчас

Для быстрого старта возьмите один из шаблонов ниже. Инструкции — в README.md шаблона. Если предпочитаете пройти установку вручную, см. раздел Установка.

Дизайн

На странице VK в Figma Community ↗ доступны две библиотеки:

• VKUI Common Library [Beta] — основная библиотека компонентов для Android, также используется для десктопа;
• VKUI iOS Library — компоненты для iOS с шаблонами готовых экранов;

Это открытые дизайн-библиотеки — используйте их для своих интерфейсов.

Лицензия

VKUI распространяется под лицензией MIT ↗. Используйте в любых проектах, включая коммерческие, с указанием авторства.