🐙 Pré-Curso — Criando sua conta no GitHub e

entregando os exercícios
Jornada DEV START — Programa START · TOTVS Paulista Guia para quem nunca usou Git nem
GitHub. Crie sua conta e o repositório até 11/07 — a partir da Aula 1 todos os exercícios são
entregues por aqui. Travou? Poste no Discord #ambiente-e-instalacao .

Por que GitHub?

O GitHub é onde programadores do mundo todo guardam e mostram seu código. Para você, ele é duas
coisas ao mesmo tempo:
1. Seu portfólio — ao fim do curso, você tem um endereço público (ex.: [Link]/seunome ) que
mostra tudo que construiu, do "Olá, Mundo!" ao TCC. Isso vale ouro numa entrevista.
2. A forma de entregar os exercícios — você sobe o código no seu repositório e cola o link na
atividade do Google Classroom. Assim conseguimos ler, acompanhar e corrigir cada exercício de
forma organizada.
E o Git? É o programa que roda no seu computador e conversa com o GitHub. Pense assim: o Git é o
"carteiro" que leva seu código, e o GitHub é o "endereço na nuvem" onde ele fica guardado. Você vai
instalar os dois neste guia.
Não precisa ter medo: você vai usar só 3 comandos no dia a dia. Vamos com calma, tela por tela — as
imagens abaixo mostram exatamente o que você vai ver.

Parte 1 — Criar sua conta (pública e gratuita)

