Instalar e ligar

A demo está na sua pasta, mas ainda desligada. São três comandos, um por vez, iguais nos dois sistemas. Todos dentro da pasta meu-primeiro-sistema.

Instalar as peças

Um sistema usa peças prontas feitas por outras pessoas, chamadas dependências. O npm (que veio junto com o Node.js) baixa essas peças. Cole e aperte Enter:

npm install

Demora um pouco, às vezes alguns minutos: é normal. Ele termina com uma linha parecida com added 87 packages e found 0 vulnerabilities. Isso só precisa ser feito uma vez.

Preparar a pasta

npm run comecar

Esse comando confere se o seu Node.js é novo o bastante e desliga a pasta do meu repositório no GitHub (o repositório é o lugar onde o código de um projeto fica guardado, com todo o histórico): a cópia passa a ser só sua, e nada do que você fizer volta para mim. Ele também cria a branch main, a linha do histórico onde as suas mudanças vão ficar guardadas. Ele responde assim:

Esta pasta agora é só sua.
Criei a branch main para guardar as suas mudanças.
Tudo pronto. Agora rode: npm run dev

Pode rodar quantas vezes quiser, não estraga nada. Da segunda vez em diante ele diz Esta pasta já é só sua. e não cria a branch de novo, porque ela já existe.

Se aparecer também Aviso: o Git ainda não sabe o seu nome, o Git vai pedir o seu nome na hora de guardar a primeira mudança, na etapa 04. Dá para resolver já: volte à parte Dizer ao Git quem é você da etapa Preparar o notebook do guia anterior.

Ligar o servidor

npm run dev

Em alguns segundos aparece Ready e o endereço http://127.0.0.1:3000. O 127.0.0.1 é o número do localhost: os dois querem dizer "este computador".

Abra o navegador e entre em:

http://localhost:3000

A tela mostra Meu primeiro sistema com o mascote e começa a conferir o seu computador. Na próxima etapa a gente lê o que ela diz.

A janela fica ocupada

Enquanto o servidor estiver ligado, essa janela do terminal fica ocupada com ele: ela não aceita outro comando e vai escrevendo o que o servidor faz. É assim mesmo. Quando precisar rodar outro comando, abra outra janela do terminal.

Para desligar, clique na janela do servidor e aperte Ctrl + C (no Mac também é Ctrl, não Cmd). Se perguntar alguma coisa, aperte S ou Y e Enter. Para ligar de novo, é o mesmo npm run dev, dentro da pasta.

Se a porta 3000 estiver ocupada

Se outro programa já estiver usando a porta 3000, o servidor não liga. O terminal mostra:

A porta 3000 já está em uso por outro programa. Feche o outro programa ou escolha outra porta:

Logo abaixo, ele mesmo mostra os comandos para Windows e Mac, e volta a aceitar comandos. Você tem duas saídas:

1. Feche o outro programa (muitas vezes é um npm run dev antigo, esquecido em outra janela: aperte Ctrl + C nela) e rode npm run dev de novo.
2. Ou ligue a demo em outra porta, por exemplo a 3001:

$env:PORT = "3001"
npm run dev

PORT=3001 npm run dev

Com a porta 3001, o endereço no navegador passa a ser http://localhost:3001.

Se aparecer um aviso de rede