> ## Documentation Index > Fetch the complete documentation index at: https://docs.replit.com/llms.txt > Use this file to discover all available pages before exploring further. # Importar e publicar um projeto existente > Traga código existente para o Replit, faça-o funcionar no Preview, adicione a configuração necessária, publique e verifique a URL pública. export const AiPrompt = ({children}) => { return
{children}
; }; ⏰ *Tempo estimado: 10 minutos* Use este guia quando você já tem código, um projeto de outra ferramenta ou um arquivo ZIP e quer continuar desenvolvendo no Replit. Importar é o primeiro passo. O objetivo real é fazer o projeto funcionar, entender o que precisa de configuração, publicá-lo e verificar se a versão pública funciona. ## O que você vai conquistar Ao final deste guia, você terá: * Um projeto existente importado no Replit. * O resumo do Agent sobre o framework, dependências, comandos e configuração ausente. * Um Preview funcionando. * Qualquer Secret ou variável de ambiente necessária adicionada no lugar certo. * Uma URL publicada que você testou como um visitante de primeira vez. ## O que você vai aprender Você aprenderá como: * Pedir ao Agent para inspecionar um projeto importado antes de alterar o comportamento. * Identificar comandos de execução, comandos de build, dependências, portas e Secrets. * Corrigir problemas de configuração na menor ordem possível. * Testar o app no Preview antes de publicar. * Verificar o app publicado após a implantação. ## Para quem é este guia Use este guia se você está importando: * Um repositório do GitHub. * Um projeto do Figma, Bolt, Lovable, Base44, Vercel ou um arquivo ZIP. * Código que outra pessoa começou. * Um projeto mais antigo que você quer continuar com o Agent. Para etapas de importação específicas por fonte, consulte [Importar do GitHub](/build/import-from-github) ou a visão geral de [Importação](/pt/references/workspace/import). ## Importar o projeto Abra [replit.com/import](https://replit.com/import), escolha a fonte e siga o fluxo de importação. Depois que o projeto abrir no Replit, resista ao impulso de pedir novos recursos imediatamente. Primeiro, peça ao Agent para inspecionar o que você importou. Inspecione este projeto importado e me ajude a entender como executá-lo no Replit.
Identifique o framework, dependências, comando de execução, comando de build, variáveis de ambiente necessárias, portas e prováveis problemas de configuração.
Não altere o comportamento do app ainda.
Me dê o menor checklist para fazer o Preview funcionar. Projetos importados frequentemente precisam de configuração porque valores locais, credenciais privadas e configurações de implantação nem sempre são transferidos do ambiente original. ## Fazer o Preview funcionar O Preview deve funcionar antes de você publicar. Se o app não iniciar, peça ao Agent para corrigir os problemas de configuração em ordem, em vez de reescrever o app. Me ajude a iniciar este app importado no Preview.
Verifique a instalação de dependências, comando de execução, comando de build, portas, vinculação de host e Secrets ausentes.
Corrija o menor problema primeiro e explique como posso testar o resultado. Verifique: * As dependências são instaladas com sucesso. * O comando de execução inicia o app. * O app escuta na porta esperada. * O Preview abre sem uma página em branco ou tela de erro. * O fluxo principal do app funciona. Se o Agent sugerir alterar o comportamento antes que o app execute, peça que ele pause e foque apenas na configuração. ## Adicionar Secrets e configurações ausentes Valores de Secret não são importados do GitHub ou da maioria das fontes externas. Adicione chaves de API, tokens, URLs de banco de dados e credenciais de provedores por meio de [Secrets](/pt/core-concepts/project-editor/app-setup/secrets), não no código. Peça ao Agent para identificar os valores ausentes sem inventá-los. Liste as variáveis de ambiente e Secrets que este app espera.
Para cada uma, explique para que é usada, se é necessária para o Preview e onde devo obter o valor.
Não crie secrets de placeholder no código. Se o app tiver um comando de execução ou build personalizado, consulte os docs de configuração de app relevantes para [Workflows](/pt/references/workspace/workflows) e [Configuração](/pt/references/configuration/configuration). ## Testar antes de publicar Abra o Preview e teste o app importado como um visitante de primeira vez. Verifique: * A página inicial carrega. * A navegação principal funciona. * Formulários, botões, login, checkout, uploads ou chamadas de API funcionam se o app os usa. * Atualizar a página não quebra o app. * Reiniciar o app ainda funciona. * Os logs não mostram erros ocultos. Se algo falhar, descreva o sintoma para o Agent. O Preview carrega, mas enviar o formulário de reserva falha com este erro: \[cole o erro].
Encontre o menor problema de configuração ou código que o causa.
Explique a correção e me diga como verificar que o formulário funciona depois. ## Publicar e verificar Publique somente depois que o Preview funcionar. Adicione Secrets de produção e variáveis de ambiente no painel de Publicação se o app precisar deles. Os valores usados no Preview podem não existir automaticamente para o app publicado. Após a publicação: * Abra a URL pública em uma nova aba. * Execute o mesmo fluxo principal que você testou no Preview. * Verifique recursos exclusivos de produção como callbacks de login, chamadas de API, redirecionamentos de pagamento e acesso ao banco de dados. * Confirme que o app ainda funciona no mobile se os visitantes usarão telefones. Se a publicação falhar, use [Solucionar problemas de publicação](/build/troubleshooting). ## Você terminou quando * O projeto é importado com sucesso. * O Agent identificou o framework, comandos, portas, dependências e Secrets necessários. * O Preview inicia e o fluxo principal funciona. * Os Secrets necessários estão armazenados fora do código. * O app é publicado com sucesso. * A URL pública funciona quando testada a partir de uma aba nova. ## Melhorias a seguir Salve os dados do app importado de forma persistente. Proteja páginas privadas ou dados específicos do usuário. Reconecte APIs, CRMs, e-mail, analytics ou serviços externos. Dê ao app publicado uma URL com sua marca. ## Precisa de mais ajuda? * **A importação funciona mas o app não executa:** verifique dependências, comandos de execução, portas e variáveis de ambiente ausentes. * **O Preview funciona mas a publicação falha:** verifique Secrets de produção, acesso ao banco de dados, vinculação de host e configuração de porta. * **Arquivos enviados desaparecem após a publicação:** use um banco de dados ou serviço de armazenamento para dados persistentes. * **O Agent quer reescrever o app:** peça que ele foque na configuração primeiro e preserve o comportamento existente. ## Relacionado * [Importação](/pt/references/workspace/import) * [Secrets](/pt/core-concepts/project-editor/app-setup/secrets) * [Workflows](/pt/references/workspace/workflows) * [Solucionar problemas de publicação](/build/troubleshooting)