Программирование VK Mini Apps: с чего начать, что изучить и как практиковаться
Программирование VK Mini Apps — умение сделать веб-приложение, которое открывается прямо внутри ВКонтакте: запись в салон из сообщества, витрину магазина, квиз, игру или личный кабинет клуба. Его пишут на HTML, CSS и JavaScript, обычно на React с библиотекой интерфейса VKUI, а с платформой связывают через VK Bridge — так приложение без отдельной регистрации узнаёт, кто его открыл. Чтобы довести проект до пользователей, придётся освоить проверку параметров запуска на своём сервере, размещение на хостинге ВКонтакте, модерацию для каталога и, если нужен доход, рекламу и продажи.
Содержание

Главное, что стоит понять до первой строки кода: мини-приложение — это обычный сайт, который ВКонтакте открывает во встроенном окне и передаёт ему в адресе сведения о пользователе. Поэтому основа навыка — фронтенд, а не какая-то особая технология ВКонтакте. Особенного здесь три вещи: библиотеки платформы, правила безопасности для параметров запуска и путь через модерацию. Ниже они разобраны на примере записи в барбершоп.
Кому и зачем нужно мини-приложение
Владельцу салона, студии или небольшого магазина мини-приложение даёт то, чего не умеет обычная страница сообщества: выбор свободного времени, корзину, личный кабинет с историей записей. Человек не уходит на сторонний сайт и не заводит пароль — он уже вошёл во ВКонтакте. Фронтенд-разработчику навык даёт отдельный тип заказов, а автору игр — канал распространения с рекламой и покупками.
Если записей три в неделю, хватит сообщений, а для коротких диалогов вроде заявки и напоминания часто проще бот. Мини-приложение выигрывает там, где человеку нужен экран с выбором: календарь, каталог с фильтрами, игровое поле.
Из чего собрано мини-приложение
Руководство для начинающих на сайте ВКонтакте для разработчиков предлагает начинать с команды npx @vkontakte/create-vk-mini-app: она создаёт заготовку на React с двумя экранами и навигацией. Пока приложение не опубликовано, его видит только создатель; тестировщиков добавляют в администраторы или в тестовую группу. Локально запущенный проект открывают внутри ВКонтакте через туннель командой npm run tunnel.
Библиотека VK Bridge, по документации, обязательна: при запуске приложение отправляет событие инициализации VKWebAppInit, а дальше через неё просит данные и действия платформы. Например, событие VKWebAppGetUserInfo возвращает имя, фотографию и город пользователя без запроса прав доступа — это и есть «авторизация без логина». VKUI — набор React-компонентов в стиле интерфейса ВКонтакте. Модераторы в советах разработчикам рекомендуют поддерживать тёмную тему и запрашивать разрешения постепенно, когда они действительно понадобились, а не все сразу на первом экране.
Учебный пример: запись в барбершоп из сообщества
Ситуация учебная. Барбершоп устанавливает мини-приложение в своё сообщество. Клиент открывает его кнопкой, видит своё имя, выбирает мастера и свободное время, оставляет телефон. Администратор открывает то же приложение и видит другой экран — журнал записей с телефонами клиентов.
Как приложение отличает администратора от клиента? Среди параметров запуска ВКонтакте передаёт vk_group_id — сообщество, из которого открыто приложение, и vk_viewer_group_role — роль пользователя в нём: admin, editor, moder, member или none. Новичок пишет условие «если роль admin, показать журнал» прямо в браузерном коде и запрашивает записи с сервера, передавая роль. Но параметры — это просто часть адреса. Любой, кто откроет приложение в браузере и заменит none на admin, получит телефоны всех клиентов.
Подпись параметров и свой сервер
Защита от такой подмены описана в разделе о подписи параметров. Вместе с параметрами приходит sign. Чтобы его проверить, параметры с префиксом vk_ сортируют по имени и склеивают через амперсанд, от этой строки вычисляют HMAC-SHA256 с защищённым ключом из настроек приложения и кодируют результат в base64. Если значение не совпало с sign, параметры подменили. Ключ, по документации, знают только авторы приложения.
Отсюда практический вывод. Если проверку написать в браузерном коде, ключ окажется в файлах, которые скачивает каждый пользователь, и защита исчезнет. Значит, проверять подпись нужно на сервере: приложение отправляет ему строку запуска, сервер сверяет подпись и только потом отдаёт журнал записей. При этом хостинг ВКонтакте, по его описанию, предназначен лишь для хранения и раздачи файлов и не выполняет серверный код. Как только приложение хранит записи, заказы или очки игроков, нужен собственный сервер или облачная функция.
С чего начать и в каком порядке осваивать
Последовательность повторяет пример с барбершопом. Без уверенного JavaScript и React библиотеки ВКонтакте покажутся набором непонятных вызовов. Без сервера приложение останется витриной, которой нельзя доверить данные. Модерацию разумно начинать, когда приложение уже работает у тестовой группы, иначе замечания придётся исправлять по второму кругу.
- Подтяните JavaScript: асинхронные запросы, работа с адресной строкой, модули и npm.
- Освойте основы React: компоненты, состояние, переходы между экранами.
- Создайте заготовку через create-vk-mini-app, запустите её через туннель и выведите имя пользователя через VK Bridge.
- Соберите два-три экрана на VKUI и проверьте их в тёмной теме и на телефоне.
- Напишите небольшой сервер на Node.js или другом языке, который проверяет подпись и хранит данные.
- Разместите фронтенд на хостинге ВКонтакте, раздайте доступ тестовой группе и только потом подавайте заявку в каталог.
Если хочется пройти весь путь на одном проекте, посмотрите онлайн-курс Onskills «Программирование VK Mini Apps». В учебном плане двадцать уроков: HTML и CSS, JavaScript, React, серверная часть на PHP и база MySQL, а в финале — прототип мини-приложения. Объём ревью кода, цену, срок доступа и помощь с публикацией нужно уточнить у школы до оплаты.
Хостинг, модерация и каталог
Для хостинга ставят пакет @vkontakte/vk-miniapps-deploy, описывают папку сборки и идентификатор приложения в файле vk-hosting-config.json и выполняют npm run deploy. Размещение бесплатное, но с ограничениями: архив до 300 МБ, без аудио и видео, не больше 24 обновлений в сутки; хостинг хранит до 10 рабочих и до 100 тестовых версий. Подойдёт и свой хостинг с HTTPS.
По правилам публикации в каталоге вся процедура от заявки до публикации длится минимум три дня. Модератор отправляет приложение на бета-тестирование к сообществу тестировщиков, если оно технически сложное, собирает и хранит персональные данные или принимает платежи. Запись в барбершоп с телефонами клиентов подпадает под второе условие. Тестирование стартует по понедельникам и четвергам в 18:00 по Москве и длится не меньше трёх дней. До публикации нужно исправить все отчёты со статусами «Уязвимость», «Критический» и «Высокий», а для тестировщиков подготовить тестовые данные, тестовый режим платежей и инструкцию. Если заявку из пятницы отправят на тестирование, оно начнётся не раньше вечера понедельника, а подменённая роль администратора из нашего примера — как раз кандидат в «Уязвимость».
Каталог стоит усилий: автоматические и массовые уведомления, по советам модераторов, доступны только приложениям из каталога, а без напоминаний запись в барбершоп заметно теряет в пользе. Убрать из каталога могут приложение, отключённое больше 30 дней или зависающее.
Упражнения и частые ошибки
Первое упражнение — приложение-визитка: имя пользователя через VK Bridge, два экрана на VKUI, кнопка назад, тёмная тема. Второе — тот же барбершоп с сервером: проверьте подпись, а затем вручную поменяйте роль в адресе и убедитесь, что сервер отказал. Третье — дайте двум знакомым пройти запись с телефона без подсказок.
Типичные ошибки: параметрам запуска верят без проверки, защищённый ключ попадает в публичный репозиторий, все разрешения запрашивают на первом экране. Тестовые записи и тестовые платежи остаются в рабочей версии — правила модерации прямо требуют удалить их перед публикацией.
Если серверной части не хватает, её удобно осваивать вместе с фронтендом. На курсе Purple School «Fullstack-разработчик: React и Node.js» путь идёт от вёрстки и TypeScript к API на Express с базой данных и авторизацией, затем к Nest.js, React и развёртыванию; в портфолио 11 проектов. Программа рассчитана на 16 месяцев, наставник и ревью кода есть только в старшем тарифе.
Как навык влияет на доход
Для фронтенд-разработчика мини-приложения — специализация внутри профессии, а не отдельная зарплатная строка. Ориентир по профессии в целом даёт калькулятор «Хабр Карьеры», где специалисты сами указывают свою зарплату: у фронтенд-разработчиков уровня Middle по России он показывает 187 500 ₽ по 1 320 анкетам (данные открыты в октябре 2026 года). Это фактические зарплаты, а не вакансии, и надбавку за мини-приложения они не показывают.
У собственного приложения доход устроен иначе. По описанию монетизации ВКонтакте платит разработчику за показы рекламы, а товары можно продавать: виртуальные ценности — за голоса, физические и цифровые — за деньги, причём совместить оба способа в одном приложении нельзя. Деньги за рекламу доступны к выводу с задержкой в 10 дней, а за приём платежей ВКонтакте берёт комиссию. Важная деталь для начинающих: вывод средств через кабинет выплат доступен ИП, самозанятым и юридическим лицам, а для физических лиц он закрыт с 1 апреля 2025 года. Владельцу бизнеса важнее другое: сколько записей пришло через приложение.
Как выбрать обучение
Если JavaScript вы уже знаете и не хватает именно React, на котором построены заготовка и VKUI, подойдёт онлайн-курс Нетологии «React: фреймворк фронтенд-разработки». За два с половиной месяца на нём проходят JSX, компоненты, роутинг, хуки и Redux Toolkit; заявлены 13 часов теории, 76 часов практики, 37 заданий и дипломный фронтенд магазина с корзиной. TypeScript отдельным модулем не заявлен, а уверенный JavaScript нужен уже на входе.
Правилам ВКонтакте общие программы по фронтенду не учат, документацию платформы придётся читать самим. При выборе курса проверьте, будет ли серверная часть с авторизацией, проект, который можно перенести в мини-приложение, и ревью кода живым человеком.
Чтобы сравнить школы, загляните в рейтинг онлайн-школ по фронтенд-разработке. Это рейтинг по фронтенду в целом, отдельного по мини-приложениям на сайте нет, но именно эта база нужна для VK Mini Apps.
С какими профессиями связан навык
О соседних темах у нас есть отдельные статьи. React и профессия JavaScript-разработчика дают базу для мини-приложений. Разработчик мобильных приложений пишет программы для магазинов приложений, а мини-приложение живёт внутри ВКонтакте и не требует установки. Создание Telegram-ботов решает похожие задачи записи и заявок в другом мессенджере.