Gerenciando Seu Projeto

O Volta permite que equipes e colaboradores padronizem as ferramentas de desenvolvimento que usam para seus projetos. Este guia mostrará como usar o Volta para gerenciar seus projetos de forma eficaz.

Fixando Versões de Ferramentas

A funcionalidade mais importante de gerenciamento de projetos no Volta é a capacidade de fixar versões específicas de ferramentas ao seu projeto:

Fixando Node.js

Para especificar qual versão do Node.js seu projeto deve usar:

volta pin node@16.14.2

Você também pode fixar para versão principal ou secundária, e o Volta usará a versão correspondente mais recente:

volta pin node@16

Fixando Gerenciadores de Pacotes

Da mesma forma, você pode fixar versões do npm e Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Como Funciona a Fixação

Quando você fixa versões de ferramentas, o Volta:

1. Atualiza o arquivo package.json do seu projeto com a seção volta
2. Envia essas informações para controle de versão
3. Garante que todos na equipe usem as mesmas versões

Aqui está como a seção volta no seu package.json ficará:

{
  "name": "your-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.18"
  }
}

Ferramentas Locais do Projeto

O Volta também respeita instalações locais de ferramentas do projeto:

Usando Binários de Pacotes Locais

Quando você instala pacotes localmente no projeto:

npm install typescript
# ou
yarn add typescript

Você pode executar seus binários através do Volta:

volta run tsc
# ou simplesmente
tsc

O Volta usará a versão do Node.js fixada no projeto para executar essas ferramentas.

Suporte a Workspaces

Para configurações de monorepo com múltiplos projetos, o Volta suporta herança de configuração:

Configuração de Extensão

Em um workspace com múltiplos projetos, você pode definir configuração base no package.json raiz:

{
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.18"
  }
}

Então, em arquivos package.json de projetos individuais, estenda a configuração raiz:

{
  "volta": {
    "extends": "../../package.json"
  }
}

Isso permite que você mantenha versões de ferramentas consistentes entre todos os projetos no workspace.

Melhores Práticas de Gerenciamento de Projetos

Aqui estão algumas práticas recomendadas para usar o Volta no gerenciamento de projetos:

1. Sempre Fixe Suas Ferramentas

Para cada projeto, fixe versões do Node.js e gerenciador de pacotes:

volta pin node
volta pin npm
# ou
volta pin yarn

Isso garante que todos os membros da equipe tenham um ambiente de desenvolvimento consistente.

2. Envie a Configuração do Volta

Sempre envie a seção volta do package.json para controle de versão. Esta é a forma como o Volta compartilha configuração com sua equipe.

3. Documente Requisitos de Ferramentas

No README do seu projeto, mencione que você usa o Volta para gerenciamento de ferramentas:

## Desenvolvimento

Este projeto usa [Volta](https://volta.sh) para garantir consistência de ferramentas.
Instale o Volta e ele automaticamente usará as versões corretas do Node.js e npm.

4. Use Integração CI/CD

Em ambientes de integração contínua, inclua a instalação do Volta como parte do processo de build:

# Exemplo GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# O Volta automaticamente usará as versões corretas do Node.js e npm/yarn
- name: Install dependencies
  run: npm install

5. Padronização Entre Projetos

Para organizações com múltiplos projetos, padronize versões de ferramentas quando possível para minimizar o número de versões que os desenvolvedores precisam instalar.

Usando o Volta para gerenciar seus projetos de forma eficaz, você garante que todos os membros da equipe tenham um ambiente de desenvolvimento consistente, reduz problemas de "funciona na minha máquina" e torna a colaboração mais suave.