O Git Desktop (oficialmente GitHub Desktop) é uma ferramenta gráfica que simplifica o uso do Git, tornando-o mais acessível para quem prefere uma interface visual ao invés da linha de comando. Ele automatiza muitos comandos Git comuns e fornece uma visão clara do estado do seu repositório.

Este manual vai guiá-lo pelos passos essenciais para usar o GitHub Desktop no seu dia a dia.

1. Instalação e Configuração Inicial 📥

Instalando e configurando o Github Desktop:

1. Baixe o GitHub Desktop:
   • Acesse o site oficial: desktop.github.com
   • Clique no botão "Download for macOS" ou "Download for Windows".
2. Instale o aplicativo:
   • Siga as instruções do instalador. É um processo direto.
3. Configuração Inicial:
   • Ao abrir o GitHub Desktop pela primeira vez, ele pedirá para você fazer login na sua conta do GitHub. Isso é altamente recomendado, pois facilita a interação com repositórios remotos.
   • Ele também pedirá para configurar seu nome de usuário e e-mail (as mesmas informações que você configuraria com git config --global). Isso é crucial para identificar seus commits.

2. Adicionando Repositórios 📂

Você pode adicionar repositórios de três maneiras principais:

2.1. Criar um Novo Repositório Local 👋

Para iniciar um novo projeto do zero:

1. No menu superior, clique em File > New Repository...
2. Name: Dê um nome ao seu repositório (ex: meu-primeiro-projeto-desktop).
3. Local path: Escolha a pasta onde o repositório será salvo em seu computador.
4. Initialize this repository with a README: Marque esta opção se quiser que ele crie um arquivo README.md inicial.
5. Git ignore: Selecione um template de .gitignore para a linguagem/tecnologia do seu projeto (ex: Node, Python, C#) para ignorar arquivos comuns. Isso é muito útil!
6. License: Escolha uma licença se desejar.
7. Clique em Create Repository.
   • O GitHub Desktop automaticamente executa o equivalente a git init e cria os arquivos iniciais.

2.2. Adicionar um Repositório Local Existente ➕

Se você já tem uma pasta de projeto em seu computador que já é um repositório Git (inicializado com git init na linha de comando):

1. No menu superior, clique em File > Add Local Repository...
2. Choose...: Navegue até a pasta raiz do seu repositório Git existente e selecione-a.
3. Clique em Add Repository.

2.3. Clonar um Repositório do GitHub.com ⬇️

Esta é a forma mais comum de começar a trabalhar em um projeto existente no GitHub:

1. No menu superior, clique em File > Clone Repository...
2. Você terá opções para clonar repositórios do seu GitHub.com, de outras URLs (como GitLab, Bitbucket ou outros servidores Git) ou do seu desktop.
3. Para GitHub.com: Escolha a aba "GitHub.com". Selecione o repositório que deseja clonar da sua lista.
4. Local Path: Escolha a pasta onde o repositório será salvo em seu computador.
5. Clique em Clone.
   • O GitHub Desktop executa o equivalente a git clone.

3. O Fluxo de Trabalho Básico: Alterar, Comitar, Sincronizar 🔄

A interface principal do GitHub Desktop é dividida em algumas seções-chave:

• Current Repository: Mostra o repositório ativo no momento.
• Current Branch: Mostra a branch em que você está trabalhando.
• Changes (Alterações): Onde você vê seus arquivos modificados e prepara seus commits.
• History (Histórico): Onde você vê todos os commits do repositório.

3.1. Fazendo Alterações e Criando Commits ✍️