Saltar para o conteúdo principal

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.

⏰ 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 ou a visão geral de Importação.

​
Importar o projeto

Abra 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. 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. 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, não no código. Peça ao Agent para identificar os valores ausentes sem inventá-los. Se o app tiver um comando de execução ou build personalizado, consulte os docs de configuração de app relevantes para Workflows e Configuração.

​
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.

​
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.

​
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

Adicionar um banco de dados

Salve os dados do app importado de forma persistente.

Adicionar login

Proteja páginas privadas ou dados específicos do usuário.

Adicionar integrações

Reconecte APIs, CRMs, e-mail, analytics ou serviços externos.

Adicionar um domínio personalizado

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