Skip to content

Commit 6ccd4d4

Browse files
committed
Refactor DEBUG.md to streamline debugging guide and remove outdated sections. Consolidate troubleshooting steps and enhance clarity for common issues and solutions.
1 parent 294f908 commit 6ccd4d4

File tree

1 file changed

+6
-94
lines changed

1 file changed

+6
-94
lines changed

DEBUG.md

Lines changed: 6 additions & 94 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,5 @@
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
495
npm 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
8215
npm run build
8316
ls -la dist/
8417
cat dist/index.html
8518
```
8619

87-
### Verificar Assets
20+
## Verificar Assets
21+
8822
```bash
8923
ls -la dist/assets/
9024
```
9125

92-
### Testar Build
26+
## Testar Build
27+
9328
```bash
9429
npm 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

Comments
 (0)