O site clonado não abre, aparece sem CSS, perdeu imagens ou ficou com as animações travadas? Antes de refazer a captura, confira os erros do navegador e a organização dos arquivos. Na maioria dos projetos estáticos, um arquivo ausente, um caminho incorreto ou o teste direto pelo file:// explica boa parte desses sintomas. Em aplicações com backend, porém, a cópia visual pode estar íntegra e ainda assim não conseguir fazer login ou enviar dados.
Neste tutorial, você vai aprender a testar um pacote HTML em um servidor local, identificar erros 404 pelo DevTools, corrigir imagens e fontes que não carregam e investigar bibliotecas como GSAP, ScrollTrigger e Lenis. O foco é fazer funcionar o front-end de um projeto que você possui ou está autorizado a reutilizar, sem prometer que uma captura reproduz sistemas privados.
Guia revisado em 19 de novembro de 2026, com referências à MDN, Chrome DevTools e documentação oficial de GSAP e Lenis. Os exemplos são ilustrativos; cada site pode depender de bibliotecas e APIs específicas.
Resposta rápida: o que conferir primeiro quando um site clonado não abre?
Se você tem a pasta extraída, reserve dez minutos para estas verificações, nesta ordem:
- Confira o arquivo inicial. Procure
index.htmlna raiz do pacote. Em projetos com várias páginas, veja se os demais arquivos HTML foram exportados. - Não abra pelo explorador de arquivos. Teste em
http://localhost:8000/ou outro servidor local, especialmente quando há JavaScript modular. - Abra Chrome DevTools → Network. Recarregue a página e filtre requisições com erro
404,403ou5xx. - Confira a aba Console. Procure o primeiro erro de JavaScript e não apenas os avisos posteriores que ele desencadeou.
- Verifique dependências externas. Fontes, vídeos, APIs, scripts e animações podem fazer requisições para domínios que não pertencem ao pacote.
- Teste mobile, botões e formulários. A página parecer correta no computador não comprova que a cópia está funcional.
A ordem importa. Uma página sem CSS por causa de um 404 precisa de uma correção diferente de uma página com GSAP funcionando, mas com posições de rolagem desatualizadas.
1. Veja se o ZIP contém a estrutura correta
Extraia o arquivo ZIP em uma pasta nova. Não tente executar um site com os arquivos ainda dentro do compactador. O exemplo abaixo é uma estrutura válida para um front-end estático simples:
site-extraido/
index.html
contato.html
css/
style.css
js/
app.js
images/
hero.webp
fonts/
site.woff2
Abra o HTML e confira o que está escrito nas referências. Se o código pede images/hero.webp, mas o arquivo está em img/hero.webp, o navegador não vai adivinhar o caminho correto. O mesmo vale para letras maiúsculas e minúsculas: Hero.webp e hero.webp podem ser interpretados como arquivos distintos em servidores Linux.
Se a pasta contém site-extraido/public/index.html, publicar a pasta de cima como raiz pode produzir uma página 404. Você precisa apontar a publicação para o diretório correto. Essa verificação também evita erros quando o pacote foi gerado por um sistema com etapa de build.
A documentação da MDN sobre caminhos de arquivos mostra como referências relativas dependem da posição dos documentos.
2. Rode o HTML em um servidor local antes de editar
Um erro comum é clicar duas vezes no index.html e concluir que a clonagem falhou porque o endereço começa com file:///. Esse teste é limitado, especialmente para scripts com type="module" e import, que seguem regras de origem e CORS.
Se o Python estiver instalado, abra o terminal dentro da pasta que contém o index.html e execute:
python -m http.server 8000
No Windows, algumas instalações usam py -m http.server 8000. Depois abra http://localhost:8000/ no navegador. Se a porta 8000 estiver ocupada, escolha outra e use o mesmo número na URL. Esse servidor é somente para testes locais, sem autenticação ou recursos de produção; não o exponha à internet para hospedar clientes.
Se a página passar a funcionar, o problema provavelmente estava ligado à forma como o navegador carregava os arquivos locais. A MDN recomenda testar módulos JavaScript por HTTP, não por file://.
Se continuar falhando: mantenha o servidor aberto, pressione F12 e siga para os próximos testes. Agora as requisições vão aparecer com caminhos HTTP verificáveis.
3. Site clonado abre sem CSS ou com layout desmontado
Quando o texto e as imagens aparecem empilhados, sem fontes, cores ou espaçamentos, o HTML pode estar carregando normalmente, mas a folha CSS não foi encontrada. Abra DevTools → Network, marque a opção para preservar o log se precisar e atualize a página. Procure solicitações com 404, especialmente arquivos terminados em .css.
Exemplo de referência que depende da pasta correta:
<link rel="stylesheet" href="./css/style.css">
Se o arquivo existe em assets/css/style.css, corrija a referência para refletir o caminho real. Em arquivos CSS, as URLs de fontes e imagens de fundo normalmente são resolvidas em relação à localização do próprio CSS, não do index.html.
Uma armadilha adicional é o caminho iniciado por /, como /assets/site.css. Ele aponta para a raiz do domínio. O resultado pode funcionar em https://exemplo.com/ e falhar em https://exemplo.com/projeto/ quando o site está hospedado dentro de uma subpasta. Não substitua todas as barras automaticamente: primeiro confira onde o site será publicado.
Se a aba Network mostra status 200, mas o navegador recusa o CSS por tipo MIME, clique no arquivo e veja a aba Response. Alguns servidores devolvem uma página HTML de erro com status aparentemente bem-sucedido, em vez do arquivo CSS real.
4. Imagens e fontes somem depois da captura
Quando as imagens desaparecem, identifique primeiro qual URL o navegador tentou carregar. Clique com o botão direito na imagem quebrada, inspecione o elemento e confira o atributo src, srcset ou a regra CSS background-image.
Também existem sites com carregamento adiado, chamado lazy loading. Neles, o HTML pode incluir data-src, data-srcset ou JavaScript que preenche o endereço da imagem quando a seção entra na tela. Se esse script não executa, a imagem pode continuar vazia apesar de estar no pacote.
- Arquivo ausente: confira se a imagem ou fonte realmente foi exportada, com o nome e a extensão certos.
- URL antiga: veja se o projeto ainda chama recursos no domínio original e se esses recursos podem ser utilizados legalmente.
- Erro 403: alguns serviços restringem o carregamento externo; a solução pode exigir ativos próprios ou uma origem autorizada.
- Fontes diferentes: examine
@font-face,woff2, política de licença e mensagens de erro no Console. - Imagem só no mobile: verifique
<picture>,srcset, regras CSS responsivas e alterações por JavaScript.
Não recomendo baixar indiscriminadamente imagens, vídeos e fontes protegidos de terceiros. Para projetos de clientes, use os arquivos disponibilizados pelo titular ou recursos com licença adequada. A captura visual não elimina direitos autorais e de marca.
5. Tela branca ou erro “Failed to fetch dynamically imported module”
Uma página branca pode significar que o JavaScript da aplicação falhou antes de renderizar o conteúdo. Isso é comum quando falta um arquivo de módulo, o caminho do import() foi alterado ou um servidor devolveu HTML em vez de JavaScript.
Abra Console e procure a primeira falha. Depois localize a mesma URL no painel Network. Alguns sinais frequentes:
| Mensagem ou sintoma | Possível causa | O que verificar |
|---|---|---|
404 Not Found |
Arquivo inexistente no destino | Pasta, nome e URL solicitada |
| Erro de MIME type | HTML servido como JavaScript ou CSS | Response, Content-Type e regra de roteamento |
Failed to fetch / CORS |
Requisição bloqueada ou serviço indisponível | Destino, permissões da API e cabeçalhos |
ReferenceError |
Variável ou biblioteca não inicializada | Ordem dos scripts e dependências ausentes |
Não resolva CORS desativando a segurança do navegador para clientes. A correção deve acontecer na arquitetura e nas permissões do servidor que controla o recurso, quando você tem autorização para isso. Chaves secretas também não devem ser copiadas para o JavaScript público.
O guia oficial do Chrome DevTools sobre requisições de rede mostra como descobrir a URL real, o status HTTP e qual arquivo iniciou a requisição.
6. Animações GSAP, ScrollTrigger ou Lenis pararam
Sites com animações avançadas exigem um diagnóstico diferente de imagens estáticas. O HTML pode abrir perfeitamente, mas o efeito depender de scripts, plugins, configuração de rolagem, elementos presentes no DOM e medidas calculadas depois do carregamento de imagens ou fontes.
Comece com três verificações: a biblioteca foi carregada? O Console mostra um erro de inicialização? O elemento que deveria animar realmente existe na página? Se qualquer resposta for negativa, não tente “recriar a animação” antes de resolver isso.
GSAP e ScrollTrigger
O GSAP precisa estar disponível quando o script tenta utilizá-lo. Em projetos com bundlers, confirme se as importações apontam para dependências existentes. Se o script usa o plugin ScrollTrigger, confira se ele foi importado e registrado no contexto correto.
Quando uma seção muda de altura após o carregamento de imagens ou a inserção de novos elementos, as posições de início e fim das animações por rolagem podem ficar incorretas. O método ScrollTrigger.refresh() pode recalcular essas posições quando o plugin já está inicializado corretamente.
// Exemplo: execute depois que o layout mudou
// e somente se ScrollTrigger estiver carregado.
if (typeof ScrollTrigger !== 'undefined') {
ScrollTrigger.refresh();
}
Isso não corrige scripts ausentes, plugins incompatíveis ou arquivos não encontrados. É um ajuste específico de medições. Consulte a documentação oficial do ScrollTrigger.refresh.
Lenis e rolagem suave
Se o site usa Lenis para suavizar a rolagem, confira se a instância está iniciada e recebendo atualizações de animação. A documentação do projeto orienta usar autoRaf quando apropriado ou chamar lenis.raf(time) no loop configurado. Uma integração com GSAP também exige coordenar os ciclos de atualização.
Não adicione um segundo loop requestAnimationFrame sem verificar como o site já o controla. Duas rotinas concorrentes podem provocar movimentos estranhos. Veja as instruções no repositório oficial do Lenis.
Se as animações não aparecem em alguns dispositivos, confira também a preferência de acessibilidade prefers-reduced-motion. Um projeto pode reduzir efeitos intencionalmente para pessoas que configuraram menos movimento; isso não deve ser tratado automaticamente como defeito.
7. A página abre, mas formulário, login ou botão não funcionam
Esse é o limite que mais confunde quem trabalha com captura de front-end. Um botão pode depender apenas de um link e funcionar imediatamente. Já um formulário pode precisar de um serviço que recebe os dados, envia e-mail, verifica captcha e registra informações no banco. Copiar HTML e JavaScript não cria esses serviços.
Se o envio falha, faça o teste na aba Network → Fetch/XHR: identifique o endereço chamado, o status retornado e a resposta do serviço. Endpoints que apontam para o domínio original, exigem cookies autenticados ou tokens privados não devem ser simplesmente reutilizados sem autorização.
- Para botões e menus, confira
href, handlers JavaScript e sobreposição de elementos invisíveis. - Para formulários, implemente um endpoint próprio e configure e-mail e validação apropriados, com proteção contra spam.
- Para login, conecte um backend e um serviço de autenticação sob seu controle, com domínio e redirecionamentos corretos.
- Para buscas, carrinho e área de membros, planeje integrações com serviços e dados reais em vez de prometer funcionamento a partir de uma cópia visual.
Se quiser publicar uma versão estática com formulário funcional, veja nosso tutorial para colocar um site HTML no ar pelo Cloudflare Pages. Nele explicamos por que a hospedagem estática, sozinha, não envia formulários por e-mail.
8. Funciona no computador, mas quebra quando você publica
Depois de corrigir o site localmente, teste em um endereço de pré-visualização antes de apontar o domínio principal. Um servidor pode tratar caminhos com maiúsculas de maneira diferente, exigir diretório de saída específico ou redirecionar URLs internas para index.html sem querer.
Se o projeto é HTML estático, publique a pasta que realmente contém os arquivos usados pelo navegador. Se você tem um projeto original em React ou Vite, não confunda arquivos-fonte com o resultado de uma compilação: pode ser necessário rodar o build e publicar a pasta gerada, conforme a configuração do framework.
Quando a página carrega via / mas dá 404 ao abrir uma rota interna diretamente, investigue o mecanismo de rotas. Em SPAs, o servidor pode precisar devolver o HTML inicial para rotas de navegação, sem transformar requisições de arquivos .js ou .css inexistentes em respostas HTML, o que gera erros de MIME. Em exportações multipáginas de HTML, cada rota precisa corresponder a um arquivo ou regra válida.
Confira nosso tutorial de publicação com Vercel e GitHub para entender os cuidados de deploy. Leia as regras do plano gratuito antes de usar a hospedagem em projetos comerciais.
Quando vale refazer a captura do site?
Recapturar pode ser útil se o ZIP realmente está incompleto, se os arquivos esperados não aparecem nele ou se a página original carregava recursos sob demanda que não foram reunidos durante a captura. Mas se um CSS já está na pasta e o HTML aponta para um caminho errado, uma nova captura provavelmente só repete o problema.
Antes de tentar outra vez, registre quais arquivos falham, em qual navegador, em qual rota e se a origem carregava esses recursos antes da captura. Em páginas com conteúdo dinâmico, teste as seções autorizadas e disponíveis publicamente que você realmente precisa utilizar.
Trabalha com sites de referência e precisa capturar os arquivos?
O SiteCloner Pro é uma opção para capturar front-end público, organizar recursos e continuar a edição de HTML, CSS, imagens e scripts. A compatibilidade depende da página. Ele não copia backend, banco de dados ou áreas privadas, nem garante que todas as animações continuarão funcionando sem ajustes.
Para aprender a capturar um site desde o começo, com um exemplo e vídeo, leia também nosso guia completo sobre clonagem de sites com animações. Aqui, o foco é consertar o projeto depois da exportação.
Checklist antes de entregar um site clonado para um cliente
Confira estes pontos no desktop e no celular, usando um domínio de teste:
- O arquivo inicial e as páginas públicas desejadas abrem sem 404.
- CSS, fontes, imagens, vídeos e scripts essenciais carregam corretamente.
- O Console não mostra erros críticos que interrompam a interface.
- As principais animações carregam e não impedem a leitura ou navegação.
- Menus, botões, links externos e âncoras funcionam.
- Formulários foram implementados ou reconectados a um serviço autorizado e testado.
- Conteúdo, marca e imagens usados no projeto têm autorização e foram adaptados ao cliente.
- O site tem título próprio, descrição, favicon e configurações de SEO pertinentes.
- O pacote final foi salvo com uma cópia de segurança e instruções de manutenção.
Se a função essencial depende de uma API privada do site de origem, deixe isso documentado antes da entrega. A aparência semelhante não é equivalente a um aplicativo completo funcionando.
Perguntas frequentes
Por que meu site clonado aparece todo desconfigurado?
Geralmente o HTML abriu sem um ou mais arquivos CSS, fontes ou imagens. O primeiro teste é abrir DevTools → Network e encontrar requisições com status 404. Em seguida, confira os caminhos escritos no HTML e as pastas extraídas.
Preciso de um servidor para abrir o HTML clonado?
Para HTML simples, um navegador pode abrir arquivos locais. Em projetos com módulos JavaScript e dependências, o ideal é testar por HTTP, usando um servidor local, para não confundir erros da origem file:// com falhas de exportação.
Por que as animações GSAP não funcionam depois da clonagem?
Verifique se a biblioteca e os plugins carregaram, se os scripts inicializam depois dos elementos necessários e se dependências ou recursos estão ausentes. O ajuste ScrollTrigger.refresh() serve para recalcular medidas em projetos compatíveis, não para recuperar bibliotecas que não foram carregadas.
Meu site clonado não envia mensagens pelo formulário. É normal?
Sim, pode acontecer. Um formulário depende de um serviço no servidor ou de uma API que recebe os dados. Copiar o front-end não transfere automaticamente esse serviço. Você precisa implementar uma integração própria e testar o envio.
Por que o clone abre no localhost e não na hospedagem?
Investigue diferenças entre diretórios, caminhos absolutos, letras maiúsculas/minúsculas, configuração de rotas, tipos MIME e recursos externos. Confira os erros no Console e no Network da versão publicada.
O SiteCloner Pro recupera 100% das animações?
Não há garantia de fidelidade total em todas as páginas. GSAP, Lenis, WebGL, conteúdo dinâmico e serviços externos dependem de arquivos, configuração e acesso compatíveis. O resultado deve ser testado antes de ser entregue.
É permitido capturar e reutilizar qualquer site?
Não. Acesso público ao front-end não concede automaticamente direitos de reutilização de textos, marcas, imagens, códigos ou outros elementos protegidos. Trabalhe com projetos próprios, licenciados ou autorizados e respeite os termos e direitos aplicáveis.
Fontes técnicas utilizadas
Revisado em 19/11/2026. As ferramentas e suas versões podem evoluir, então compare o procedimento ao código que você realmente possui.
- Chrome DevTools: diagnosticar requisições, iniciadores e falhas de rede.
- Chrome DevTools: erros e mensagens do Console.
- MDN: módulos JavaScript, file://, CORS e tipo MIME.
- MDN: organização de arquivos e caminhos relativos.
- GSAP: ScrollTrigger.refresh e recálculo de posições.
- Lenis: integração, RAF e configuração da rolagem suave.