Como subir seu primeiro repositório no GitHub: um guia passo a passo.
Tags: github, git, tutorial
Published: 2023-04-26 21:14:13

Fazer o deploy do seu site é uma tarefa importante para torná-lo acessível na internet e alcançar um público maior. Por isso, subir seu repositório no GitHub é uma ótima maneira de compartilhar seu projeto e torná-lo disponível para outros usuários.

Para isso, você precisa ter certeza de que o git está instalado no seu computador. 

## 1. Verificando a instalação

Você pode verificar a instalação no terminal ou [com prompt](https://tecnoblog.net/responde/7-maneiras-de-abrir-o-prompt-de-comando-no-windows-10-e-11/) de comando usando:

```
git --version
```

Caso ele não esteja instalado, você pode instalá-lo seguindo as instruções [por aqui](https://git-scm.com/book/pt-br/v2/Come%C3%A7ando-Instalando-o-Git).

## 2. Configurando o Git
 Configurar o Git é um passo importante para trabalhar com repositórios em seu computador. Felizmente, é fácil fazer isso usando alguns comandos simples no terminal. Siga as etapas abaixo para configurar suas informações de usuário:

- Abra o terminal em seu computador.

- Digite o seguinte comando para definir seu nome de usuário, substituindo "[nome]" pelo seu próprio nome:

```
git config --global user.name "[nome]"
```

- Em seguida, digite o seguinte comando para definir seu endereço de e-mail, substituindo "[endereco-de-email]" pelo seu próprio endereço de e-mail:

```
git config --global user.email "[endereco-de-email]"
```
Essa parte está pronta. Mas lembre-se de adaptar os comandos para seu caso específico.

## 3. Criando um repositório
 Para começar a usar o Git, é necessário criar um novo repositório no GitHub. Veja como fazer:

- Acesse o seu GitHub e clique em "New".

![Print da página inicial do GitHub, onde mostra o botão New em destaque](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/c2hlrhc6u22adrllycle.png)

- Preencha as informações necessárias, que é basicamente escolher um nome para o repositório e escolher se quer público ou privado, indico que deixe público mesmo  e clique em "Creat repository".


![Print da página de criar um novo repositório](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ur797ygao1n1qdefcz93.png)

- Na página do repositório recém-criado, salve o link HTTPS gerado.

![Print do link HTTPS](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/2dx2hfpp4dd2651r0pua.png)

##  4. Configurando projeto local
 Agora que você tem o link HTTPS do seu repositório, é hora de configurar seu projeto local. Estou usando o [VSCode](https://code.visualstudio.com/) para isso.

- Abra o terminal do seu projeto com o atalho `Ctrl + '` ou `Ctrl + j`.

- Inicie a pasta como um repositório do Git através do comando:
 
```
git init
```

O `git init` é um comando do Git que cria um novo repositório Git em uma pasta existente. Em outras palavras, ele prepara uma pasta para que você possa começar a usar o Git para controlar as mudanças em seus arquivos.

## 5. Adicionando arquivos
 Agora que você configurou o Git e iniciou o repositório, é hora de adicionar seus arquivos para preparar o commit. Para isso, utilize o seguinte comando no terminal do Visual Studio Code. 

```
git add .
```

## 6. Criando commit
 Em seguida, crie um commit para os arquivos que você deseja subir para o repositório. Utilize o comando:

```
 git commit -m "primeiro commit"
```

O comando `git commit -m 'primeiro commit'` é usado para salvar as mudanças que você fez no seu projeto em um registro permanente no Git. O texto dentro das aspas ("primeiro commit") é uma mensagem que você adiciona para explicar o que mudou no seu projeto desde o último commit.

O `-m` é de mensagem e ela ajuda outras pessoas a entenderem o que foi alterado e por que.

## 7. Subindo arquivos para o GitHub
 Agora, é hora de subir seus arquivos para o GitHub. Lembra do link HTTPS que geramos no passo **3**? Utilize o comando abaixo para adicionar o repositório remoto ao seu projeto local.

```
git remote add origin <link gerado> 
```
O `git remote add` é a forma de dizer para o Git qual é o repositório remoto que deve ser usado para salvar as suas mudanças. É como se você estivesse indicando ao Git onde ele deve enviar as suas alterações para que elas possam ser salvas na nuvem.

## 8. Enviando arquivos para repositório remoto
 Em seguida, utilize o comando: 

```
git push -u origin master 
```

Para enviar seus arquivos para o repositório remoto. Isso pode demorar um pouco, dependendo do tamanho dos arquivos, não se preocupe.

O `git push` é a forma de dizer ao Git que você quer enviar as suas mudanças para o repositório remoto. O `-u` significa "upstream", que é uma forma de definir o repositório remoto padrão para que você não precise digitar o nome do repositório toda vez que fizer o push.

O `origin` é o nome dado ao repositório remoto que você definiu anteriormente com o comando `git remote add`. Já o `master` é o nome da branch principal, onde geralmente estão as versões mais estáveis do seu código.

Prontinho! Agora você já pode visualizar seus arquivos no GitHub. Atualize a página do seu repositório e verá que eles estarão lá. Você pode usá-los para fazer deploy no [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) ou na [Vercel](https://vercel.com/about). Muito legal, né?

Ah! Se você quiser enviar atualizações desse seu mesmo projeto, você não precisa fazer tudo isso de novo. Você só vai precisar usar os seguintes comandos para enviar as atualizações: `git add .`, `git commit -m "mensagem do seu commit"` e `git push -u origin master`. 

É só lembrar de seguir essa ordem: adicionar as alterações, descrevê-las e enviá-las para o Github.

Espero que tenha te ajudado e comece a documentar o seu progresso no GitHub hoje mesmo. :)