Neste artigo
- O que você precisa antes de subir um projeto no GitHub?
- Passo 1: crie o repositório no GitHub
- Passo 2: inicialize o Git na pasta do projeto
- Passo 3: prepare os arquivos e faça o primeiro commit
- Passo 4: conecte o repositório local ao remoto
- Passo 5: envie o projeto com git push
- Passo 6: suba atualizações sem repetir a configuração
- Quais comandos resumem como subir um projeto no GitHub?
- Dá para subir projeto no GitHub sem usar o terminal?
- Por que publicar seus projetos no GitHub?
- Posso subir um projeto no GitHub sem instalar o Git?
- O GitHub é gratuito?
- Por que o comando usa main e não master?
- O que colocar no .gitignore?
- Como subir uma atualização no GitHub?
Subir um projeto no GitHub pelo terminal depende de quatro comandos: git init, git add, git commit e git push. O caminho completo tem seis passos, do momento em que você cria o repositório no site até o primeiro envio dos arquivos. Se a sua base de versionamento ainda está fraca, comece medindo o terreno neste quiz de Git e GitHub para iniciantes.
O processo funciona igual para qualquer linguagem: um site em HTML, uma API em Python ou o trabalho da faculdade. O que muda é o conteúdo da pasta, nunca a sequência. O fluxo abaixo segue a orientação da documentação oficial do GitHub para código que está na sua máquina e ainda não tem versionamento.
O que você precisa antes de subir um projeto no GitHub?
Três coisas: conta no GitHub, Git instalado na máquina e seus dados de autoria configurados. A instalação do Git varia por sistema operacional e está coberta no site oficial do Git. Depois de instalar, registre o nome e o e-mail que vão aparecer em cada commit:
git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"Passo 1: crie o repositório no GitHub
Com login feito em github.com, clique no sinal de mais no canto superior direito e escolha "New repository". Dê um nome descritivo ao projeto, defina se ele será público ou privado e não marque as opções de README, licença ou .gitignore. A documentação do GitHub orienta criar o repositório vazio justamente para evitar conflito entre o que existe no site e o que existe na sua pasta local. Esses arquivos podem ser adicionados depois do push.
Passo 2: inicialize o Git na pasta do projeto
No terminal, entre na pasta do projeto e transforme ela em um repositório:
cd /caminho/do/seu/projeto
git init -b mainA flag -b main define o nome da branch inicial no mesmo comando. A documentação do GitHub usa main como padrão e avisa que essa sintaxe exige Git 2.28.0 ou mais recente. Se a sua versão for anterior, rode git init simples e ajuste o nome da branch antes do push, como os próprios docs indicam para versões antigas.
Passo 3: prepare os arquivos e faça o primeiro commit
Antes de mandar tudo, separe o que não deve ir para o GitHub: senhas, chaves de API e arquivos gerados automaticamente ficam no .gitignore. O aviso da documentação é direto: nunca adicione, commite ou envie informações sensíveis para um repositório remoto. Com a lista pronta, prepare e grave a primeira versão:
git status
git add .
git commit -m "primeiro commit"O git status mostra o que mudou na pasta. O git add . prepara todos os arquivos de uma vez, e o commit grava essa versão no histórico local. Se preferir ir com calma, adicione arquivo por arquivo com git add nome-do-arquivo e revise o status entre cada etapa.
Passo 4: conecte o repositório local ao remoto
Volte à página do repositório no GitHub, clique em "Code" e copie a URL. Registre ela como destino do seu projeto:
git remote add origin https://github.com/seu-usuario/seu-repositorio.git
git remote -vO origin é apenas o apelido do endereço remoto, um nome que o Git adotou por convenção. O git remote -v confirma se a URL foi registrada direitinho, o que evita a clássica surpresa do push indo para o lugar errado.
Passo 5: envie o projeto com git push
git push -u origin mainO push transfere seus commits para o GitHub. A flag -u grava a relação entre a branch local e a remota, então nos próximos envios um git push simples resolve. Se a sua branch se chamar de outra forma, substitua main pelo nome real no comando, recomendação que a própria documentação repete.
Passo 6: suba atualizações sem repetir a configuração
Depois do primeiro envio, atualizar o projeto vira um ciclo curto de três comandos:
git add .
git commit -m "ajusta validação do formulário"
git pushCada alteração segue esse caminho, sempre com uma mensagem que descreva o que mudou. Commits frequentes e mensagens claras contam a história do projeto e ajudam quem for ler o repositório depois, inclusive você daqui a seis meses.
Quais comandos resumem como subir um projeto no GitHub?
Para consulta rápida, esta é a sequência completa de um projeto que sai da sua pasta para o GitHub pela primeira vez:
| Etapa | Comando |
|---|---|
| Iniciar o repositório | git init -b main |
| Ver o que mudou | git status |
| Preparar arquivos | git add . |
| Gravar versão | git commit -m "mensagem" |
| Conectar ao remoto | git remote add origin URL |
| Enviar pela primeira vez | git push -u origin main |
| Atualizar depois | git add ., git commit, git push |
Dá para subir projeto no GitHub sem usar o terminal?
Dá. A documentação oficial lista duas alternativas. A primeira é o GitHub CLI: com a ferramenta instalada, um comando cria o repositório remoto, conecta o local e envia os arquivos:
gh repo create --source=. --publicA segunda é o GitHub Desktop, recomendado para quem prefere interface gráfica de apontar e clicar. Nos dois casos, a lógica é a mesma do terminal: iniciar, commitar e publicar. O que muda é quem digita os comandos.
💡 Dica: se o push pedir credenciais, o GitHub não aceita mais a senha da conta em operações Git. A documentação orienta usar um token de acesso pessoal ou o gerenciador de credenciais do próprio Git.
A referência completa deste fluxo, com as variações para quem usa GitHub CLI ou GitHub Desktop, está na página oficial Adding locally hosted code to GitHub dos GitHub Docs. Guardar o endereço salva tempo quando um passo sair do esperado.
Por que publicar seus projetos no GitHub?
Porque repositório é vitrine. Quem contrata dev iniciante olha código publicado antes de olhar certificado, e um perfil com projetos organizados sustenta tanto o currículo quanto a entrevista. Um portfólio dev que impressiona quase sempre nasce de uma conta do GitHub bem cuidada, e saber destacar um projeto no portfólio vale tanto quanto saber commitar.
Se faltam projetos para publicar, há uma lista de 10 projetos simples para treinar programação por onde começar. E se você programa no Visual Studio Code, o painel Source Control executa esse mesmo ciclo de add, commit e push pela interface, sem tocar no terminal. O tutorial de como usar o Visual Studio Code para começar a programar mostra o caminho.
Perguntas frequentes
Posso subir um projeto no GitHub sem instalar o Git?
Para testar, sim: em um repositório já criado, o próprio site permite criar arquivos e enviar arquivos pelo navegador. Para um projeto real, o terminal, o GitHub CLI ou o GitHub Desktop são bem mais práticos, porque o versionamento completo acontece na sua máquina.
O GitHub é gratuito?
A criação de conta e de repositórios públicos é gratuita. Recursos extras de times e empresas ficam em planos pagos, mas nada do fluxo deste tutorial depende de pagamento.
Por que o comando usa main e não master?
A documentação oficial do GitHub adota main como nome de branch inicial em todos os exemplos. Se o seu repositório local usa outro nome, a orientação é substituir main nos comandos de push pelo nome real da sua branch.
O que colocar no .gitignore?
Tudo que não precisa (ou não pode) ir para o repositório: senhas, chaves de API, arquivos de configuração pessoal, dependências baixadas e arquivos gerados pela execução do programa. O aviso da documentação do GitHub é inegociável: informação sensível nunca vai para um repositório remoto.
Como subir uma atualização no GitHub?
Repita o ciclo básico dentro da pasta do projeto: git add . para preparar as mudanças, git commit -m "mensagem" para gravar e git push para enviar. A configuração do remoto foi feita no primeiro envio, então ela não se repete.