Миграция веб‑приложения во VK Mini App: инженерный взгляд

Мы делаем VK Mini Apps под ключ, включая перенос существующих веб‑продуктов. И за последние пару лет успели собрать определённую статистику и опыт.

Что ломается при прямом переносе

1. URL‑маршруты — внутри iframe адрес не меняется. Нужен client‑side router (например, MemoryRouter).
2. Cookies и авторизация — браузерные куки не работают. Используется sign-подпись и VK ID.
3. Запросы к API — если API завязано на cookie, его надо переделывать под токены или подписи.
4. Переходы по внешним ссылкам — только через VKWebAppOpenURL.

Особенности мини‑приложений

1. Ограничение на вес бандла (до 10 МБ);
2. Открытие внутри WebView VK App (с ограничениями);
3. Поддержка только клиентской маршрутизации;
4. Работа с VK Bridge — все действия идут через него.

Что мы делаем на практике

Фронт:

1. Переносим на VKUI + Vite;
2. Убираем сторонние heavy‑зависимости (moment.js, lodash);
3. Адаптируем под мобильный UX.

Бэк:

1. Переходим на авторизацию через sign + user_id;
2. Добавляем валидацию подписи на сервере;
3. Настраиваем CORS, secure-заголовки, лимитируем API rate.

Инфраструктура:

1. Хостим в VK Cloud, Timeweb или Selectel;
2. Настраиваем CI/CD через GitLab Runner;
3. Метрики — Яндекс.Метрика + VK Analytics.

Результаты

После миграции веб‑приложений в формат VK Mini Apps мы получали:

1. Увеличение Retention x2—x3 за счёт push и встроенной авторизации;
2. Бесплатный трафик из каталога VK;
3. Рост конверсий на 15–30% (за счёт снижения фрикции входа);
4. Новую аудиторию из VK, которая не заходила на сайт.

Заключение

Миграция — это не «обернуть сайт в iframe». Это полноценная работа по адаптации архитектуры, авторизации, UX и фронта. Но результат стоит того: новая платформа, новый канал, больше пользователей.

Если вы хотите перенести ваш сервис в VK Mini App, делайте это правильно. Мы поможем.

VK Mini App — это не веб‑версия внутри VK. Это новая жизнь продукта.