A mensagem Your preview will appear here significa que o processo de pré-visualização ainda não produziu uma aplicação funcional. É um sintoma, não a causa raiz. A dica útil é geralmente a primeira linha vermelha no terminal ou no console do navegador.

Resposta em 30 segundos

  1. Verifique se a plataforma tem um incidente ativo.
  2. Abra o terminal do projeto e copie o primeiro erro de build ou de tempo de execução.
  3. Execute npm run build para expor erros que a pré-visualização pode ocultar.
  4. Se a aplicação usa um banco de dados ou API, confirme que os segredos necessários existem neste projeto.
  5. Forneça ao agente o erro exato e peça que ele altere apenas o arquivo ou configuração mencionado no erro.

Não pressione um botão genérico de correção sem ler o resultado novo. Se uma tentativa cria um erro diferente, restaure a versão anterior que funcionava antes de tentar outra alteração.

Ramo 1 — A plataforma está indisponível?

Abra primeiro a página de status oficial. Se vários projetos pararam de carregar ao mesmo tempo, ou a página de status relata um incidente de pré-visualização ou build, aguarde o provedor recuperar. Alterar seu código durante um incidente adiciona ruído e pode criar um segundo problema.

Se apenas um projeto falhou, continue com as verificações do projeto abaixo.

Ramo 2 — Encontre o primeiro erro do terminal

No Bolt, mude para a visão Código e abra a aba Terminal. Em qualquer projeto baseado no Vite, execute:

bash

npm run build

Leia para cima a partir da última linha failed ou exit code 1 e copie o primeiro erro específico. Ramos comuns são:

  • Module not found ou um erro de importação: um arquivo, pacote ou nome de arquivo não corresponde.
  • Um erro de sintaxe ou tipo: o último código alterado não compilou.
  • Uma variável de ambiente ausente: a aplicação inicia antes de um banco de dados ou configuração de API necessária existir.
  • Um erro de dependência: o pacote está faltando no projeto ou suas versões conflitam.

Cole essa linha exata no chat do agente com a instrução: “Explique a causa raiz primeiro. Não edite ainda.” Após a explicação corresponder ao log, peça por uma alteração limitada.

Ramo 3 — O build passa, mas a pré-visualização ainda está vazia

Abra as ferramentas de desenvolvedor do navegador e selecione Console, depois recarregue a pré-visualização. Copie o primeiro erro de tempo de execução vermelho. Um build de produção limpo ainda pode falhar no navegador porque um segredo está faltando, uma solicitação de API está bloqueada ou o código do cliente lê um valor indefinido.

Se o projeto usa Supabase ou outra API, inspecione os segredos atuais do projeto ou as configurações de ambiente. Confirme os nomes das variáveis exatamente, incluindo qualquer prefixo público exigido pelo framework. Nunca cole o valor do segredo em um post de suporte ou prompt de IA.

Em seguida, teste a pré-visualização em um navegador Chromium com extensões e VPN temporariamente desativados. Se funcionar lá, o código do projeto provavelmente não é a causa; reative uma extensão do navegador ou camada de rede por vez.

Ramo 4 — Uma alteração de configuração causou isso

Se a falha começou imediatamente após o agente alterar vite.config.ts, roteamento, um proxy ou cabeçalhos de segurança, compare essa alteração com a versão anterior que funcionava. Restaure o último checkpoint funcional quando não puder explicar a alteração. Em seguida, reaplique apenas a configuração mínima necessária.

Evite redefinir todo o projeto. Uma restauração de versão é mais segura porque fornece uma base conhecida e torna a alteração quebrada visível.

Verifique a correção

Uma imagem de pré-visualização sozinha não é suficiente. Confirme os quatro testes:

  1. npm run build termina sem erro.
  2. O console do navegador não tem novas exceções vermelhas após recarregar.
  3. A primeira tela renderiza e seu botão principal ou formulário responde.
  4. Um navegador ou janela privada carrega a mesma pré-visualização.

Se a pré-visualização funciona apenas em um navegador, continue investigando extensões, cache, VPN ou política de rede em vez de alterar o código da aplicação.

Se ainda não funcionar

Restaure a versão anterior que funcionava e reproduza a falha com uma pequena alteração. Salve o erro do terminal, erro do console, nome da ferramenta, navegador e o passo que causou a falha. Envie esses detalhes ao canal oficial de suporte da plataforma. Não inclua chaves de API, tokens de acesso, segredos do projeto ou dados pessoais.

Resumo para iniciantes

Não peça à IA para 'corrigir tudo'. Abra o terminal, copie o primeiro erro vermelho e pergunte o que causou essa linha exata. Execute npm run build, verifique os segredos necessários e faça uma alteração. Se a nova tentativa quebra mais coisas, volte para a versão anterior que funcionava.