Neste artigo
- Git, GitHub e repositório: os três nomes que você precisa entender
- Por que guardar o site no GitHub
- Passo a passo: do repositório vazio ao primeiro commit
- Como organizar o repositório de um site HTML
- Branches: mexer no site sem quebrar o que está no ar
- Como o GitHub conversa com a Cloudflare
- Público ou privado: o que muda para publicar
- Erros comuns de quem começa
- Em outros Mundos
Git, GitHub e repositório: os três nomes que você precisa entender
A documentação oficial do GitHub define o Git como um sistema de controle de versão que acompanha as mudanças em arquivos. Ele roda no seu computador. O GitHub é a plataforma que guarda esses projetos na nuvem e soma ferramentas de colaboração.
Repositório é a pasta do projeto. Segundo a página "About repositories", ele contém o código, os arquivos e o histórico de revisão de cada arquivo. Para um site, isso quer dizer que cada versão da sua página inicial fica guardada.
Commit é um ponto salvo nesse histórico. Você muda três arquivos, escreve uma mensagem como "troca o telefone do rodapé" e registra. Se algo quebrar amanhã, você sabe exatamente o que mudou e quando.
| Termo | O que é | Exemplo em um site |
|---|---|---|
| Git | Sistema que registra mudanças nos arquivos | Guarda cada versão do index.html |
| GitHub | Serviço que hospeda os projetos Git na nuvem | Onde o código do site fica salvo |
| Repositório | Pasta do projeto com histórico | O repositório "site-padaria" |
| Commit | Registro de um conjunto de mudanças | "Atualiza horário de atendimento" |
| Branch | Linha paralela de trabalho | Branch "nova-pagina-servicos" |
| Deploy | Colocar uma versão no ar | A Cloudflare publica após o commit |
Para ver a resposta sobre outros temas do dia a dia, a home do MundoBlá reúne todos os Mundos.
Por que guardar o site no GitHub
Quem edita site direto no servidor, por FTP, perde o histórico. Se você apagar um trecho por engano, não existe botão de voltar. Com o GitHub, cada mudança fica registrada com autor e data.
O segundo ganho é a publicação automática. A documentação da Cloudflare explica que cada envio ao repositório conectado dispara um build e um deploy. Você não copia arquivo para lugar nenhum: o commit já é a publicação.
O terceiro é a independência. O código é seu, fica em um repositório que você controla e pode ser levado para outro serviço quando quiser. Você não fica preso a um construtor nem a um painel de plugin.
| Situação | Sem GitHub | Com GitHub |
|---|---|---|
| Apagou algo por engano | Refaz de memória | Volta ao commit anterior |
| Duas pessoas editam | Uma sobrescreve a outra | Cada uma trabalha em uma branch |
| Publicar uma mudança | Envia por FTP, arquivo por arquivo | O commit dispara o deploy |
| Trocar de hospedagem | Baixa tudo do servidor antigo | Conecta o repositório ao novo serviço |
| Saber quem mudou o quê | Não tem registro | Histórico com autor e data |
Passo a passo: do repositório vazio ao primeiro commit
O caminho abaixo usa o site do GitHub e o Git no computador. Se você prefere não usar terminal, o GitHub Desktop faz as mesmas etapas com botões.
- Crie uma conta no GitHub, se ainda não tiver.
- Abra o menu "+" no canto da tela e escolha "New repository", como mostra a documentação do GitHub.
- Dê um nome curto ao repositório, como "site-minha-empresa", e escolha a visibilidade: público ou privado.
- Marque "Add README" para o repositório já nascer com um arquivo e clique em "Create repository".
- Copie o endereço do repositório e clone no seu computador.
- Coloque dentro da pasta o index.html e os demais arquivos do site.
- Registre as mudanças com um commit e envie para o GitHub com o comando push.
No terminal, os passos 5 a 7 ficam assim:
git clone https://github.com/seu-usuario/site-minha-empresa.git
cd site-minha-empresa
git add .
git commit -m "Primeira versão do site"
git push
Push é o envio dos commits do seu computador para o GitHub. Depois dele, o código está seguro na nuvem e pronto para ser conectado à publicação.
Como organizar o repositório de um site HTML
Um repositório organizado poupa tempo em toda manutenção. A regra prática é separar o que é página, o que é estilo, o que é script e o que é imagem.
<!-- Estrutura sugerida de pastas
site-minha-empresa/
index.html
contato.html
servicos.html
css/estilo.css
js/menu.js
img/logo.webp
README.md
.gitignore
-->
O arquivo README.md explica o projeto para quem chegar depois: o que é o site, como rodar e onde ele é publicado. O .gitignore lista o que nunca deve subir, como arquivos de senha e pastas temporárias.
| Pasta ou arquivo | Para que serve | Cuidado |
|---|---|---|
| index.html | Página inicial | Precisa estar na raiz da pasta publicada |
| css/ | Folhas de estilo | Um arquivo principal costuma bastar |
| js/ | Scripts | Evite biblioteca que você não usa |
| img/ | Imagens | Otimize antes do commit |
| README.md | Explicação do projeto | Atualize quando mudar a publicação |
| .gitignore | Lista do que não sobe | Inclua .env antes do primeiro commit |
Se o site usa um gerador como o Eleventy, a estrutura muda um pouco: o código-fonte fica em uma pasta e o resultado do build em outra. O guia de geradores de sites estáticos mostra essa organização.
Branches: mexer no site sem quebrar o que está no ar
A branch principal, chamada main na maioria dos projetos, é a que vai para produção. Tudo que entra nela vira o site oficial depois do deploy.
Para mudanças maiores, crie uma branch nova. Você monta a página de serviços nela, revisa com calma e só depois junta com a main. Na Cloudflare Pages, a documentação diz que envios para branches que não são a de produção geram deploys de prévia. Você recebe um link separado para conferir antes.
Esse fluxo evita o erro clássico de publicar uma página pela metade. Também permite mostrar a novidade para o dono do negócio antes de ela ir ao ar.
Como o GitHub conversa com a Cloudflare
A ligação é feita uma vez, no painel da Cloudflare, em "Workers & Pages". Você escolhe "Connect to Git", autoriza o GitHub e seleciona o repositório. A Cloudflare aceita repositório público e privado.
Depois disso, você informa a branch de produção, o comando de build e a pasta de saída. Em um site HTML puro sem gerador, o comando de build fica em branco. O passo a passo completo está no guia de Cloudflare Pages.
Quem ainda está escolhendo onde publicar pode ver a comparação entre GitHub Pages ou Cloudflare Pages. A resposta curta sobre o Mundo Criação de Sites está na página principal do Mundo, com todos os guias.
Público ou privado: o que muda para publicar
O GitHub Free permite repositórios públicos e privados, com recursos limitados nos privados, segundo a página oficial sobre repositórios. Para guardar o código, os dois funcionam.
A diferença aparece na hora de publicar. A documentação do GitHub Pages diz que, se a conta dona do repositório usa GitHub Free, o repositório precisa ser público para o Pages funcionar. Na Cloudflare Pages, o repositório privado é aceito, segundo a documentação de integração com Git.
Para site de empresa, o privado costuma ser mais confortável: ninguém de fora vê rascunhos e configurações. A resposta completa sobre os limites de cada serviço está no comparativo.
Erros comuns de quem começa
- Subir arquivo com senha, token ou chave de API. O histórico guarda tudo, mesmo o que foi apagado depois.
- Escrever mensagem de commit vaga, como "ajustes". Daqui a três meses ninguém sabe o que mudou.
- Fazer toda mudança direto na main. Qualquer engano vai ao ar na hora.
- Enviar imagem sem otimizar. O repositório incha e o site fica lento.
- Não ter README. Quem assumir o projeto depois perde tempo descobrindo como ele funciona.
Se você não quer lidar com nada disso, existe o caminho mais curto. A criação do site não é cobrada quando você contrata uma hospedagem de sites da HostGator em ciclo anual pelo link do MundoBlá e chama no WhatsApp. O site é feito em HTML puro, com o código guardado no GitHub. A gente ganha uma comissão da HostGator quando você contrata pelo link, sem custo extra para você. Hospedagem e domínio você paga direto à HostGator, e o escopo do site é combinado no WhatsApp antes de começar.
Para entender o conceito inteiro antes de decidir, volte ao guia de criar sites sem WordPress. Depois de publicar, o próximo passo é configurar o domínio na Cloudflare.
Em outros Mundos
Para entender o que acontece entre o navegador e o servidor quando alguém abre o seu site, veja como funciona a internet. Quem quer ir além do HTML encontra mais conteúdo no Mundo Programação.
Perguntas frequentes
O que é o GitHub?
O GitHub é uma plataforma que guarda projetos Git na nuvem e soma ferramentas de colaboração, segundo a documentação oficial. Para quem cria site, ele vira o cofre do código e o histórico de cada mudança. Ele não substitui a hospedagem: para o site ir ao ar, você liga o repositório a um serviço como a Cloudflare.
Qual a diferença entre Git e GitHub?
Git é o sistema que registra as mudanças nos arquivos, e GitHub é o serviço que guarda esses projetos na internet. O Git roda no seu computador, mesmo sem conexão. Você pode usar o Git sem o GitHub, mas aí perde a cópia na nuvem e a integração automática com a Cloudflare.
O que é um repositório?
Repositório é a pasta do projeto com todos os arquivos e o histórico de revisão de cada um, como define a documentação do GitHub. Um site costuma ter um repositório só. Se você tiver dois sites, o mais organizado é criar dois repositórios separados, cada um ligado ao próprio projeto de publicação.
O que é um commit?
Commit é um registro salvo de um conjunto de mudanças, com data, autor e uma mensagem curta. Ele permite voltar a uma versão anterior se algo quebrar. A exceção é quando você esquece de dar commit: mudança que ficou só no seu computador não está protegida no histórico do GitHub.
O que é uma branch?
Branch é uma linha paralela de trabalho dentro do mesmo repositório, onde você muda o site sem mexer na versão principal. Ela serve para testar um layout ou uma página nova com calma. Na Cloudflare Pages, o envio para uma branch que não é a de produção gera um link de prévia separado.
Preciso saber programar para usar o GitHub?
Não precisa saber programar para usar o básico do GitHub em um site HTML. Criar repositório, enviar arquivos e escrever a mensagem do commit dá para fazer pelo navegador. Para trabalhar com branches, terminal e conflitos de código, o aprendizado é maior, e vale começar por um projeto pequeno.
Dá para criar um repositório sem instalar nada?
Sim, você cria o repositório e envia arquivos direto pelo site do GitHub, no navegador. Para um site pequeno, isso basta no começo. Quando o projeto cresce, instalar o Git ou o GitHub Desktop no computador facilita, porque você edita um grupo de arquivos de uma vez e envia tudo em um commit só.
O GitHub é grátis para guardar o código do site?
O plano GitHub Free permite repositórios públicos e privados, com recursos limitados nos privados, segundo a página oficial sobre repositórios. Para o código de um site HTML, isso costuma bastar. A exceção é publicar pelo GitHub Pages com repositório privado, que pede plano pago na conta dona do projeto.
Meu repositório deve ser público ou privado?
Para um site de empresa, o repositório privado costuma ser a escolha mais tranquila. Ele esconde rascunhos, configurações e histórico de quem não faz parte do projeto. A Cloudflare Pages aceita repositório privado, então você não precisa abrir o código para publicar o site.
Como o GitHub publica o site na Cloudflare?
Você conecta o repositório à Cloudflare Pages uma vez, e cada envio dispara um build e um deploy automáticos, segundo a documentação da Cloudflare. Envio para a branch de produção atualiza o site oficial. Envio para outra branch cria uma prévia, útil para revisar antes de publicar.
O que é deploy?
Deploy é o ato de colocar uma versão do site no ar, copiando os arquivos para o servidor que atende os visitantes. Com GitHub e Cloudflare, ele acontece sozinho a cada commit enviado. Se o build falhar, a versão anterior continua no ar até você corrigir o erro.
Posso guardar senha ou chave de API no repositório?
Não guarde senha, token ou chave de API em arquivo do repositório, nem em projeto privado. O histórico do Git mantém tudo que já entrou, mesmo depois de apagado. Use as variáveis de ambiente do serviço de publicação e liste arquivos como .env no .gitignore antes do primeiro commit.
Como volto o site para uma versão anterior?
Você pode reverter o commit que causou o problema e enviar de novo, e o deploy publica a versão corrigida. A Cloudflare Pages também mostra a lista de deploys anteriores no painel do projeto. Antes de reverter, confira se o erro não está em configuração do painel, e não no código.
GitHub serve para site em WordPress?
O GitHub foi pensado para código e arquivos, e funciona melhor com site estático em HTML, CSS e JavaScript. O WordPress guarda conteúdo em banco de dados, que não fica no repositório. Dá para versionar tema e plugin próprios, mas o conteúdo do WordPress continua fora do GitHub.
Qual o erro mais comum de quem começa no GitHub?
O erro mais comum é enviar tudo para a branch principal sem revisar, o que publica na hora qualquer engano. Outro é escrever mensagens de commit vagas, que atrapalham achar a mudança certa depois. Criar uma branch para cada mudança grande costuma evitar os dois problemas.
O GitHub tem limite de tamanho para o site?
O GitHub publica limites próprios para o GitHub Pages, como a recomendação de até 1 GB no repositório de origem. Um site HTML de empresa costuma ficar bem abaixo disso. Fotos e vídeos pesados são o que mais incha o projeto, então otimize as imagens antes de enviar.
Quem cria meu site grátis usa o GitHub?
Sim, na oferta do MundoBlá o site é feito em HTML puro e o código fica guardado no GitHub. A condição é contratar uma hospedagem de sites da HostGator em ciclo anual pelo link do MundoBlá. Onde o site é publicado e o escopo do projeto são combinados no WhatsApp.
Fontes e data de verificação
GitHub Docs: About GitHub and Git, GitHub Docs: About repositories, GitHub Docs: Creating a GitHub Pages site, Cloudflare Docs: Pages, Git integration. Conferido em 5 de novembro de 2026.Referências
- GitHub Docs: About GitHub and Git. Disponível em: https://docs.github.com/en/get-started/start-your-journey/about-github-and-git.
- GitHub Docs: About repositories. Disponível em: https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories.
- GitHub Docs: Creating a GitHub Pages site. Disponível em: https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site.
- Cloudflare Docs: Pages, Git integration. Disponível em: https://developers.cloudflare.com/pages/get-started/git-integration/.
Fontes conferidas em 05 de novembro de 2026.