O GitHub Pages hospeda gratuitamente sites estáticos (HTML, CSS, JavaScript) direto de um repositório do GitHub. É ótimo para portfólios, documentação, páginas de projetos e blogs gerados com ferramentas como Jekyll.
O que você precisa
- Uma conta gratuita no GitHub.
- Os arquivos do site, com um
index.htmlna raiz.
Passo a passo
- Crie um repositório novo no GitHub (por exemplo,
meu-site). - Envie os arquivos do site para o repositório, pelo navegador ou com Git:
git init git add . git commit -m "primeiro commit" git branch -M main git remote add origin https://github.com/SEU-USUARIO/meu-site.git git push -u origin main - No repositório, abra Settings > Pages.
- Em Source, escolha a branch
maine a pasta raiz (/) e salve. - Aguarde alguns minutos. O site ficará em
https://SEU-USUARIO.github.io/meu-site/.
Site de usuário
Se o repositório se chamar SEU-USUARIO.github.io, o site fica direto em https://SEU-USUARIO.github.io/, sem o nome do repositório no endereço.
Domínio próprio
- Em Settings > Pages, informe seu domínio em Custom domain.
- No provedor do domínio, crie um registro
CNAMEdo subdomínio (comowww) apontando paraSEU-USUARIO.github.io. Para o domínio raiz, use os registros A indicados na documentação do GitHub. - Marque Enforce HTTPS para ter certificado gratuito.
Limites e cuidados
| Ponto | Observação |
|---|---|
| Conteúdo | Apenas site estático, sem PHP ou banco de dados no servidor. |
| Tamanho | Há limites de tamanho do site e de tráfego mensal; confira a documentação atual. |
| Repositório | Em contas gratuitas, o repositório precisa ser público para usar o Pages. |
| Segredos | Nunca publique senhas ou chaves de API no repositório. |
Alternativas
Netlify, Cloudflare Pages e Vercel também oferecem hospedagem gratuita para sites estáticos, com deploy automático a cada alteração.
