Импортируйте приложение из GitHub, архива .zip или Lovable

КраткоНа странице «Проекты» откройте «Импорт» и выберите GitHub, «Файл .zip» или Lovable. MonstarX за несколько секунд проверит код и скажет, запустится ли он как есть. Нажмите «Импортировать и запустить» — приложение откроется в предпросмотре, а чат, режим редактирования, версии и QA будут работать с вашим собственным кодом. Приложения, которые MonstarX запустить не может (мобильные, Django, Rails…), можно изучить и создать заново.

У вас уже есть приложение — написанное разработчиком, экспортированное из другого ИИ-конструктора или лежащее в репозитории на GitHub? Импортируйте его. MonstarX сначала проверит код и за несколько секунд скажет, может ли его запустить. Затем приложение заработает в предпросмотре в точности как есть, и вы сможете дорабатывать его в чате — так же, как приложение, созданное MonstarX.

Как импортировать приложение?

Откройте Импорт в поле запроса на странице Проекты и выберите, где лежит код.

Открытое меню «Импорт» под полем запроса: «GitHub», «Lovable», «Файл .zip», «Figma», «Веб-сайт», «Электронная таблица» и «Ваш агент»

Выберите Импорт → GitHub.
Вставьте адрес репозитория (например, github.com/acme/shop или просто acme/shop) и нажмите Проверить. Если ваш аккаунт GitHub подключён, появится список ваших репозиториев, включая закрытые.
Прочитайте вердикт. Если приложение лежит в другой ветке или папке, выберите её — и код проверится заново.
Нажмите Импортировать и запустить.

Любой общедоступный репозиторий импортируется по адресу. Для закрытого сначала подключите GitHub через меню GitHub в любом проекте. Подробнее — в статье GitHub.

Окно «Импортировать существующий код» с проверенным репозиторием shadcn-ui/taxonomy: «Работает как есть · публикуется на вашем хостинге», 165 файлов · 347 КБ кода, создано с помощью Next.js 13, React 18, TypeScript, Tailwind, shadcn/ui, Prisma, NextAuth и Stripe; ключи, указанные в коде; ветка main; «Лицензия: MIT»; кнопки «Вместо этого воссоздать приложение на MonstarX» и «Импортировать и запустить»

Выберите Импорт → Файл .zip.
Перетащите архив .zip с папкой проекта или выберите его. Сначала он проверяется на вашем компьютере — ничего не загружается, пока вы не нажмёте импорт.
Прочитайте вердикт и нажмите Импортировать и запустить. Сначала код создаёт проект, затем по одному загружаются изображения («Загрузка изображений… 3 из 9»).

Архив распаковывается в браузере, поэтому node_modules, папки сборки и любой файл .env никогда не покидают ваш компьютер. Архив может весить до 500 МБ. Загружайте папку проекта как есть: зависимости и папки сборки пропускаются автоматически, а читаются и импортируются только файлы самого приложения.

Проверенный архив corner-bakery.zip: «Работает как есть» — 7 файлов · 1 КБ кода, Vite и React 19. Предпросмотр, чат, режим редактирования, версии и QA работают с вашим кодом как есть. Для приложения устанавливаются его собственные пакеты из package.json. После импорта будет запрошен 1 ключ (VITE_SHOP_NAME).

Что означают вердикты?

Значок	Заголовок	Что это значит
Работает как есть	«Работает на MonstarX как есть»	Приложение на Vite (или экспорт из MonstarX, который возвращается домой). Оно запускается, редактируется и публикуется на MonstarX.
Работает как есть · публикуется на вашем хостинге	«Работает на MonstarX, публикуется на вашем хостинге»	Приложение с собственным сервером — Next.js, Remix, Astro, Nuxt, SvelteKit, Create React App. Оно запускается и редактируется здесь, а публикуется через Опубликовать → Vercel — или остаётся у текущего хостинга, если сохранять изменения в GitHub.
Здесь не запускается	«MonstarX не может запустить это приложение, но может создать его заново»	Мобильное приложение или приложение для компьютера, сайт на чистом HTML или сайт на Django, Rails, Laravel, Go и т. п. MonstarX может изучить его и воссоздать как веб-приложение.
Пока невозможно импортировать	например, «Библиотека, а не приложение» или «Слишком большой объём для импорта»	То, что MonstarX не может ни запустить, ни воссоздать. В пояснении сказано почему и что может изменить ответ (часто — импортировать папку, в которой лежит приложение).

В каждом вердикте указано, на чём написано приложение, его размер и ключи (настройки вроде VITE_MAPBOX_TOKEN), перечисленные в его примере файла окружения, — но никогда не их значения. Предупреждения, которые не мешают импорту, выделены жёлтым: закоммиченный файл .env (он не копируется — его ключи должны храниться в разделе Облачные сервисы → Секреты), сервисы, запускаемые через Docker Compose, собственный сервер API, файлы в Git LFS или файлы больше 10 МБ, которые пропускаются.

Что происходит после импорта?

Открывается рабочее пространство с карточкой о том, что было импортировано, и приложение запускается в предпросмотре (при первом запуске устанавливаются пакеты, это занимает минуту-другую).

Импортированное приложение пекарни, запущенное в предпросмотре; в чате карточка «Импортировано corner-bakery.zip»: 7 файлов кода, Vite и React 19 и блок «Ключи приложения»

