Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jorgebucaran/nvm.fish
The Node.js version manager you'll adore, crafted just for Fish
https://github.com/jorgebucaran/nvm.fish
fish fish-plugin nodejs nvm
Last synced: 25 days ago
JSON representation
The Node.js version manager you'll adore, crafted just for Fish
- Host: GitHub
- URL: https://github.com/jorgebucaran/nvm.fish
- Owner: jorgebucaran
- License: mit
- Created: 2016-04-12T17:26:02.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-04-28T13:15:11.000Z (6 months ago)
- Last Synced: 2024-05-02T05:31:14.558Z (6 months ago)
- Topics: fish, fish-plugin, nodejs, nvm
- Language: Shell
- Homepage: https://git.io/nvm.fish
- Size: 266 KB
- Stars: 1,954
- Watchers: 16
- Forks: 68
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awsm.fish - nvm - Node.js version manager lovingly made for Fish (Plugins)
- awesometools - nvm.fish - Node.js version manager lovingly made for Fish. (For Developers / Utilities)
README
# nvm.fish
> The Node.js version manager you'll adore, crafted just for [Fish](https://fishshell.com).
Nope, not [_that_](https://github.com/nvm-sh/nvm) POSIX-compatible script. Built from scratch for [Fish](https://fishshell.com), this handy tool lets you juggle multiple active Node versions in a single local environment. Install and switch between runtimes like a boss, without messing up your home directory or breaking system-wide scripts.
- 100% pure Fish—so simple to contribute to or tweak
- Tab-completable for seamless shell integration
- `.node-version` and `.nvmrc` support
- [XDG Base Directory](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) compliant
- No setup needed—it just works!
## Installation
Install with [Fisher](https://github.com/jorgebucaran/fisher):
```console
fisher install jorgebucaran/nvm.fish
```
## Quickstart
Install the latest Node release and activate it.
```console
nvm install latest
```
Install the latest [LTS](https://github.com/nodejs/Release) (long-term support) Node release.
```console
nvm install lts
```
Install an older LTS release by codename.
> Installs `8.16.2`, the latest release of the Carbon LTS line.
```console
nvm install carbon
```
Or install a specific version of Node.
> Supports full or partial version numbers, starting with an optional "v".
```console
nvm install v15.3.0
```
Activate a version you've already installed.
```console
nvm use v14
```
Check out which versions you have installed (includes your system-installed Node if there is one).
```console
$ nvm list
system
v8.17.0 lts/carbon
v15.3.0
▶ v14.15.1 lts/fermium
v18.4.0 latest
```
Or list all the Node versions up for grabs.
```console
nvm list-remote
```
Need to uninstall a version?
```console
nvm uninstall v15.3.0
```
## `.nvmrc`
An `.nvmrc` file is perfect for locking a specific version of Node for different projects. Just create an `.nvmrc` (or `.node-version`) file with a version number or alias, e.g., `latest`, `lts`, `carbon`, in your project's root.
```console
node --version >.nvmrc
```
Then run `nvm install` to install or `nvm use` to activate that version. Works like a charm from anywhere in your project by traversing the directory hierarchy until an `.nvmrc` is found.
```console
nvm install
```
## `$nvm_mirror`
Choose a mirror of the Node binaries. Default: https://nodejs.org/dist.
## `$nvm_default_version`
The `nvm install` command activates the specified Node version only in the current environment. If you want to set the default version for new shells:
```fish
set --universal nvm_default_version v18.4.0
```
## `$nvm_default_packages`
Got a list of default packages you want installed every time you install a new Node version?
```fish
set --universal nvm_default_packages yarn np
```
## Acknowledgments
`nvm.fish` was established in 2016 by [**@jorgebucaran**](https://github.com/jorgebucaran) as the go-to Node.js version manager for Fish. It was inspired by the original [**nvm.sh**](https://github.com/nvm-sh/nvm) created by [**@creationix**](https://github.com/creationix) and [**@ljharb**](https://github.com/ljharb). To use the original nvm in Fish, consider [**@FabioAntunes/fish-nvm**](https://github.com/FabioAntunes/fish-nvm) or [**@derekstavis/plugin-nvm**](https://github.com/derekstavis/plugin-nvm). We appreciate all of our contributors! ❤️
## License
[MIT](LICENSE.md)