Entendiendo Volta

Cómo Funciona Volta

Volta gestiona tus herramientas de línea de comandos JavaScript creando shims que enrutan a la versión correcta basada en tu directorio actual. Esto permite que diferentes proyectos usen diferentes versiones de la misma herramienta sin ninguna configuración adicional.

El Sistema Shim

Cuando instalas Volta, añade un pequeño conjunto de shims a tu PATH:

• Uno para node
• Uno para cada gestor de paquetes (npm, yarn, pnpm, etc.)
• Uno para cada paquete global que instalas

Estos shims son ejecutables pequeños que determinan qué versión real de la herramienta ejecutar:

1. Verificando si estás en un proyecto con versiones de herramientas fijadas
2. Usando tu versión por defecto si no se encuentra versión específica del proyecto

Versiones Específicas del Proyecto

Volta almacena los requisitos de herramientas del proyecto en tu archivo package.json bajo la sección volta:

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

Cuando ejecutas un comando en un directorio con esta configuración, Volta automáticamente asegura que uses estas versiones exactas.

Versiones Por Defecto

Para ubicaciones fuera de proyectos con versiones fijadas, Volta usa tus herramientas por defecto. Puedes establecerlas con:

volta install node@16.15.1
volta install npm@8.11.0

¿Por qué Volta?

Entornos Consistentes

Volta asegura que todos trabajando en un proyecto usen exactamente la misma cadena de herramientas, eliminando problemas de "funciona en mi máquina".

Cero Sobrecarga

A diferencia de otros gestores de versiones, Volta no requiere comandos adicionales para cambiar versiones cuando cambias proyectos. Sucede automáticamente mientras navegas tu sistema de archivos.

Rendimiento Rápido

Construido en Rust, Volta está diseñado para velocidad. Su arquitectura shim significa sobrecarga mínima al ejecutar herramientas JavaScript.

Integración Fluida

Volta funciona junto a tu flujo de trabajo de desarrollo JavaScript existente sin requerir cambios a tus hábitos o procesos.

Flujos de Trabajo Comunes

Iniciando un Nuevo Proyecto

# Crear un directorio y configurar un paquete
mkdir my-project && cd my-project
npm init -y

# Fijar las versiones de Node.js y npm
volta pin node@16
volta pin npm@8

# Instalar dependencias
npm install express

Contribuyendo a un Proyecto Existente

# Clonar el repositorio
git clone https://github.com/example/project.git
cd project

# Si el proyecto tiene una configuración volta en package.json,
# las herramientas correctas se usarán automáticamente

# Si no, puedes añadirlas
volta pin node@14

Instalando Herramientas Globales

# Instalar un paquete global
volta install typescript

# Ahora puedes usarlo desde cualquier lugar
tsc --version