1. Acesse [Link]
2. Clique em Criar uma conta (ou Sign up), no canto superior direito. Você também pode digitar seu
e-mail direto no campo e clicar em Cadastrar-se no GitHub.
Página inicial do [Link] — clique em "Criar uma conta" no canto superior direito.
3. Preencha o formulário de cadastro:
Email — use um e-mail que você acessa sempre (vai precisar confirmar).
Password — mínimo de 8 caracteres com número e letra minúscula (ou 15+ caracteres).
Username — 💡 atenção aqui: esse nome vira o endereço do seu portfólio (ex.:
[Link]/joaosilva ). Use um nome profissional, que você colocaria num currículo.
Só pode ter letras, números e hífens.
Your Country/Region — selecione Brazil.
As opções de GitHub Copilot e Email preferences são opcionais — pode deixar
desmarcadas.
4. Clique em Create account e siga as instruções (o GitHub pode pedir uma verificação do tipo "prove
que você não é um robô").
5. Abra seu e-mail e confirme o código de verificação que o GitHub enviou.
Formulário de cadastro: e-mail, senha, nome de usuário e país. O check verde ✅ indica que o campo foi
aceito.
6. Com a conta criada, faça o login (Sign in) com o usuário e a senha que você acabou de criar:
A mensagem verde confirma: "Your account was created successfully" — sua conta foi criada. Agora é só
entrar.
Depois do login você cai no Dashboard — a "página inicial" da sua conta:
Seu Dashboard. Repare no botão verde "Create repository" à esquerda — vamos usá-lo na Parte 3.
✅ Sua conta é pública por padrão — perfeito, porque queremos que seu portfólio seja visível.

Parte 2 — Instalar o Git no seu computador

Agora vamos instalar o Git — o programa que envia seu código para o GitHub.
2.1 — Baixar o instalador
1. Acesse [Link]
2. Clique em "Click here to download" (primeiro link da página) — ele baixa a versão 64-bit mais
recente para Windows.
*Página de instalação do Git para Windows — clique em "Click here to download".*
3. Quando terminar, abra sua pasta Downloads e dê dois cliques no arquivo baixado (o nome é
parecido com Git-[Link]-64-bit ):
O instalador baixado na pasta Downloads. Dois cliques para executar. Se o Windows perguntar "Deseja
permitir que este aplicativo faça alterações?", clique em Sim.
2.2 — Executar o instalador (pode aceitar tudo!)
O instalador do Git faz muitas perguntas — e isso assusta quem vê pela primeira vez. Boa notícia: você
pode simplesmente clicar Next em todas as telas. As opções que já vêm marcadas são exatamente as
que queremos. Mostramos cada tela abaixo só para você conferir que está no caminho certo — não precisa
mudar nada.
Tela 1 — a licença (o Git é gratuito e de código aberto). Clique Next.
Tela 2 — onde o Git será instalado ( C:\Program Files\Git ). Deixe como está e clique Next.
Tela 3 — componentes. Deixe as opções que já vêm marcadas e clique Next. (Nas próximas telas o
instalador ainda pergunta o nome do atalho no Menu Iniciar — só clicar Next também.)
Tela 4 — editor padrão do Git. Pode deixar como está e clicar Next — não vamos usar esse editor no curso.
(Se quiser, abra a lista e escolha "Use Visual Studio Code as Git's default editor", mas não é obrigatório.)
Tela 5 — nome do "branch" inicial. Deixe "Let Git decide" e clique Next. (Você vai aprender o que é branch
durante o curso — por enquanto, é só o nome da "linha do tempo" do seu projeto.)
Tela 6 — deixe a opção do meio, "Git from the command line and also from 3rd-party software" (é a
recomendada e já vem marcada). É ela que permite usar o git no Prompt de Comando. Clique Next.
Tela 7 — deixe "Use bundled OpenSSH" e clique Next.
Tela 8 — deixe a primeira opção (recomendada para Windows) e clique Next.
Tela 9 — deixe "Use MinTTY" e clique Next.
Tela 10 — deixe "Merge" e clique Next.
Tela 11 — última pergunta! Deixe como está e clique em Install para começar a instalação.
Aguarde a barra de progresso terminar (leva 1 ou 2 minutos).
Pronto! Pode desmarcar as duas opções e clicar Finish.
2.3 — Testar se o Git instalou
Vamos abrir o Prompt de Comando (a "tela preta" onde digitamos comandos):
1. Pressione as teclas Windows + R ao mesmo tempo
2. Digite cmd e pressione Enter (ou clique OK)

A janela "Executar": digite

cmd e Enter. (Também funciona pesquisar "Prompt de Comando" no Menu Iniciar.)

3. Na tela preta que abrir, digite o comando abaixo e pressione Enter:

 git --version

Se aparecer git version 2.55.x , o Git está instalado e funcionando. ✅

❗ Se aparecer "'git' não é reconhecido como um comando...", feche e abra o Prompt de Comando de
novo (ele precisa ser reaberto após a instalação). Se ainda assim não funcionar, poste um print no
Discord #ambiente-e-instalacao .
2.4 — Configuração inicial (uma vez só)
Agora vamos "assinar" o Git com seu nome e e-mail — é assim que cada envio de código fica identificado
como seu. No mesmo Prompt de Comando, digite os dois comandos abaixo, um de cada vez (pressione
Enter após cada um), trocando pelo seu nome e pelo mesmo e-mail que você usou no GitHub:
git config --global [Link] "Seu Nome"
git config --global [Link] "seuemail@[Link]"
Exemplo real: os dois comandos executados. Repare que eles não mostram nenhuma mensagem de
resposta — no terminal, silêncio é sinal de sucesso. 😉
💡 As aspas no nome são necessárias porque ele tem espaço. E o --global significa "vale para tudo
neste computador" — por isso você só faz isso uma vez.

Parte 3 — Criar o repositório do curso

Repositório (ou "repo") é a pasta do seu projeto dentro do GitHub. Você vai ter um repositório só para o
curso, organizado por módulo.
1. No GitHub, clique no botão verde Create repository do Dashboard (ou no + do canto superior
direito → New repository)
2. Em Repository name, digite: jornadadev (o GitHub confirma com um ✅ verde que o nome está
disponível)
3. Em Description (opcional), escreva algo como Jornada DEV - TOTVS Paulista
4. Deixe a visibilidade como Public (público) — é o seu portfólio!
5. Pode deixar o restante como está (README Off, sem .gitignore, sem licença)
6. Clique em Create repository
Tela de criação: nome jornadadev , descrição, visibilidade Public. Depois é só clicar em Create
repository (botão verde no fim da página).
Você cai na página do seu repositório recém-criado (ainda vazio):
Seu repositório no ar! 🎉 Guarde o endereço que aparece no campo HTTPS ( [Link]
USUARIO/[Link] ) — vamos usá-lo já já.

3.1 — Criar o primeiro arquivo (README)

Todo repositório tem um README — um arquivo de apresentação que aparece na página inicial do repo.
Vamos criar o seu direto pelo navegador (e de quebra o repositório deixa de estar vazio):
1. Na página do repositório, procure a frase "Get started by creating a new file" (logo abaixo do
quadro azul "Quick setup") e clique no link azul creating a new file — não é um botão, é um
link no meio do texto:
Na frase "Get started by creating a new file", clique no link azul creating a new file.
2. Abre o editor de arquivos do GitHub. No campo do nome (ao lado de jornadadev / ), digite:
[Link]
3. Na área de texto abaixo, escreva uma apresentação curta, por exemplo:
# Jornada DEV — TOTVS Paulista

Exercícios e projetos do curso, organizados por módulo.

Aluno: Seu Nome

O nome [Link] no campo de cima e o texto de apresentação no editor. Troque "Matheus Nogueira"
pelo seu nome. 😉
4. Clique no botão verde Commit changes... (canto superior direito). Vai abrir uma janelinha pedindo
a mensagem do commit — pode aceitar a sugestão ou escrever a sua (ex.: "Commit inicial") e clicar
em Commit changes:
"Commit" é como o Git chama cada gravação no histórico — toda gravação leva uma mensagem
descrevendo o que foi feito. Confirme em Commit changes.
Pronto: você volta para a página do repositório, agora com o README aparecendo como cartão de visitas.
Seu portfólio começou. 🚀
Assim fica seu repositório: o arquivo [Link] listado em cima e o texto de apresentação renderizado
embaixo. Repare também no botão verde Code — é dele que vamos copiar o endereço no próximo passo.
3.2 — Trazer o repositório para o seu computador (clone)
Clonar = baixar uma cópia do repositório para trabalhar nele no seu computador.
1. Na página do repositório, clique no botão verde Code → aba HTTPS → copie o endereço (ícone de
duas folhinhas 📋 )
2. Abra o Prompt de Comando (Windows + R → cmd ) e digite, trocando SEU-USUARIO pelo seu
nome de usuário:
git clone [Link]
cd jornadadev

O primeiro comando baixa o repositório (cria a pasta jornadadev em C:\Users\SeuUsuario ); o

segundo entra na pasta. É dentro dela que você vai criar os arquivos dos exercícios.
Exemplo real: git clone baixa o repositório, cd jornadadev entra na pasta e dir lista o conteúdo —
repare que o [Link] que você criou pelo navegador já está lá. Se aparecer o mesmo resultado (o
arquivo listado, sem mensagens de erro em vermelho), deu tudo certo. ✅
💡 Quer a pasta em outro lugar? Antes do git clone , navegue até onde quiser com cd (ex.: cd
C:\harbour-curso ). Se ficou em dúvida, deixe no padrão mesmo — o importante é lembrar onde está.

Parte 4 — A estrutura padronizada (IMPORTANTE) 📁

Para conseguirmos corrigir os exercícios de forma organizada, todos seguem a mesma estrutura: uma
pasta por módulo e um arquivo por exercício, com nome padronizado.
jornadadev/
├── [Link]
├── modulo-01/
│ ├── [Link]
│ ├── [Link]
│ └── [Link]
├── modulo-02/
│ └── [Link] ← teoria (pseudocódigo/fluxograma) vai como .md
├── modulo-03/
├── ...
└── modulo-10/

As 3 regras (simples e valem para o curso todo):

1. Uma pasta por módulo: modulo-01 , modulo-02 , … modulo-10 — sempre com 2 dígitos e
igual ao nome do módulo no material.
2. Um arquivo por exercício, no formato exNN-<descricao>.prg :
NN = número do exercício na lista, com 2 dígitos ( ex01 , ex02 , …).
<descricao> = nome curto em minúsculas com hífens (ex.: [Link] ).
 Exercício de teoria (pseudocódigo, fluxograma, resposta escrita) → use .md no lugar de
.prg .

3. Exercício que é um mini-projeto (vários arquivos) → crie uma subpasta exNN-<descricao>/

com os arquivos dentro (ex.: modulo-06/ex07-controle-estoque/ ).
⚠️ Cada [Link] do módulo traz, no final, a seção "📁 Como organizar no seu repositório"
com a lista exata de arquivos esperados daquela aula. Siga-a à risca — é isso que permite a correção
estruturada de cada entrega.

Parte 5 — Os 3 comandos do dia a dia

Sempre que terminar os exercícios de uma aula, abra o Prompt de Comando, entre na pasta do repositório
( cd jornadadev ) e repita este ciclo:
git add . # 1. seleciona tudo que você criou/alterou
git commit -m "modulo 01 - exercicios" # 2. tira uma "foto" com uma descrição
git push # 3. envia para o GitHub

Pronto — seu código está no GitHub. Atualize a página do repositório e veja seus arquivos lá. 🎉
💡 Analogia: add = colocar os documentos na pasta · commit = bater a foto e etiquetar · push =
enviar pelo correio para a nuvem.
🔑 Na primeira vez que você der git push , vai abrir uma janela pedindo para entrar na sua conta do
GitHub — escolha "Sign in with your browser", faça o login e autorize. Isso só acontece uma vez;
depois o Windows guarda a autorização.

Parte 6 — Como entregar no Classroom

1. Faça o push dos exercícios da aula (Parte 5)
2. Copie o link do seu repositório (ou da pasta do módulo, ex.:
[Link]/seunome/jornadadev/tree/main/modulo-01 )
3. Abra a atividade da aula no Google Classroom e cole o link
4. Comemore no Discord #conquistas ! 🎉
Nas primeiras aulas, se ainda estiver pegando o jeito do Git, também vale anexar o arquivo .prg direto
na atividade do Classroom. Mas tente usar o GitHub desde cedo — é prática.

🆘 Deu erro? Tabela de socorro

Mensagem/situação O que significa Solução
Git não instalado (ou terminal aberto Feche e reabra o cmd; se
git não é reconhecido
antes da instalação) persistir, refaça a Parte 2
Pediu login ao dar push Autenticação (normal na 1ª vez) Escolha "Sign in with your
browser" e autorize
Nada novo para enviar Você já enviou tudo, ou
nothing to commit
esqueceu de salvar o arquivo
 Endereço digitado errado no clone Confira o link no botão Code do
repository not found
seu repositório
Não sei em qual pasta — Rode cd para ver, ou peça ajuda
estou no Discord

Checklist
Conta criada no GitHub (pública) e e-mail confirmado
Git instalado ( git --version funciona)
git config feito com seu nome e e-mail
Repositório jornadadev criado, com README, e clonado no computador
Entendi a estrutura modulo-01/ , modulo-02/ … e o nome [Link]
Fiz um add → commit → push de teste
Qualquer passo que travar, o #ambiente-e-instalacao no Discord está aberto. Bora construir seu
portfólio! 🚀