volta-to-mise-migrator

A CLI tool to migrate Volta configuration in package.json to Mise .toml format.

Features

• Recursively scans directories for package.json files with Volta configuration
• Converts Volta settings to Mise .toml format
• Intelligently skips child directories with identical parent configurations
• Optionally removes Volta configuration from package.json files
• Excludes node_modules directories from scanning

Usage

Basic Usage (Dry Run)

Run the migration tool in the directory containing your package.json files. This will create mise.toml files but keep the Volta configuration in package.json:

npx @nanolier/volta-to-mise-migrator

Remove Volta Configuration

To create mise.toml files and remove the Volta configuration from package.json:

npx @nanolier/volta-to-mise-migrator --remove-volta

How It Works

1. Scans Directories: Recursively searches for all package.json files starting from the current directory (excluding node_modules)
2. Detects Volta Config: Identifies package.json files with Volta configuration
3. Converts to Mise Format: Creates mise.toml files with the equivalent Mise configuration
4. Smart Deduplication: Skips creating mise.toml in child directories if they have the same configuration as their parent
5. Optional Cleanup: Removes Volta configuration from package.json when --remove-volta flag is used

Example

Before Migration

package.json:

{
  "name": "my-project",
  "volta": {
    "node": "20.10.0",
    "pnpm": "8.14.0"
  }
}

After Migration

mise.toml (created):

[tools]
node = "20.10.0"
pnpm = "8.14.0"

package.json (with --remove-volta):

{
  "name": "my-project"
}

Supported Tools

• Node.js
• npm
• pnpm
• Yarn