creationix/nvm
Nvm
nvm is a Node.js version manager implemented as a POSIX bash script. It serves as a shell environment manager and runtime orchestrator for installing, switching, and managing multiple versions of the Node.js runtime on POSIX systems.
The tool allows for the automation of runtime switching by reading configuration files in project directories to select the required version. It supports the management of long-term support releases and the migration of global packages between different installed versions of the runtime.
The project covers broader capabilities including runtime management through version aliases and default version settings, software management via installation and uninstallation of specific releases, and environment isolation to prevent conflicts between binaries and modules.
The toolset is loaded into the current shell process via the source command to enable the modification of shell state.
Features
- Node.js Version Managers - Provides a comprehensive system for installing and switching between multiple Node.js runtime versions.
- Dynamic Script Loading - Loads the manager into the current shell process via sourcing to enable direct modification of shell state.
- Runtime Version Switching - Toggles between different runtime versions automatically based on directory-level configuration files.
- Configuration-Based Switching - Read a configuration file in a directory to switch to the required runtime version when entering that folder.
- Shell Environment Managers - Dynamically updates the shell PATH environment variable to swap active runtime versions.
- Version Selection Interfaces - Reads project-root configuration files to automatically select and install the required runtime version.
- Directory-Based Environment Switching - Automatically switches the Node.js runtime when entering a project directory based on a local configuration file.
- Multi-Version Installations - Downloads and installs multiple specific versions of the Node.js runtime environment.
- Directory-Based Version Resolution - Automatically switches the active Node.js version by detecting configuration files in the current working directory.
- Isolated Runtime Directories - Isolates different runtime versions in distinct filesystem directories to prevent binary and module conflicts.
- Package Migrators - Automates the migration of global packages from one installed runtime version to another.
- Runtime Version Mappings - Provides a mechanism to map human-readable aliases to specific runtime versions for consistent environment switching.
- Version Aliases - Allows creating custom aliases (like 'lts/iron') to simplify referencing specific runtime versions.
- Runtime Version Removal - Provides functionality to uninstall specific Node.js versions to reclaim disk space.
- Remote Version Discovery - Displays a list of Node.js versions currently installed locally or available for download from remote sources.
- Release Track Management - Organizes and tracks long-term support (LTS) release lines to ensure environment stability.
- POSIX Shell Utilities - Implemented as a lightweight POSIX bash script to ensure compatibility and avoid external binary dependencies.
- Per-Command Version Runtimes - Provides the ability to run a command using a specific Node.js version without permanently switching the active runtime.
- Runtime Isolation - Ensures that different Node.js versions and their global packages remain isolated in distinct filesystem directories.
- Default Version Settings - Allows users to define a global default Node.js version that persists across new terminal sessions.
- Version Migrations - Installs new runtime versions while automatically migrating global packages from a previous installation.
- Development Environment - Node version manager for macOS and Linux.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
