Como criar um repositório GitHub

TL;DR

Criar um repositório GitHub une Git local (config, init, add, commit) à interface Novo repositório e ao push do remote. A docs oficial descreve a plataforma do planejamento até a implantação e a operação do software.

  • Por que importa: sem remote versionado, colaboração e backup do código ficam no disco de uma pessoa só.
  • Como funciona: Git versiona localmente; o GitHub hospeda o remoto e o fluxo social do projeto.
  • Na prática: na web, use Novo repositório; você pode acrescentar template, README e .gitignore e só então fazer o push.
  • Ponto de atenção: o artigo ainda exemplifica branch master e senha no push; confira se o default é main e qual auth a conta exige.
  • Conclusão: publique o remoto vazio ou com README e só então conecte o diretório local já commitado.

Sem dúvidas, o GitHub é uma das principais plataformas utilizadas por desenvolvedores e programadores web. Ele se baseia no sistema de código aberto Git para realizar o controle de versões e facilitar o trabalho em equipe durante o desenvolvimento de qualquer projeto.

Além da possibilidade de serem modificados simultaneamente por várias pessoas, os códigos hospedados por lá também podem ser facilmente clonados e duplicados de forma prática, o que permite a realização de testes sem comprometer os arquivos principais.

Se você ainda tem dúvidas sobre como criar um repositório GitHub, continue por aqui. Preparamos um tutorial prático para que você comece a utilizar essa incrível plataforma nos seus projetos hoje mesmo!

Neste post 5

Baixando e configurando o Git

O GitHub é uma plataforma que depende do sistema Git para fazer sua mágica. Por meio dele, você será capaz de criar repositórios e modificar seus arquivos utilizando o terminal de comando, o que garante mais agilidade no gerenciamento dos arquivos.

Por isso, o primeiro passo é baixar a ferramenta do site oficial e fazer a sua instalação. Feito isso, será preciso configurar seus dados de usuário para identificar seus commits, que são as modificações realizadas por cada usuário. Para definir seu nome, digite na linha de comando:

$ git config --global user.name "Nome"

Depois, informe seu e-mail com o seguinte comando:

$ git config --global user.email "[email protected]"

A partir desse ponto, você estará pronto para gerenciar o desenvolvimento de seus projetos por meio do sistema Git de forma local.

Criando um repositório local

Com a linha de comando do Git aberta, é preciso informar o diretório em que estão os arquivos que serão gerenciados em um repositório. Isso é feito utilizando o comando ‘cd’ antes do caminho completo. Fica mais ou menos assim:

$ cd c:/Pasta do projeto

Se estiver tudo certo, o caminho informado aparecerá na linha seguinte à frente da sua identificação de equipamento e usuário. Aí, bastará digitar o comando ‘git init’ para iniciar um novo repositório local no diretório selecionado.

Muita gente se perde nesse momento, especialmente se não tem costume com o terminal. Não é vergonha nenhuma: terminal intimida mesmo, principalmente nas primeiras vezes. Se preferir, dá para usar interfaces gráficas para Git, tipo o GitHub Desktop ou até plugins nos editores de código mais famosos, como VS Code. A coisa funciona igualzinha por baixo dos panos; o que muda mesmo é o caminho que você vai trilhar até ali. Se cometer algum erro, não se estresse, quase tudo tem como desfazer, e ninguém nasce sabendo mesmo.

$ git init

Adicionando arquivos ao novo repositório

Após ter criado seu novo repositório local, você deverá adicionar a ele os arquivos contidos na pasta escolhida, já que isso não acontece de forma automática. Para adicionar individualmente, o comando a ser utilizado é o ‘git add’. Veja um exemplo:

$ git add index.html

Também é possível adicionar todos os arquivos contidos no diretório de uma vez com os comandos ‘git add -A’ e ‘git add .’. O primeiro deles atualiza todo o repositório, inclusive eliminando arquivos que tiverem sido excluídos no diretório. Já a segunda opção adiciona apenas os arquivos que de fato foram modificados, sem remover os demais.

Para efetivar essas alterações, digite o comando ‘git commit’, que ainda aceita uma descrição para facilitar consultas futuras.

