Importe um app existente do GitHub, de um .zip ou do Lovable

Já tem um app — feito por um desenvolvedor, exportado de outra ferramenta de criação com IA ou guardado em um repositório do GitHub? Importe. O MonstarX verifica o código primeiro e diz em poucos segundos se consegue executá-lo. Depois, o app roda na prévia exatamente como está, e você continua melhorando pelo chat, como em um app criado pelo MonstarX.

Como importo um app?

Abra Importar na caixa de texto de Projetos e escolha onde o código está.

GitHub

1. Escolha Importar → GitHub.

2. Cole o endereço de um repositório (como github.com/acme/shop ou só acme/shop) e clique em Verificar. Se sua conta do GitHub estiver conectada, seus repositórios aparecem em uma lista para você escolher, inclusive os privados.

3. Leia o resultado. Escolha outra branch, ou outra pasta se o app estiver dentro de uma, e a verificação é feita de novo.

4. Clique em Importar e executar.

Qualquer repositório público funciona com o endereço. Para um privado, conecte o GitHub antes pelo menu GitHub de um projeto. Veja GitHub.

Um .zip

1. Escolha Importar → Um .zip.

2. Solte um .zip da pasta do seu projeto ou escolha um. Ele é verificado primeiro no seu computador — nada é enviado até você importar.

3. Leia o resultado e clique em Importar e executar. O código cria o projeto, e as imagens vêm depois, uma de cada vez (Enviando imagens… 3 de 9).

O .zip é descompactado no seu navegador, então node_modules, pastas de build e qualquer arquivo .env nunca saem do seu computador. Um .zip pode ter até 500 MB. Envie a pasta do projeto do jeito que ela está — dependências e pastas de build são ignoradas automaticamente, e só os arquivos do app são lidos e importados.

Lovable

1. Escolha Importar → Lovable.

2. Cole uma chave de API do espaço de trabalho do Lovable e clique em Exibir projetos (as chaves de API exigem um espaço de trabalho Business ou Enterprise do Lovable). O MonstarX usa a chave apenas para carregar a lista e não a salva.

3. Escolha seu projeto. O Lovable não entrega o código pela API, então o MonstarX pede o repositório do GitHub com que o seu projeto do Lovable está sincronizado: no Lovable, abra as configurações do projeto → Git → GitHub, conecte se necessário e cole o endereço do repositório.

4. Clique em Verificar código e depois em Importar e executar.

Não tem chave de API? Escolha Não tem uma chave de API? Use seu repositório GitHub sincronizado e cole o endereço do repositório diretamente.

O que significa cada resultado?

Selo	Título	O que significa
Funciona como está	Roda no MonstarX como está	Um app Vite (ou uma exportação do MonstarX voltando para casa). Ele roda, é editado e é publicado no MonstarX.
Funciona como está · seu host publica	Roda no MonstarX, publicado pelo seu host	Um app com servidor próprio — Next.js, Remix, Astro, Nuxt, SvelteKit, Create React App. Ele roda e é editado aqui; você publica em Publicar → Vercel ou mantém seu host atual salvando as alterações no GitHub.
Não funciona aqui	O MonstarX não consegue executar isso — mas pode recriá-lo	Um app de celular ou de desktop, um site em HTML simples ou um site feito com Django, Rails, Laravel, Go e similares. O MonstarX pode estudá-lo e recriá-lo como app web.
Ainda não pode ser importado	por exemplo, Uma biblioteca, não um app ou Grande demais para importar	Algo que o MonstarX não consegue executar nem recriar — a frase explica o motivo e o que mudaria a resposta (muitas vezes: importar a pasta que contém o app).

Todo resultado lista com o que o app foi feito, o tamanho e as chaves (configurações como VITE_MAPBOX_TOKEN) que o arquivo de ambiente de exemplo dele define — nunca os valores. Avisos que não impedem a importação aparecem em âmbar: um arquivo .env enviado ao repositório (não é copiado — as chaves dele vão em Backend → Segredos), serviços iniciados com Docker Compose, um servidor de API próprio, arquivos no Git LFS ou arquivos com mais de 10 MB, que ficam de fora.

O que acontece depois que eu importo?

O espaço de trabalho se abre com um cartão sobre o que foi importado, e o app começa a rodar na prévia (na primeira vez, ele instala os pacotes, o que leva um ou dois minutos).

monstarx.com

