Entendendo o Volta

Como o Volta Funciona

O Volta gerencia suas ferramentas de linha de comando JavaScript criando shims que roteiam para a versão correta com base em seu diretório atual. Isso permite que projetos diferentes usem versões diferentes das mesmas ferramentas, sem qualquer configuração adicional.

Sistema de Shims

Quando você instala o Volta, ele adiciona um conjunto de pequenos shims ao seu PATH:

• Um shim para node
• Um shim para cada gerenciador de pacotes (npm, yarn, pnpm, etc.)
• Um shim para cada pacote global que você instala

Esses shims são executáveis minúsculos que determinam qual versão real da ferramenta executar:

1. Verificando se você está em um projeto com versões de ferramentas fixadas
2. Se não encontrar versões específicas do projeto, usa suas versões padrão

Versões Específicas de Projeto

O Volta armazena requisitos de ferramentas do projeto na seção volta do seu arquivo package.json:

{
  "volta": {
    "node": "16.15.1",
    "npm": "8.11.0"
  }
}

Quando você executa comandos em um diretório com esta configuração, o Volta automaticamente garante que você use essas versões exatas.

Versões Padrão

Para locais fora de projetos sem versões fixadas, o Volta usa suas ferramentas padrão. Você pode definir essas usando:

volta install node@16.15.1
volta install npm@8.11.0

Por que Escolher o Volta?

Ambiente Consistente

O Volta garante que todos que trabalham em um projeto usem exatamente a mesma cadeia de ferramentas, eliminando problemas de "funciona na minha máquina".

Zero Sobrecarga

Diferente de outros gerenciadores de versões, o Volta não exige comandos adicionais para alternar versões quando você muda de projeto. Isso acontece automaticamente conforme você navega pelo sistema de arquivos.

Performance Rápida

Construído em Rust, o Volta é projetado para velocidade. Sua arquitetura de shims significa sobrecarga mínima ao executar ferramentas JavaScript.

Integração Sem Esforço

O Volta funciona com seu fluxo de trabalho de desenvolvimento JavaScript existente, sem exigir mudanças em seus hábitos ou processos.

Fluxos de Trabalho Comuns

Iniciando um Novo Projeto

# Criar diretório e configurar pacote
mkdir my-project && cd my-project
npm init -y

# Fixar versões do Node.js e npm
volta pin node@16
volta pin npm@8

# Instalar dependências
npm install express

Contribuindo para um Projeto Existente

# Clonar repositório
git clone https://github.com/example/project.git
cd project

# Se o projeto tem configuração volta no package.json,
# automaticamente usará as ferramentas corretas

# Se não tiver, você pode adicioná-las
volta pin node@14

Instalando Ferramentas Globais

# Instalar pacote global
volta install typescript

# Agora você pode usá-lo de qualquer lugar
tsc --version