Ferramentas de Diagnóstico (Bug Scanner)

O Bug Scanner é o seu assistente gratuito para encontrar erros na pré-visualização antes de publicar o app.

O Bug Scanner é a ferramenta do editor que mostra o que acontece dentro da janela de pré-visualização do seu app: mensagens do console, erros de página, requisições de rede e navegação. Ele ajuda você a entender por que algo quebrou antes de pedir correção no chat — economizando créditos e tempo.

Onde fica e quando está disponível

O botão do Bug Scanner fica na barra da área de pré-visualização, ao lado dos controles de desktop / mobile. O ícone lembra uma lupa com código 🔍.

O botão pode ficar desabilitado enquanto não há URL de preview ou enquanto um build está em execução. Espere a pré-visualização ficar pronta para usar a ferramenta.

Se houver erros críticos detectados, um contador pode aparecer no botão para chamar sua atenção.

Ao abrir, o painel organiza a informação em abas (Console, Erros da pré-visualização, Rede, Navegação).

O que o Bug Scanner é

• Um diagnóstico da pré-visualização: o que o seu app está fazendo enquanto você desenvolve.

• Uma forma de copiar detalhes de erros rapidamente.

• Uma interface para usar ações como "tentar corrigir" ou "inspecionar" em um erro específico, quando a interface oferecer esses botões.

O que o Bug Scanner não é

• Não é um substituto para testes de QA manuais no app publicado.

• Não detecta todos os problemas — regras de negócio erradas, por exemplo, não aparecem ali (o app pode estar "funcionando" tecnicamente, mas fazendo a conta errada).

• Não é monitoramento de produção — serve apenas para o que está rodando no preview do editor.

Tipos de informação

📋 Console

Mensagens técnicas do navegador. Útil para identificar:

• Erros de lógica visual.

• Travamentos na interface.

• Avisos (warnings) que indicam problemas sutis.

⚠️ Erros da Pré-visualização

Problemas detectados pela própria pré-visualização:

• Páginas que não carregam.

• Erros de renderização.

• Componentes que quebraram.

🌐 Rede (Requisições)

Lista de chamadas a APIs feitas pelo app. Procure linhas vermelhas com status:

• 400 → pedido malformado.

• 401 → autenticação inválida (API Key errada ou expirada).

• 500 → erro no servidor remoto.

Sub-aba Preview / Response: Ao clicar em uma requisição com erro, aparece a mensagem real retornada pelo servidor (ex.: "model not found", "invalid API key"). Essa mensagem é ouro puro na hora de pedir correção.

🗺️ Navegação

Histórico das páginas que o app carregou durante a sessão de preview. Útil para entender redirecionamentos inesperados e fluxos que não se comportaram como você esperava.

Como usar no dia a dia

Um fluxo simples e eficaz:

1. Seu app "quebra" ou se comporta de forma estranha na pré-visualização.

2. Abra o Bug Scanner.

3. Veja qual aba mostra algo relevante (Console costuma ser o primeiro lugar a olhar).

4. Copie a mensagem de erro específica.

5. Volte ao chat (ideal em Modo Chat, que custa menos) e peça a correção já com a mensagem em mãos.

Boa prática antes de pedir ajuda ao chatSempre que possível, abra o Bug Scanner e copie a mensagem de erro específica antes de acionar o chat. Isso economiza créditos — a IA não precisa descobrir o que está acontecendo, apenas resolver.Um prompt como "meu app está com bug" vai gastar créditos em diagnóstico. Um prompt como "está retornando este erro no console: [cole aqui]" vai direto para a solução.

Glossário rápido

• Backend: A parte que roda nos "bastidores" do app (banco de dados, regras, autenticação).

• Deploy: O ato de colocar ou atualizar a versão do app que as pessoas veem na internet.

• Frontend: A parte visual do app — o que o usuário vê e clica.

• Console: A "caixa de ferramentas" do navegador onde aparecem mensagens técnicas.

• API: A ponte que permite que sistemas conversem entre si.

Links relacionados

• Inspetor de Build — para entender o que aconteceu em cada execução da IA.

• Diagnóstico e Resolução de Erros — guia completo para quando o Bug Scanner não resolve.

Próximo passo: Se o Bug Scanner mostrou um erro e você quer saber como resolver, continue em Diagnóstico e Resolução de Erros.