Suas chaves lista cada configuração que o código lê, organizada pelo que ele realmente precisa: Necessário (a parte do app que a lê não funciona sem ela), Opcional (o código tem um valor alternativo) e Não usado. Cole um valor e clique em Adicionar — ou em Usar “…” quando o próprio arquivo de exemplo do projeto traz um — e a prévia reinicia com ele. Os valores ficam guardados com criptografia em Backend → Segredos.

Não faz ideia de quais são os valores? Clique em Não sabe os valores? Pergunte onde o projeto foi criado para receber uma mensagem que você cola na ferramenta de onde o projeto veio (no caso de um projeto do Lovable, o chat do Lovable), pedindo que ela liste cada chave e onde copiá-la — sem alterar nenhum código.

Se o MonstarX encontrar uma chave escrita direto no código, o cartão mostra o tipo e o arquivo dela (nunca o valor) e coloca as secretas — uma chave secreta do Stripe, uma chave da OpenAI — no topo, como aviso.

O que funciona depois da importação?

• Prévia, chat, Modo de edição, versões e QA funcionam no seu código do jeito que está. O agente do MonstarX trabalha com o código e os padrões do próprio app e adiciona qualquer pacote de que ele precise.
• Publicação — um app Vite é publicado no MonstarX como qualquer outro. Um app com servidor próprio é publicado pelo seu host: em Publicar → Vercel ou salvando no GitHub, de onde o seu host pega as alterações. Veja Outras hospedagens.
• Exportar entrega o repositório do jeito que está, com as imagens.
• O banco de dados e as contas do próprio MonstarX não são adicionados. Um app importado continua usando o que o código dele já usa (Supabase, Firebase, uma API própria), e Backend → Banco de dados avisa isso. As chaves de que ele precisa vão em Backend → Segredos.

O que é a branch monstarx?

Quando você importa do GitHub com a sua própria conta conectada e tem permissão para enviar alterações ao repositório, o projeto continua vinculado a ele. O MonstarX cria uma branch chamada monstarx a partir do commit que você importou e salva as alterações ali — sua branch padrão nunca é alterada. Abra um pull request a partir de monstarx quando quiser levar as alterações para a sua branch principal; o menu GitHub do projeto tem um link para a página de comparação do GitHub. Edições enviadas para essa branch no GitHub também voltam para o MonstarX. Veja GitHub.

E se o MonstarX não conseguir executar meu app?

Para um app de celular (Expo, React Native, Flutter, Swift, Android), um app de desktop ou um site em Django, Rails, Laravel ou Go, o resultado oferece Ler meu código e planejar a recriação.

O MonstarX cria um projeto novo, guarda o código original ao lado (somente leitura), estuda esse código e propõe um Plano de recriação: as telas, os dados, as regras do código, os serviços que ele usa e o que acontece com cada um (Mantido, Substituído ou Descartado), o que não vem junto e a lógica mantida como está. Diga o que está errado e o plano é revisado; clique em Criar para criar. O original continua a uma busca de distância para qualquer detalhe. Apps que rodam aqui oferecem Recriar no MonstarX, para quando você quiser o banco de dados, as contas e a publicação do próprio MonstarX.

Qual pode ser o tamanho de um app importado?

Limite	Valor
Código	até 3.000 arquivos e 12 MB, 400 KB por arquivo
Imagens e outros arquivos	até 500 MB em importações por ZIP (100 MB pelo GitHub), 10 MB por arquivo
Um .zip	até 500 MB antes de excluir dependências e arquivos de build
Uma recriação	até 1.500 arquivos e 5 MB de código

Acima de um limite, o resultado mostra o número, o limite e a saída — normalmente, importar só a pasta que contém o app.

Perguntas frequentes

Importar altera meu repositório do GitHub?

A sua branch padrão, não. Com permissão de envio, as alterações vão para uma branch monstarx; sem ela, o repositório é apenas lido.

Posso importar um monorepo?

Pode. O MonstarX encontra a pasta que contém o app e deixa você escolher outra pasta no resultado.

Posso importar um app exportado do MonstarX?

Pode — ele volta como um projeto MonstarX completo (com um banco de dados novo e vazio; os dados do app antigo ficam onde estão).

É seguro executar código importado?

Ele roda em um computador próprio e seguro na nuvem, e os pacotes são instalados com os scripts de instalação desativados.

Posso importar código escrito por outra pessoa?

Só código que você tem o direito de usar. O resultado mostra a licença do repositório ou avisa que nenhuma foi informada.

Veja também

Seu agente de códigoEnvie um app do Claude Code, Codex ou Cursor.

Clonar um siteRecrie as páginas de um site público.

GitHubConecte o GitHub e sincronize alterações.

Outras hospedagensPublique na Vercel e em outros lugares.