Volta Global Tool Management

Overview

Volta manages global CLI tools differently from npm. When you volta install typescript, it creates a shim that uses the project's pinned Node version when inside a project, and your default version elsewhere. This eliminates the "global tool uses wrong Node" problem.

Why This Matters

• -Project-aware globals — global tools use project's Node version
• -No version conflicts — each project can have different tool versions
• -Clean uninstall — volta uninstall removes cleanly
• -Portable — global tools travel with your Volta config

How It Works

Step 1: Install Global Tools

# Install commonly-used global tools
volta install typescript
volta install prettier
volta install eslint
volta install tsx
volta install turbo
volta install vercel

# Install specific versions
volta install typescript@5.3

# List installed tools
volta list all

Step 2: Understand the Shim Behavior

# Inside a project with Node 20 pinned:
cd ~/projects/app-node20
tsc --version  # Uses Node 20 to run TypeScript

# Inside a project with Node 18 pinned:
cd ~/projects/app-node18
tsc --version  # Uses Node 18 to run TypeScript

# Outside any project:
cd ~
tsc --version  # Uses your default Node version

Step 3: Project-Specific Tool Versions

# Pin a specific tool version for a project
volta pin typescript@5.0

# This adds to package.json:
# "volta": {
#   "node": "20.11.1",
#   "npm": "10.4.0",
#   "extends": ["typescript@5.0.4"]
# }

Volta Install vs npm install -g

# Good: Volta-managed (project-aware)
volta install prettier
# Creates a shim that respects per-project Node

# Bad: npm-managed (uses global Node only)
npm install -g prettier
# Always uses global Node, ignoring project pins

Best Practices

• -Use `volta install` for ALL global tools — never npm install -g
• -Pin project-specific versions when a tool version matters for that project
• -Keep globals minimal — only tools you use across all projects
• -List periodically: volta list all to audit installed tools
• -Uninstall unused: volta uninstall <tool>

Common Mistakes

• -Using npm install -g alongside Volta (shim conflicts)
• -Installing too many global tools (hard to maintain)
• -Not understanding shim behavior (expecting same version everywhere)
• -Forgetting that Volta globals require Volta on the PATH