Если собираете Mini App через AI, проблема обычно не в том, что «код кривой». Чаще ИИ делает нормальную верстку, но не учитывает поведение внутри WebView: скролл, safe area, клавиатуру, жесты, высоту экрана.
Что проверять в первую очередь:
— контейнер должен тянуться на 100dvh, а не жить в старом 100vh
— нижняя панель не должна перекрывать CTA и форму
— у страницы должен быть нормальный fallback на медленную загрузку
— скролл внутри модалок и листов не должен конфликтовать с основным экраном
— кнопки и инпуты должны быть крупнее обычного desktop UI
Когда даёте задачу Cursor или Claude Code, просите не «сделать интерфейс», а «собрать экран, устойчивый к WebView-ограничениям». Это сильно снижает шанс, что ИИ нарисует красивый, но бесполезный макет.
Хороший минимум для промпта: попросить учесть safe-area-inset, поведение клавиатуры, sticky-кнопку и отсутствие горизонтального скролла.
Если Mini App планируется под лидоген или форму, сначала тестируйте не дизайн, а три вещи: открытие клавиатуры, отправку формы и возврат назад. Именно там AI-сборки чаще всего ломаются.
Правило простое: сначала WebView-совместимость, потом красота. Иначе лендинг выглядит как демо, а не как рабочий экран.
WebView для Telegram Mini App ломают не кнопки, а 5 типовых ошибок в структуре
Этот пост опубликован в Telegram-канале WhatsApp рассылка по базе: сценарии и ограничения (@wabasemail). Все его публикации — на странице канала.
Открыть в Telegram