| .github | ||
| test | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .mailmap | ||
| .npmrc | ||
| .travis.yml | ||
| bash_completion | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| GOVERNANCE.md | ||
| install.sh | ||
| LICENSE.md | ||
| Makefile | ||
| nvm-exec | ||
| nvm.sh | ||
| package.json | ||
| PROJECT_CHARTER.md | ||
| README.md | ||
| rename_test.sh | ||
| ROADMAP.md | ||
| update_test_mocks.sh | ||
Node Version Manager (NVM)
Node Version Manager (NVM) is not just a tool; it's a game-changer for developers who demand precision, flexibility, and efficiency in managing Node.js environments. Whether you're working on legacy systems or cutting-edge applications, NVM ensures your development workflow is seamless and future-proof.
Table of Contents
- Introduction
- Why Choose NVM?
- Installation and Updates
- Core Features
- Pro Tips for Power Users
- Troubleshooting
- Community and Support
- License
Introduction
In the fast-paced world of software development, managing multiple Node.js versions is no longer optional—it's essential. NVM empowers developers to:
- Seamlessly switch between Node.js versions.
- Maintain compatibility across diverse projects.
- Optimize workflows with minimal overhead.
Whether you're a solo developer or part of a large team, NVM is your go-to solution for Node.js version management.
Why Choose NVM?
- Unparalleled Flexibility: Switch between Node.js versions with a single command.
- Developer-Centric Design: Tailored for developers, by developers.
- Cross-Platform Excellence: Works flawlessly on Unix, macOS, and Windows WSL.
- Future-Ready: Regular updates and a thriving community ensure NVM stays ahead of the curve.
Installation and Updates
Quick Install
For a hassle-free installation, use the following script:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash
Or, if you prefer wget:
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash
Advanced Installation
For power users who need more control, clone the repository manually:
git clone https://github.com/nvm-sh/nvm.git ~/.nvm
cd ~/.nvm
git checkout v0.40.2
Then, add the following to your shell profile:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \ . "$NVM_DIR/nvm.sh"
Verifying Installation
Ensure NVM is installed correctly:
command -v nvm
If the output is nvm, you're good to go!
Core Features
Effortless Version Switching
Switching Node.js versions is as simple as:
nvm use 18
# Now using node v18.0.0
Want to install and use a specific version? No problem:
nvm install 16
# Now using node v16.14.0
Global Package Migration
Preserve your global packages when switching Node.js versions:
nvm install 14 --reinstall-packages-from=12
Customizing Your Environment
Tailor NVM to your workflow by setting environment variables like NVM_COLORS and NVM_DIR. For example:
export NVM_COLORS="bg=blue;fg=white"
Working with .nvmrc Files
Standardize Node.js versions across your team by using .nvmrc files:
echo "16" > .nvmrc
nvm use
Pro Tips for Power Users
Optimizing Shell Performance
Speed up your shell startup by lazy-loading NVM. Add this snippet to your profile:
export NVM_LAZY_LOAD=true
Using NVM in CI/CD Pipelines
Integrate NVM into your CI/CD workflows for consistent environments:
nvm install 18
nvm use 18
npm ci
npm test
Leveraging Node Binary Mirrors
Work in restricted environments by using custom Node.js mirrors:
export NVM_NODEJS_ORG_MIRROR=https://custom-mirror.com/node/
Troubleshooting
Common Issues and Fixes
-
Problem:
nvm: command not foundSolution: Ensure your shell profile is sourcing NVM correctly. -
Problem: Slow shell startup. Solution: Enable lazy loading with
export NVM_LAZY_LOAD=true.
macOS-Specific Tips
If you're using zsh, ensure your .zshrc includes:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \ . "$NVM_DIR/nvm.sh"
Community and Support
Join the vibrant NVM community on GitHub and Discord. Share your experiences, ask questions, and contribute to the project.
License
NVM is open-source software licensed under the MIT License. See the LICENSE file for details.