Como Hospedar Seu Site no GitHub Pages — Guia Completo Passo a Passo

A melhor hospedagem gratuita que eu já usei

Se você quer colocar um site no ar sem pagar nada, sem anúncios no rodapé e sem dor de cabeça, o GitHub Pages é, na minha opinião, a melhor opção que existe hoje.

Eu mesmo uso ele para vários projetos pequenos, e a verdade é que ele funciona muito bem. Não tem pegadinha, não vai sumir do nada e ainda vem com certificado de segurança de graça.

Neste guia, eu vou te mostrar o passo a passo que eu sigo sempre que preciso publicar um site rápido. Não é nada complicado, e você consegue fazer tudo em menos de 15 minutos.

Primeiro: o que você vai precisar

Antes de começar, separa aí:

Uma conta no GitHub, que é gratuita.
Os arquivos do seu site já prontos: HTML, CSS, imagens, JavaScript, tudo o que você usa.
Um arquivo principal chamado index.html.

⚠️ Essa parte é importante: se o arquivo da página inicial se chamar qualquer coisa diferente de index.html, o site não vai abrir. Eu já errei isso algumas vezes, então vale a pena conferir antes de enviar.

Passo 1 — Criar uma conta no GitHub

Se você ainda não tem, entra no github.com e se cadastra.

O nome de usuário que você escolher vai aparecer no endereço do seu site. Por exemplo: seunome.github.io. Então tente escolher algo que faça sentido para você ou para o seu projeto.

O cadastro é bem simples: e-mail, senha, confirmação de e-mail e pronto.

Passo 2 — Criar o repositório

O repositório é basicamente uma pasta online onde você vai guardar todos os arquivos do seu site.

Depois de logado:

Clique no botão + no canto superior direito.
Escolha New Repository.
No campo Repository name, coloque: seu-usuario.github.io, trocando “seu-usuario” pelo nome da sua conta.
Deixe a opção Public marcada. Se deixar como privada, o site não vai funcionar no plano gratuito.
Marque a opção Add README file.
Clique em Create Repository.

Pronto, seu repositório já foi criado.

Passo 3 — Enviar os arquivos do seu site

A forma mais fácil, que não precisa instalar nada no computador, é enviar os arquivos diretamente pela página do GitHub.

Na página do repositório, clique em Add file.
Depois clique em Upload files.
Abre a pasta do seu site no computador.
Seleciona todos os arquivos e pastas: index.html, style.css, a pasta de imagens, o JavaScript, tudo.
Arraste esses arquivos para a área que apareceu no GitHub.
Quando terminar o upload, escreve uma mensagem explicando o que você fez, por exemplo: "Arquivos do site enviados".
Clique em Commit changes.

Só espera o upload terminar. Não fecha a página enquanto estiver enviando, porque pode dar erro.

Passo 4 — Ativar o GitHub Pages

Com os arquivos já enviados, agora você precisa dizer ao GitHub que quer publicar esse repositório como um site.

No repositório, clica na aba Settings.
Role a página até encontrar a seção Pages.
Em Source, deixe selecionado Deploy from a branch.
Em Branch, escolha main ou master, dependendo do que aparecer.
A pasta deve ficar como /, ou seja, a raiz do repositório.
Clique em Save.

Feito isso, o GitHub vai começar a preparar o seu site.

Passo 5 — Acessar o site

Agora é só esperar. Geralmente demora entre 2 e 10 minutos.

Você pode atualizar a página de vez em quando. Quando aparecer uma mensagem dizendo que o site foi publicado, é só clicar no link.

O endereço do seu site vai ser:

https://seu-usuario.github.io

Se tudo deu certo, seu site já está no ar.

Problemas comuns que já aconteceram comigo

Tem algumas coisas que podem dar erro no começo, e eu já passei por quase todas:

Se abrir uma página padrão do GitHub, provavelmente o arquivo principal não se chama index.html.
Se o site carregar, mas sem estilo, é porque o caminho do CSS ou das imagens está errado.
Se demorar muito para aparecer, é normal. Às vezes o GitHub demora um pouco para atualizar.
Se a opção Pages não aparecer, confira se o repositório está como Public.
Se o site ficar inseguro, você pode marcar a opção Enforce HTTPS dentro das configurações do Pages.
Se você atualizou os arquivos e a página não mudou, pode ser cache do navegador. Tenta apertar Ctrl + F5.

Vantagens e limitações que ninguém fala

O GitHub Pages é excelente, mas não serve para tudo.

O que é bom:

É realmente gratuito, sem pegadinhas.
Não coloca anúncios no seu site.
Já vem com certificado de segurança HTTPS.
É rápido, porque usa a rede do GitHub.
Não suspende o site por inatividade.
Aceita domínio próprio, se você quiser usar um endereço personalizado.

O que ele não faz:

Não roda WordPress, PHP ou banco de dados.
Tem limite de 1 GB de espaço por repositório.
Tem limite de 100 GB de tráfego por mês.
Atualizações demoram alguns minutos para aparecer.
Não tem suporte direto por e-mail ou telefone.

Então, resumindo: ele é perfeito para sites estáticos, landing pages, portfólios, documentações e projetos pessoais. Agora se você precisa de WordPress, loja ou sistema que use banco de dados, ele não é a melhor escolha.

Passo extra — usar domínio próprio (opcional)

Se você já comprou um domínio, pode usar ele no GitHub Pages.

Para isso:

Vá em Settings e depois Pages.
Procure a opção Custom Domain.
Digite o seu domínio, por exemplo: www.seusite.com.br.
Clique em Save.
Depois você precisa configurar o domínio no site onde ele foi comprado, apontando para os servidores do GitHub.

Essa parte pode dar um pouco de trabalho no começo, mas funciona.

Conclusão

Colocar um site no ar não precisa ser caro nem complicado. O GitHub Pages prova isso.

Se você está começando, quer publicar um projeto ou testar algo rapidamente, ele é uma das melhores escolhas.

Só lembre-se de três coisas:

O arquivo principal tem que ser index.html.
O repositório tem que estar público.
Depois de enviar os arquivos, é só ativar o Pages e esperar.

Seguindo isso, você consegue publicar seu site em poucos minutos.