1- # Guia de Debug - Tela Branca
1+ # Debug
22
3- ## Como identificar o problema
4-
5- ### 1. Abra o Console do Navegador
6- 1 . Acesse o site: ` https://duckdevlabs.com `
7- 2 . Pressione ` F12 ` ou ` Cmd+Option+I ` (Mac)
8- 3 . Vá na aba ** Console**
9- 4 . Procure por erros em vermelho
10-
11- ### 2. Verifique os Erros Comuns
12-
13- #### Erro: "Failed to fetch dynamically imported module"
14- - ** Causa** : Assets não estão sendo encontrados
15- - ** Solução** : Verifique se os arquivos estão em ` /assets/ ` no servidor
16-
17- #### Erro: "Uncaught SyntaxError"
18- - ** Causa** : JavaScript malformado ou CSP bloqueando
19- - ** Solução** : Verifique se o build foi feito corretamente
20-
21- #### Erro: "ReactDOM is not defined" ou "React is not defined"
22- - ** Causa** : Dependências não carregadas
23- - ** Solução** : Verifique se o ` index.js ` está sendo carregado
24-
25- #### Erro: "Root element not found"
26- - ** Causa** : HTML não tem ` <div id="root"> `
27- - ** Solução** : Verifique o ` dist/index.html `
28-
29- ### 3. Verifique a Aba Network
30- 1 . Na aba ** Network** do DevTools
31- 2 . Recarregue a página (` Ctrl+R ` ou ` Cmd+R ` )
32- 3 . Procure por arquivos com status ** 404** ou ** Failed**
33- 4 . Verifique se estão sendo carregados:
34- - ` index.html `
35- - ` assets/index.[hash].js `
36- - ` assets/index.[hash].css `
37- - ` assets/duck-avatar.jpeg `
38- - ` assets/duckdev-banner.jpeg `
39-
40- ### 4. Verifique o GitHub Actions
41- 1 . Vá na aba ** Actions** do repositório
42- 2 . Veja se o último workflow foi executado com sucesso
43- 3 . Clique no workflow e veja os logs
44- 4 . Procure por erros no build
45-
46- ### 5. Teste Localmente
473``` bash
484# Build local
495npm run build
@@ -55,65 +11,21 @@ npm run preview
5511# Se funcionar localmente, o problema é no deploy
5612```
5713
58- ## Problemas Conhecidos e Soluções
59-
60- ### Problema: Site funciona localmente mas não no GitHub Pages
61- ** Solução:**
62- 1 . Verifique se o GitHub Pages está usando ** "GitHub Actions"** como source
63- 2 . Verifique se o arquivo ` .nojekyll ` está sendo criado no build
64- 3 . Verifique os logs do workflow
65-
66- ### Problema: Assets não carregam (404)
67- ** Solução:**
68- 1 . Verifique se o ` base: '/' ` está correto no ` vite.config.js `
69- 2 . Verifique se os arquivos estão em ` dist/assets/ `
70- 3 . Verifique se o CNAME está correto
71-
72- ### Problema: JavaScript não executa
73- ** Solução:**
74- 1 . Verifique o CSP no ` index.html `
75- 2 . Verifique se há erros de sintaxe no console
76- 3 . Desabilite extensões do navegador que possam interferir (AdBlock, etc.)
77-
78- ## Ferramentas de Debug
79-
80- ### Verificar Build Local
8114``` bash
8215npm run build
8316ls -la dist/
8417cat dist/index.html
8518```
8619
87- ### Verificar Assets
20+ ## Verificar Assets
21+
8822``` bash
8923ls -la dist/assets/
9024```
9125
92- ### Testar Build
26+ ## Testar Build
27+
9328``` bash
9429npm run preview
9530# Abra http://localhost:4173
96- ```
97-
98- ## Se Nada Funcionar
99-
100- 1 . ** Limpe o cache do navegador** : ` Ctrl+Shift+Delete ` ou ` Cmd+Shift+Delete `
101- 2 . ** Teste em modo anônimo** : ` Ctrl+Shift+N ` ou ` Cmd+Shift+N `
102- 3 . ** Teste em outro navegador** : Chrome, Firefox, Safari
103- 4 . ** Verifique o DNS** : Use ` nslookup duckdevlabs.com `
104- 5 . ** Verifique o certificado SSL** : Clique no cadeado na barra de endereços
105-
106- ## Logs Úteis
107-
108- Execute no console do navegador:
109- ``` javascript
110- // Verificar se React está carregado
111- console .log (window .React )
112-
113- // Verificar se o root existe
114- console .log (document .getElementById (' root' ))
115-
116- // Verificar erros carregados
117- console .error
118- ```
119-
31+ ` `
0 commit comments