Миграция веб‑приложения во VK Mini App: инженерный взгляд
Когда заказчик приходит с вопросом «а давайте мы просто обернём сайт в iframe и зальём как VK Mini App», приходится объяснять: так не получится. Мини‑приложение ВКонтакте — это не просто веб‑обёртка. Это отдельный формат со своей логикой, архитектурой и ограничениями.
Мнение автора может не совпадать с мнением редакции
Мы делаем VK Mini Apps под ключ, включая перенос существующих веб‑продуктов. И за последние пару лет успели собрать определённую статистику и опыт.
Что ломается при прямом переносе
- URL‑маршруты — внутри iframe адрес не меняется. Нужен client‑side router (например, MemoryRouter).
- Cookies и авторизация — браузерные куки не работают. Используется sign-подпись и VK ID.
- Запросы к API — если API завязано на cookie, его надо переделывать под токены или подписи.
- Переходы по внешним ссылкам — только через VKWebAppOpenURL.
Особенности мини‑приложений
- Ограничение на вес бандла (до 10 МБ);
- Открытие внутри WebView VK App (с ограничениями);
- Поддержка только клиентской маршрутизации;
- Работа с VK Bridge — все действия идут через него.
Что мы делаем на практике
Фронт:
- Переносим на VKUI + Vite;
- Убираем сторонние heavy‑зависимости (moment.js, lodash);
- Адаптируем под мобильный UX.
Бэк:
- Переходим на авторизацию через sign + user_id;
- Добавляем валидацию подписи на сервере;
- Настраиваем CORS, secure-заголовки, лимитируем API rate.
Инфраструктура:
- Хостим в VK Cloud, Timeweb или Selectel;
- Настраиваем CI/CD через GitLab Runner;
- Метрики — Яндекс.Метрика + VK Analytics.
Результаты
После миграции веб‑приложений в формат VK Mini Apps мы получали:
- Увеличение Retention x2—x3 за счёт push и встроенной авторизации;
- Бесплатный трафик из каталога VK;
- Рост конверсий на 15–30% (за счёт снижения фрикции входа);
- Новую аудиторию из VK, которая не заходила на сайт.
Заключение
Миграция — это не «обернуть сайт в iframe». Это полноценная работа по адаптации архитектуры, авторизации, UX и фронта. Но результат стоит того: новая платформа, новый канал, больше пользователей.
Если вы хотите перенести ваш сервис в VK Mini App, делайте это правильно. Мы поможем.
VK Mini App — это не веб‑версия внутри VK. Это новая жизнь продукта.
0