App travando ou lento

App ficou lento, travando, ou mostrando "tela branca". Antes de pensar que é problema do servidor, alguns passos rápidos resolvem 90%.

Sequência de fix (mais simples → mais drástico)

1. Hard refresh (5s)

No browser:

Windows / Linux: Ctrl + Shift + R
Mac: Cmd + Shift + R

Força browser a baixar tudo de novo (ignorando cache).

No PWA (app instalado):

Mobile: pull-to-refresh (puxa pra baixo)
Mobile (alternativa): fecha o app e abre de novo

2. Limpar cache do site (30s)

Chrome desktop:

Aperta F12 (DevTools)
Click direito no botão Reload (na barra)
Escolhe "Esvaziar cache e atualizar"

Chrome mobile:

Configurações do navegador
Privacidade → Limpar dados de navegação
Marca "Imagens e arquivos em cache" + "Cookies e dados de site"
Limpar

Safari mobile:

Ajustes do iPhone (não do app)
Safari → Avançado → Dados de Sites → kontato.themagicbox.app
Remover dados

3. Desinstalar e reinstalar PWA (1min)

Se você instalou a Kontato como PWA (atalho na tela inicial):

Mobile:

Long-press no ícone Kontato → Remover / Desinstalar
Abre https://kontato.themagicbox.app no navegador
Banner aparece: "Instalar Kontato" → click
App recriado do zero

Desktop (Chrome):

Vai em chrome://apps
Click direito em "Kontato" → Remover do Chrome
Abre o site → "Instalar" no canto direito da URL

4. Modo anônimo (teste de diagnóstico)

Abre janela anônima (Ctrl + Shift + N no Chrome) e tenta logar.

Funciona no anônimo? → problema é cache/extensão/cookies do navegador normal. Limpa.
Não funciona nem no anônimo? → problema é do app/servidor. Reporta suporte.

Causas comuns

Cache PWA antigo após nova versão

Toda nova versão da Kontato dispara cache bust (mudança no sw.js). Service Worker:

Detecta CACHE_NAME novo
Apaga cache velho
Baixa arquivos novos

⚠️ Em alguns browsers (Safari iOS especialmente), esse refresh pode demorar ou falhar. Solução: hard refresh ou reinstalar PWA.

Conexão fraca / 4G ruim

Kontato carrega 80% no primeiro acesso, depois usa cache. Mas mensagens em real-time (Supabase Realtime) precisam de conexão estável.

Sintomas: mensagens novas demoram a aparecer, badge de WhatsApp fica cinza.

Fix: se Wi-Fi tá fraco, troca pra 4G. Se ambos ruins, espera melhorar (não é problema do app).

Navegador muito antigo

Kontato usa Next.js 16 + React 19, exige browsers recentes:

Chrome: versão 110+
Safari: 16+
Firefox: 110+
Edge: 110+

Browsers antigos podem travar ou mostrar tela branca.

Fix: atualiza o navegador. Em mobile, geralmente vem com OS — atualizar Android/iOS resolve.

Conta com 1000+ conversas

Cockpit de conversas carrega lista com paginação. Se você tem MUITAS conversas (1000+), primeira carga pode demorar 2-3s.

⚠️ Não é bug — espera. Próximas cargas usam cache.

Se sua conta tá com 5000+ conversas e ficou impraticável, contata suporte. Podemos ativar arquivamento automático (conversas > 90 dias somem do cockpit, ficam em "Arquivadas").

Tela branca total

Tela 100% branca, sem header, sem nada:

F12 (DevTools) → aba Console
Verifica se tem erro vermelho
Erro tipo "Loading chunk failed" = cache PWA velho. Hard refresh resolve.
Erro tipo "Network failed" = sem conexão ou servidor fora do ar.
Erro JavaScript específico = manda print pro suporte.