Seed a Bit logo

Seed a Bit

Github

Introdução

Agora é a hora de aprender sobre o Node.js, um ambiente de execução JavaScript server-side eficiente e popular.

O Node será melhor abordado em seções futuras do guia, veremos como utilizar o Node Package Manager (NPM) e como configurar o ambiente de desenvolvimento de template.

O que é?

O Node.js é um ambiente de execução JavaScript server-side baseado no V8 do Chrome. Ele permite que você execute JavaScript no servidor, o que é útil para construir aplicações web escaláveis e rápidas. Com o Node.js, você pode criar aplicações web, APIs, scripts de automação e muito mais. Ele é amplamente utilizado por empresas como Netflix, Uber, PayPal e Walmart.

No nosso caso, utilizaremos o Node.js para executar o servidor de desenvolvimento do Next.js e para instalar pacotes JavaScript. Principalmente os comandos com npm e npx.

Instalação

Para instalar o Node.js vá até o site oficial e baixe a versão LTS (Long Term Support) para o seu sistema operacional. O Node.js é instalado juntamente com o NPM (Node Package Manager), que é um gerenciador de pacotes JavaScript.

Após a instalação, você poderá verificar se o Node foi instalado corretamente através do terminal.

node - v
npm - v

Há também outros gerenciadores de pacotes JavaScript, como o Yarn ou Bun. No entanto, o NPM é o mais utilizado e é instalado automaticamente com o Node.js. Pesquise mais sobre essas ferramentas e escolha a que melhor se adequa às suas preferências.

NPM (Node Package Manager)

O NPM é um gerenciador de pacotes JavaScript que vem instalado com o Node.js. Ele permite que você instale, compartilhe e gerencie pacotes JavaScript de forma fácil. Você pode instalar pacotes localmente em um projeto ou globalmente no seu sistema.

Os pacotes JavaScript são bibliotecas de código JavaScript que você pode usar em seus projetos. Eles são publicados no NPM por desenvolvedores de todo o mundo e podem ser instalados em seus projetos com um simples comando.

Podemos rapidamente baixar todas as dependências de um projeto e executar scripts com o comando. Veja o comando abaixo, o mesmo serve para baixar todas as dependências de um projeto, definidas no arquivo package.json:

npm install

O comando acima criará um arquivo package-lock.json que contém a versão exata de cada pacote instalado. Isso garante que o projeto seja reproduzível em diferentes ambientes e evita problemas de compatibilidade. Além disso, cria o diretório node_modules que contém todos os pacotes instalados.

package.json

O arquivo package.json é um arquivo de manifesto para um projeto Node.js. Ele contém metadados sobre o projeto, como nome, versão, descrição, scripts, dependências e muito mais. O NPM usa o arquivo package.json para instalar pacotes, executar scripts e gerenciar dependências.

1

Como você pode ver, o arquivo package.json contém informações sobre o projeto, como nome, versão, scripts e dependências. Você pode personalizar o arquivo package.json para atender às necessidades do seu projeto. Veja a seguir uma descrição dos campos mais comuns do arquivo package.json:

  • name: O nome do projeto.
  • version: A versão do projeto.
  • private: Se o projeto é privado ou público.
  • scripts: Scripts personalizados para executar tarefas.
  • dependencies: Dependências do projeto.
  • devDependencies: Dependências de desenvolvimento do projeto.

Scripts

Os scripts no arquivo package.json são comandos personalizados que você pode executar com o NPM. Eles são úteis para automatizar tarefas comuns, como iniciar o servidor de desenvolvimento, construir o projeto, executar testes e muito mais.

Os scripts do arquivo package.json do projeto serão explicados abaixo:

  • dev: Inicia o servidor de desenvolvimento do Next.js.
  • build: Constrói o projeto Next.js. É usado pelo servidor de produção.
  • start: Inicia o servidor de produção do Next.js.
  • lint: Executa o linter do Next.js. Esse comando também é chamado pelo Husky antes de cada commit.
  • clean-dev: Remove a pasta .next e inicia o servidor de desenvolvimento, recriando essa pasta (debug).
  • clean-build: Remove a pasta .next e constrói o projeto.
  • clean-install: Remove a pasta node_modules e re-instala as dependências (debug).
  • prepare: Configuração do Husky. Não será necessário rodar.

Rode os comandos acima com:

npm run [command]

Recomenda-se a execução de npm run lint e npm run build antes do envio de uma PR para o repositório. Isso garante que o código esteja funcionando corretamente e seguindo os padrões definidos.