Primeiro Commit no Git: Iniciando seu Projeto

1. Hook (A Trava Mental)

• Aprendiz: "Mestre, a página está perfeita. Mas estou com medo de mexer. E se eu pedir para a IA adicionar uma nova seção e ela quebrar todo o layout que já validei? Terei que começar do zero?"

• Mestre: "Um receio sábio, mas desnecessário. Um projeto sem um histórico é como um viajante sem mapa: um passo em falso e ele está perdido. Hoje, você aprenderá a usar Git, a máquina do tempo dos desenvolvedores. Com ele, criaremos 'pontos de salvamento' (save points) na história do seu projeto, permitindo que você experimente sem medo, pois sempre poderá retornar a uma versão segura."

2. Deep Dive (A Solução: O que é Git?)

Git é um sistema de controle de versão. Em vez de criar cópias manuais como projeto_v1, projeto_v2, projeto_final_agora_vai, o Git gerencia o histórico de todas as alterações de forma automática e inteligente. Ele cria uma linha do tempo do seu projeto.

Para entender o conceito em menos de 30 segundos, assista a este trecho.

Cada "save point" nessa linha do tempo é chamado de commit. Nossa missão hoje é criar o primeiro commit do seu projeto Astro.

3. O Fazer (Microlearning Prático: Criando seu Primeiro "Save Point")

Vamos executar os três comandos essenciais para salvar o estado atual do seu projeto. Abra o terminal integrado do VS Code (atalho: Ctrl+ ` ou Cmd+ `).

Passo 1: Inicializar o Jogo (git init)

Primeiro, precisamos dizer ao Git para começar a "observar" a pasta do nosso projeto. Isso é feito apenas uma vez por projeto.

1. No seu terminal, certifique-se de que você está na pasta do seu projeto Astro.

2. Digite o seguinte comando e pressione Enter:

   git init
   

Este comando cria uma pasta oculta chamada .git, que é o "cérebro" do Git, onde todo o histórico será armazenado. Você acabou de "iniciar o jogo".

Passo 2: O Processo de Salvar em Duas Etapas

Salvar no Git não é um único clique. É um processo deliberado em duas etapas, que pode ser visualizado perfeitamente com este diagrama.

Etapa 2.1: Adicionar Arquivos à Área de Preparação (git add)

Você precisa dizer ao Git quais arquivos quer incluir no próximo "save point". Pense nisso como colocar os itens em uma caixa antes de lacrá-la. Para adicionar todos os arquivos do seu projeto de uma vez, use o ponto (.).

Digite o comando:

git add .

Etapa 2.2: Confirmar as Mudanças (git commit)

Agora que os arquivos estão na área de preparação (Staging Area), você "laca a caixa" criando um commit. Cada commit precisa de uma mensagem descritiva para que você (ou sua equipe) saiba o que foi feito naquele ponto.

Digite o comando:

git commit -m "Initial commit"

• commit: O comando para salvar.
• -m: Significa que você está fornecendo uma "mensagem" (message).
• "Initial commit": A mensagem descritiva. Esta é a convenção para o primeiro commit de um projeto.

Para ver esses comandos em ação e como o VS Code reage visualmente a eles, assista a este trecho.

Parabéns! Você criou com sucesso o primeiro ponto de salvamento do seu projeto.

4. Checkpoint (Dica de IA)

• Mestre: "Agora você tem um superpoder no seu fluxo de trabalho com IA. O Git é sua rede de segurança. Antes de pedir à IA uma alteração complexa e arriscada, o que você faz?"
• Aprendiz: "Eu crio um commit!"
• Mestre: "Exato. Você salva seu progresso. Se a IA gerar um código que quebra tudo, você não entra em pânico. Você simplesmente descarta as alterações e volta ao seu último commit seguro. Faça commits frequentes. Um bom lema é: 'Fez algo que funciona? Faça um commit.'"

Fluxo de Trabalho de Segurança com IA:

1. Você tem uma versão funcional do seu site.
2. Execute git add . e git commit -m "feat: Adiciona seção de herói funcional".
3. Peça à IA para criar uma nova e complexa galeria de imagens.
4. A IA gera o código, você o integra e... o site quebra.
5. Sem estresse. Você pode simplesmente deletar os arquivos gerados ou usar comandos do Git para reverter tudo ao estado do seu último commit. O medo de experimentar foi removido.

Conclusão

Você aprendeu a proteger seu trabalho e a criar uma base sólida para experimentação. O código do seu projeto não é mais um castelo de cartas, mas uma fortaleza com um histórico documentado.

• Key Takeaways:

  • Git é um sistema de controle de versão que funciona como uma máquina do tempo ou um sistema de "save games" para o seu código.
  • O processo de salvar envolve três comandos-chave:
    1. git init: Para iniciar o rastreamento em um projeto (feito uma vez).
    2. git add .: Para preparar (stage) todos os arquivos alterados para o próximo save point.
    3. git commit -m "mensagem": Para criar o save point (commit) com uma descrição.
  • Fazer commits frequentes é sua rede de segurança ao trabalhar com código gerado por IA.

• Próximo Passo: Seu "save game" está seguro, mas ainda está apenas no seu computador. E se o computador for perdido ou danificado? Na próxima lição, vamos levar nossa segurança para a nuvem. Você aprenderá a criar um repositório no GitHub e a enviar seu histórico local para este backup online, preparando o terreno para publicar seu site para o mundo.