Você tem uma ideia, um portfólio, um projeto pequeno ou até um currículo online que quer mostrar para o mundo, mas trava na hora de pensar em hospedagem, domínio, servidor e todo aquele vocabulário que parece coisa de outro planeta. A boa notícia: existe um jeito de colocar um site no ar, de graça, sem pagar um centavo de mensalidade, usando uma ferramenta chamada GitHub Pages. E não, você não precisa ser programador para isso.
Esse guia foi feito para quem quer dar o primeiro passo sem enlouquecer. Vamos devagar, com exemplos reais e zero suposição de que você já sabe o que é "repositório" ou "commit". Se você sabe usar e-mail e já fez upload de arquivo alguma vez na vida, você consegue fazer isso.
🚀 O seu site trabalha por você ou te dá trabalho?
Site profissional, rápido e que converte de verdade.
Fale conosco →O que é o GitHub Pages e por que funciona para iniciantes
O GitHub é um site onde desenvolvedores guardam e compartilham os arquivos dos seus projetos, como uma espécie de Google Drive específico para código. O GitHub Pages é um recurso dentro desse site que transforma esses arquivos em um site de verdade, acessível por qualquer pessoa com um link na internet.
A grande vantagem é que o serviço é gratuito para sites pessoais e de projetos. Você ganha até um endereço no formato seuusuario.github.io, que já parece um site de verdade. Não é um link temporário nem uma pré-visualização: é uma página pública, estável, que funciona no celular, no computador e aparece no Google se você quiser.
Tem uma limitação importante para saber desde o início: o GitHub Pages funciona melhor para sites estáticos. Em linguagem humana, isso significa sites que mostram informações sem precisar de um banco de dados por trás, sem login de usuário, sem sistema de pedidos. Pense em portfólio, currículo online, página de apresentação de um projeto, blog simples ou página de um evento. Para isso, ele é perfeito.
Antes de começar: o que você vai precisar
Não precisa instalar nada no computador para esta versão mais simples. Tudo acontece pelo navegador. Separe apenas três coisas:
- Um e-mail válido para criar sua conta no GitHub.
- Os arquivos do seu site: ao menos um arquivo chamado
index.html. Se você não tem isso ainda, calma, a gente explica logo abaixo. - Paciência de uns 15 minutos na primeira vez. Depois que você entende o fluxo, leva menos de 5 minutos.
Se você ainda não tem os arquivos do site, a forma mais fácil é usar um editor online como o CodePen ou pegar um template gratuito em sites como o HTML5 UP (html5up.net). Esses templates já vêm prontos, com visual bonito, e você só troca os textos e fotos pelos seus. Baixe o arquivo ZIP, extraia na sua pasta e você já tem o que precisa.
Criando sua conta e seu primeiro repositório
Acesse github.com e clique em "Sign up" (criar conta). Preencha e-mail, senha e escolha um nome de usuário. Esse nome vai fazer parte do endereço do seu site, então escolha algo que faça sentido, preferencialmente seu nome ou o nome do seu projeto, sem espaços e sem caracteres especiais.
Com a conta criada e o e-mail confirmado, você vai criar um repositório. Repositório é só o nome que o GitHub dá para uma pasta onde ficam os arquivos de um projeto. Para criar o repositório certo para o GitHub Pages, siga estes passos:
- Clique no botão "New" (ou no símbolo de "+") no canto superior direito.
- No campo "Repository name", escreva exatamente: seuusuario.github.io (substituindo "seuusuario" pelo seu nome de usuário real no GitHub).
- Marque a opção "Public" (público). Repositórios privados no plano gratuito não funcionam com o GitHub Pages.
- Clique em "Create repository".
Esse nome específico é o segredo. O GitHub reconhece automaticamente que um repositório com esse formato é um site pessoal e já prepara tudo para publicar. Se você colocar qualquer outro nome, o processo muda um pouco, mas ainda funciona. Por enquanto, vamos com esse caminho mais direto.
Fazendo o upload dos arquivos do seu site
Agora você está dentro do repositório recém-criado. A tela parece vazia, com algumas instruções em inglês. Não se assuste. Procure o link que diz "uploading an existing file" (enviando um arquivo existente). Clique nele.
Você vai ver uma área onde pode arrastar os arquivos diretamente do seu computador para o navegador, igualzinho a como você anexa foto num e-mail. Selecione todos os arquivos do seu site: o index.html, as pastas de imagens, os arquivos de estilo visual (normalmente chamados de .css) e tudo mais que faça parte do seu projeto. Não coloque dentro de uma pasta extra: os arquivos têm que ir soltos ali, na raiz do repositório.
Depois do upload, desça a página e encontre o botão verde que diz "Commit changes". Pense no "commit" como o botão de salvar definitivo. Pode deixar a mensagem que já vem preenchida ou escrever algo simples como "Primeiro upload do site". Clique em "Commit changes" e pronto.
E se eu tiver muitos arquivos?
Se o seu template tem muitas pastas e subpastas, o upload pelo navegador pode ser chato. Nesse caso, a alternativa mais fácil é compactar tudo em um ZIP, extrair localmente e arrastar tudo de uma vez para a área de upload do GitHub. O navegador aceita múltiplos arquivos ao mesmo tempo. Só não envie o ZIP em si, mande os arquivos extraídos.
Ativando o GitHub Pages e acessando seu site
Se você usou o nome de repositório exato (seuusuario.github.io), o GitHub Pages já está ativado automaticamente. Mas é bom confirmar. Clique na aba "Settings" (Configurações) dentro do repositório, depois no menu lateral em "Pages".
Você vai ver uma mensagem informando que o site está sendo publicado, com o endereço já aparecendo. Algo como: "Your site is live at https://seuusuario.github.io". Pode demorar de 1 a 3 minutos para o site aparecer de verdade quando você acessar o link. Se ainda não estiver no ar, espere um pouco e atualize a página.
Acesse o link no seu celular, mande para um amigo, coloque no currículo. O site já é público e funciona para qualquer pessoa no mundo.
O site abriu uma tela em branco ou deu erro 404, o que fazer?
O erro 404 geralmente significa que o arquivo principal não foi encontrado. Confira duas coisas: primeiro, se o arquivo principal do seu site se chama exatamente index.html (com esse nome, minúsculo, sem espaço). Segundo, se esse arquivo está na raiz do repositório, e não dentro de uma pasta. Se estiver dentro de uma pasta chamada "meusite", por exemplo, o GitHub não vai encontrá-lo automaticamente. Mova o arquivo para fora da pasta e faça um novo commit.
Como atualizar o site quando você quiser mudar algo
A vida não é estática, e seu site também não precisa ser. Quando quiser atualizar um texto, trocar uma foto ou adicionar uma seção nova, o processo é o mesmo do upload inicial.
Acesse seu repositório no GitHub, clique no arquivo que você quer editar. Se for um arquivo .html, o GitHub tem um editor próprio: clique no ícone de lápis no canto superior direito do arquivo. Faça as alterações direto no navegador e clique em "Commit changes". Em alguns minutos, o site já vai refletir a mudança.
Se a edição for em imagens ou arquivos mais complexos, volte à área de upload e envie a versão nova do arquivo. O GitHub substitui o arquivo antigo pelo novo automaticamente quando têm o mesmo nome.
Posso usar um domínio próprio, tipo meusite.com.br?
Sim, e não é complicado. Se você comprar um domínio num serviço como o Registro.br ou a Hostinger, pode conectá-lo ao seu GitHub Pages nas configurações da seção "Pages". O campo se chama "Custom domain". Você vai precisar apontar o domínio para os servidores do GitHub, seguindo as instruções que aparecem ali mesmo. O GitHub até oferece HTTPS gratuito, aquele cadeado de segurança que aparece no navegador. Mas isso já é um passo além: para começar, o endereço github.io já resolve muito bem.
O que você pode fazer a partir daqui
Ter um site no ar muda a forma como você se apresenta profissionalmente. Um link real, com seu nome, que você pode colocar no LinkedIn, no WhatsApp Business ou no rodapé do seu e-mail, pesa diferente do que um PDF ou uma pasta do Google Drive.
Se você quiser ir além do template baixado pronto, vale explorar o Notion com integração ao GitHub, ou ferramentas como o Jekyll, que o próprio GitHub Pages já suporta e permite criar blogs com posts sem precisar editar HTML na mão toda vez. Mas isso é próxima etapa.
Por agora, o essencial está feito: conta criada, repositório com o nome certo, arquivos enviados, site no ar. Anota o link, manda para alguém de confiança revisar no celular e já considera isso um feito real. Colocar um projeto no ar, mesmo que simples, é o primeiro passo de quem aprende fazendo.
