> For the complete documentation index, see [llms.txt](https://docs.adapta.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adapta.org/skip/comece-aqui/ferramentas-de-diagnostico-bug-scanner.md).

# 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** 🔍.

{% hint style="info" %}
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.
{% endhint %}

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 chat**Sempre 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.

{% hint style="success" %}
**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**](/skip/comece-aqui/diagnostico-e-resolucao-de-erros.md).
{% endhint %}