1
resposta

[Dúvida] GitHub Pages retornando erro 404

https://github.com/joaovnicius1/tecboard.git

Estou enfrentando um problema ao publicar um site estático utilizando o GitHub Pages.

O repositório contém corretamente um arquivo index.html localizado na raiz do projeto, além das pastas de recursos (css, img, fontes) , pesquisei, tentei criar o arquivo .nojekyll pra ver se mudava algo. A branch utilizada é a main, e os arquivos estão versionados corretamente nela.

Nas configurações do repositório (Settings → Pages), o GitHub Pages está configurado para:

Source: Deploy from a branch

Branch: main

Folder: / (root)

Após salvar as configurações, aguardei o tempo necessário para o deploy (mais de 30 minutos), limpei o cache do navegador e testei o acesso em modo anônimo, porém o endereço:

https://joaovnicius1.github.io/tecboard/

continua retornando erro 404 (Page Not Found).

Outros pontos já verificados:

O repositório está público

O arquivo index.html está com o nome correto

Não há domínio personalizado configurado

Foi realizado novo commit após a configuração do Pages para forçar o rebuild

O erro persiste mesmo ao tentar acessar arquivos diretamente pela URL

Apesar da estrutura do projeto e das configurações estarem de acordo com a documentação do GitHub Pages, o site não é publicado corretamente.

Gostaria de orientação para identificar a causa do erro ou verificar se há alguma limitação, falha de deploy ou configuração adicional necessária.

1 resposta

Olá, João!

Testei o seu link aqui (https://joaovnicius1.github.io/tecboard/) e ele abriu corretamente! O site está no ar com o fundo escuro e o título "TecBoard".

Insira aqui a descrição dessa imagem para ajudar na acessibilidade
Às vezes, mesmo que o GitHub informe que o deploy foi concluído nas configurações, pode haver um atraso na propagação dos servidores (CDN) ou um cache persistente, especialmente quando fazemos muitas alterações seguidas ou quando é a primeira publicação.

Sugestão:
Por favor, verifique novamente agora. Se ainda não aparecer para você:

  1. Tente limpar o cache forçado com CTRL + F5.
  2. Confira sempre a aba Actions do seu repositório para garantir que o fluxo de build ficou "verde" (concluído).

Se o erro persistir tente usar a vercel, esse artigo ensina o passo a passo:

Para saber mais:

Sugestão de conteúdo:

Como você já fez todos os passos corretos (index na raiz, branch main, repo público), era provável que fosse apenas uma questão de tempo de resposta do servidor mesmo.

Bons estudos!

Sucesso

Imagem da comunidade