✅ Checklist PWA - Tools Artes do Sul

🔍 Verificações Necessárias

1. Arquivos Criados

  • ✅ manifest-tools.json - Manifest para o site principal
  • ✅ sw-tools.js - Service Worker para o site principal
  • ✅ Referências adicionadas no index.html

2. Verificações no Servidor

Arquivos que DEVEM estar na raiz do servidor:

/
├── index.html
├── manifest-tools.json  ← IMPORTANTE: Deve estar acessível
├── sw-tools.js          ← IMPORTANTE: Deve estar acessível
├── icons/
│   ├── icon-16x16.png
│   ├── icon-32x32.png
│   ├── icon-72x72.png
│   ├── icon-96x96.png
│   ├── icon-128x128.png
│   ├── icon-144x144.png
│   ├── icon-152x152.png
│   ├── icon-192x192.png
│   ├── icon-384x384.png
│   └── icon-512x512.png

3. Verificações de Caminhos

✅ Verificar se os arquivos estão acessíveis:

  • https://tools.artesdosul.com/manifest-tools.json
  • https://tools.artesdosul.com/sw-tools.js
  • https://tools.artesdosul.com/icons/icon-192x192.png
  • https://tools.artesdosul.com/icons/icon-512x512.png

4. Verificações no Navegador

Chrome DevTools:

  1. Abrir DevTools (F12)
  2. Ir em Application > Manifest
    • Verificar se o manifest está sendo carregado
    • Verificar se há erros
    • Verificar se os ícones estão sendo encontrados
  3. Ir em Application > Service Workers
    • Verificar se o service worker está registrado
    • Verificar se está ativo (activated)
    • Verificar se há erros no console
  4. Ir em Application > Storage
    • Verificar se o cache está sendo criado

Console do Navegador:

  • Verificar mensagens [SW] Service Worker registrado com sucesso
  • Verificar se não há erros 404 para manifest ou sw-tools.js

5. Testes de Instalação

Chrome/Edge:

  • Deve aparecer ícone de instalação na barra de endereços
  • Ou menu > “Instalar Ferramentas e Utilitários”

Mobile (Android):

  • Menu do navegador > “Adicionar à Tela Inicial”

iOS Safari:

  • Compartilhar > “Adicionar à Tela de Início”

6. Problemas Comuns

❌ Manifest não carrega:

  • Verificar se manifest-tools.json está na raiz
  • Verificar Content-Type: application/manifest+json
  • Verificar se o JSON é válido (sem erros de sintaxe)

❌ Service Worker não registra:

  • Verificar se sw-tools.js está na raiz
  • Verificar se está servindo via HTTPS (obrigatório em produção)
  • Verificar console para erros
  • Verificar se o scope está correto

❌ Ícones não aparecem:

  • Verificar se a pasta icons/ existe
  • Verificar se os arquivos PNG existem
  • Verificar se os caminhos no manifest estão corretos
  • Verificar permissões de arquivo no servidor

❌ PWA não instala:

  • Verificar se há pelo menos um ícone 192x192 e 512x512
  • Verificar se o manifest é válido
  • Verificar se está usando HTTPS
  • Verificar se o start_url está correto

7. Comandos de Verificação

Verificar se manifest está acessível:

curl -I https://tools.artesdosul.com/manifest-tools.json

Verificar se service worker está acessível:

curl -I https://tools.artesdosul.com/sw-tools.js

Verificar se ícones estão acessíveis:

curl -I https://tools.artesdosul.com/icons/icon-192x192.png
curl -I https://tools.artesdosul.com/icons/icon-512x512.png

8. Lighthouse PWA Audit

Execute o Lighthouse no Chrome DevTools:

  1. Abrir DevTools (F12)
  2. Ir em Lighthouse
  3. Selecionar Progressive Web App
  4. Clicar em Generate report
  5. Verificar score e problemas reportados

9. Correções Necessárias

Se o manifest não estiver sendo encontrado, você pode:

  1. Renomear manifest-tools.json para manifest.json (se não houver conflito)
  2. Ou ajustar o caminho no HTML: <link rel="manifest" href="/manifest-tools.json">

10. Headers HTTP Importantes

Certifique-se de que o servidor está retornando:

  • Content-Type: application/manifest+json para manifest.json
  • Content-Type: application/javascript para sw-tools.js
  • Headers CORS apropriados se necessário

🚀 Próximos Passos

  1. Fazer upload dos arquivos para o servidor
  2. Verificar acessibilidade dos arquivos
  3. Testar no navegador
  4. Verificar no DevTools
  5. Testar instalação
  6. Executar Lighthouse audit