$ git commit 'Comentário do commit'

A partir de agora, vamos mostrar como criar um repositório no GitHub e enviar o seu projeto local para a plataforma.

Criando um repositório no GitHub

Após se cadastrar e fazer login em sua conta no GitHub, procure pela opção “New repository”. Ela pode ser encontrada na barra lateral esquerda do site ou no ícone “+” que fica na barra superior.

Na tela seguinte, você definirá as principais informações sobre o seu novo repositório GitHub. A primeira delas será o seu nome, que será utilizado por quem quiser acessar os seus arquivos na plataforma. Por isso, o ideal é que ele seja curto, objetivo e fácil de ser lembrado. O nome final não pode conter espaços e caracteres especiais, que são substituídos automaticamente caso utilizados.

Mais uma dica para essa etapa do cadastro do repositório: preste atenção no campo de licenças. Às vezes a gente pula essa parte, achando que não faz diferença, mas acaba fazendo sim. Se você já sabe se seu projeto é open source, ou se quer restringir só pra você ou sua equipe, escolha uma licença adequada ali. Evita dor de cabeça depois. E a descrição? Não precisa ser um romance, mas uma frase honesta já ajuda bastante quem for esbarrar no seu repositório por aí.

Logo abaixo é possível inserir uma descrição para seu novo repositório, o que ajudará tanto na sua própria organização quanto a orientar os interessados em visualizar seus projetos.

Prosseguindo, será preciso escolher se o repositório será público ou privado. Os repositórios públicos podem ser visualizados por qualquer pessoa, mas o proprietário pode definir quem realizará os commits. Já os privados podem ter seu acesso restrito apenas para as pessoas autorizadas pelo administrador.

Conectando o Git ao Github

Após a criação, a tela seguinte fornecerá as informações necessárias para configurar o repositório criado no GitHub com o seu projeto local. No prompt de comando, digite os seguintes comandos para realizar esse processo:

$ git remote add origin https://github.com/username/repositorio.git
$ git push -u origin master

Ao inserir o segundo comando, uma caixa de diálogo do GitHub se abrirá para que seja feita a autenticação, com o nome de usuário e a senha cadastradas na plataforma.

Finalmente, acesse o seu repositório no GitHub para encontrar por lá os mesmos arquivos que você tem em sua pasta local gerenciada pelo Git. Mais fácil do que você imaginava, não é mesmo?

Saber como criar um repositório GitHub é praticamente um requisito para quem pretende trabalhar com o desenvolvimento web, especialmente para projetos em equipe. Além disso, a plataforma serve como uma verdadeira rede social para profissionais e entusiastas da área, o que certamente pode contribuir bastante para o desenvolvimento de suas habilidades.

Perguntas frequentes

Qual a diferença entre Git e GitHub nesse fluxo?

O artigo trata o Git como sistema de controle de versão local e o GitHub como plataforma que hospeda o remoto e facilita trabalho em equipe. A documentação oficial define o GitHub como plataforma para todo o ciclo de desenvolvimento de software. Você versiona com Git; cria e compartilha o repositório remoto no GitHub.

Repositório público ou privado: o que mudar na criação?

No artigo, públicos podem ser vistos por qualquer pessoa, com commits controlados pelo dono; privados ficam restritos a quem o administrador autorizar. Na interface oficial você escolhe a visibilidade ao criar o repositório. Escolha público para open source visível; privado para código restrito à equipe.

Preciso criar o repositório local antes do GitHub?

O tutorial ensina os dois lados: git init, add e commit no diretório local, depois New repository na web e git remote add origin + push. A documentação também permite criar só na interface e clonar depois. Se o código já existe na pasta, finalize o commit local antes do primeiro push.

O que configurar além do nome do repositório?

O artigo pede nome curto sem espaços, descrição útil e escolha de licença quando o projeto for open source. A docs do GitHub acrescenta README, .gitignore e uso opcional de template. Preencher README e ignore na criação evita commit inicial vazio e reduz arquivo sensível indo para o remoto.

MM Matt Montenegro