В блоке Ключи приложения перечислены все настройки, которые читает код, — по тому, насколько они действительно нужны: Обязательно (часть приложения, которая читает ключ, без него не работает), Необязательно (в коде есть запасной вариант) и Не используется. Вставьте значение и нажмите Добавить — или Использовать «…», если значение есть в собственном файле-примере проекта, — и предпросмотр перезапустится с ним. Значения хранятся в зашифрованном виде в разделе Облачные сервисы → Секреты.

Карточка «Импортировано corner-bakery.zip»: блок «Ключи приложения» — VITE_SHOP_NAME, «Необязательно», «В коде есть запасной вариант, поэтому приложение работает без него» — с полем «Вставьте значение» и кнопкой «Добавить», а ниже «Не знаете значения? Спросите у сервиса, в котором создали проект»

Понятия не имеете, какие нужны значения? Нажмите Не знаете значения? Спросите у сервиса, в котором создали проект — появится сообщение, которое нужно вставить в инструмент, где создавался проект (для проекта Lovable — в чат Lovable). В нём содержится просьба перечислить все ключи и подсказать, где их взять, — не меняя код.

Если MonstarX заметит ключ, записанный прямо в коде, карточка укажет его тип и файл (но не значение), а секретные ключи — например, секретный ключ Stripe или ключ OpenAI — выведет наверх как предупреждение.

Что работает после импорта?

Предпросмотр, чат, режим редактирования, версии и QA работают с вашим кодом как есть. MonstarX работает в собственном коде приложения, следует его подходам и добавляет пакеты, которые понадобятся.
Публикация — приложение на Vite публикуется на MonstarX, как любое другое. Приложение с собственным сервером публикует ваш хостинг: через Опубликовать → Vercel или через сохранение в GitHub, откуда его заберёт хостинг. Подробнее — в статье Публикация на других хостингах.
Экспорт отдаёт репозиторий как есть, вместе с изображениями.
Собственные база данных и аккаунты MonstarX не добавляются. Импортированное приложение продолжает использовать то, что использует его код (Supabase, Firebase, собственный API), и раздел Облачные сервисы → База данных об этом сообщает. Нужные ему ключи добавляются в разделе Облачные сервисы → Секреты.

Что такое ветка monstarx?

Если вы импортируете из GitHub через свой подключённый аккаунт и можете отправлять изменения в репозиторий, проект остаётся связан с ним. MonstarX создаёт ветку monstarx от импортированного коммита и сохраняет изменения туда — ваша основная ветка никогда не сдвигается. Когда захотите перенести изменения в основную ветку, откройте пул-реквест из monstarx; в меню GitHub проекта есть ссылка на страницу сравнения на GitHub. Изменения, отправленные в эту ветку на GitHub, тоже возвращаются в MonstarX. Подробнее — в статье GitHub.

Что, если MonstarX не может запустить приложение?

Для мобильного приложения (Expo, React Native, Flutter, Swift, Android), приложения для компьютера или сайта на Django, Rails, Laravel или Go вердикт предложит кнопку Прочитать код и спланировать воссоздание.

Проверенный архив corner-bakery-phone.zip: «Здесь не запускается» — Expo, React 19. «MonstarX не может запустить это приложение, но может создать его заново». Это мобильное приложение на Expo… MonstarX может изучить код и создать его заново как веб-приложение, которое работает на телефонах, сохранив экраны, модель данных и правила из кода. Кнопка «Прочитать код и спланировать воссоздание»

MonstarX создаст новый проект, сохранит рядом исходный код (только для чтения), изучит его и предложит План воссоздания: экраны, данные, правила из кода, используемые сервисы и судьбу каждого из них (Сохранено, Заменено или Исключено), что не переносится и какая логика переносится без изменений. Скажите, что не так, и план будет исправлен; чтобы начать, нажмите Создать. Любую деталь исходника всегда можно найти поиском. Приложения, которые здесь запускаются, предлагают кнопку Вместо этого воссоздать приложение на MonstarX — на случай, если вам нужны собственные база данных, аккаунты и публикация MonstarX.

Насколько большим может быть импортируемое приложение?

Ограничение	Значение
Код	до 3000 файлов и 12 МБ, до 400 КБ на файл
Изображения и другие файлы	до 500 МБ при импорте ZIP (100 МБ из GitHub), до 10 МБ на файл
Архив .zip	до 500 МБ до исключения зависимостей и результатов сборки
Воссоздание	до 1500 файлов и 5 МБ кода

Если лимит превышен, вердикт назовёт число, лимит и выход — обычно это импорт только той папки, где лежит приложение.

Вопросы и ответы

Меняет ли импорт мой репозиторий на GitHub?

Основную ветку — нет. Если у вас есть право отправлять изменения, они попадают в ветку monstarx; если нет, репозиторий только читается.

Можно ли импортировать монорепозиторий?

Да. MonstarX найдёт папку, в которой лежит приложение, и позволит выбрать другую папку прямо в вердикте.

Можно ли импортировать приложение, экспортированное из MonstarX?

Да — оно вернётся полноценным проектом MonstarX (с новой пустой базой данных; данные старого приложения останутся на месте).

Безопасно ли запускать импортированный код?

Он работает на собственном изолированном облачном компьютере, а его пакеты устанавливаются с отключёнными install-скриптами.

Можно ли импортировать чужой код?

Только код, которым вы вправе пользоваться. Вердикт показывает лицензию репозитория или сообщает, что она не указана.