NvmFs 1.0.1

NvmFs

Node Version Manager F#

Get the binaries at the releases tab

if you have the dotnet-sdk installed run dotnet tool install -g NvmFs

A Node version Manager Written in F#

This is probably the simplest Node Version Manager you'll find it doesn't have a lot of features and this is on purpose for more complete solutions please take a look at nvm, volta, nvm-windows.

Why would you want this?

If you want a dead simple node version manager this is for you.

Also, this tool is distributed in binary form as well as a dotnet tool so if you're running on CI with dotnet available and depend on installing a specific node version, perhaps this is the reason you may want it above the others.

Why would you not want this?

tl;dr: You need something else rather than just nvmfs install version or nvmfs use version

• You need to run commands with different versions of node in the current shell without setting a global default like this.

• You need to reinstall packages between versions like this

• You need different architectures like this

Misc. Info

We don't handle existing node instalations outside the NVMFS_HOME directory

• Windows

  • We use the user's system environment variables, if your powershell/cmd session is not recognizing node, then you need to close it and open it again, in the worst case you just need to log off and log in back to your account
  • we use cmd's mklink to create junctions on windows

  In versions lower than 0.6.0 we used to re-write the user's path but that also expanded any Environment variable that was part of the PATH, rather than doing that we now just add the NVMFS_HOME and NVMFS_NODE environment variables to the user's variables, it is up to you to add %NVMFS_NODE%% to the PATH variable

• Unix

  • We append environment variables to the PATH using the ~/.bashrc
  • We use ln -s to create symlinks
  • We use unlink to remove symlinks
  • We use chmod +x to set execute permissions once we symlink the selected version

    Don't forget to call source ~/.bashrc to make your current terminal aware of the changes, other terminals will pick up those automatically

Customization

You can customize paths using the following environment variables

• NVMFS_HOME - where is nvmfs going to download node versions, defaults to

  $"{Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)}/nvmfs"

  • C:\Users\username\AppData\Roaming\nvmfs on windows
  • /home/username/.config/nvmfs on linux/macos

• NVMFS_NODE - symlinked location that will be added to the PATH

  • %%NVMFS_HOME%%\bin on windows
  • $NVMFS_HOME/bin on linux/macos

• NVM_SOURCE_BASE_URL - the base url to get node distributions, (defaults to https://nodejs.org/dist)

nvmfs help

Description:
  nvmfs is a simple node version manager that just downloads and sets node versions. That's it!

Usage:
  NvmFs [command] [options]

Options:
  --version       Show version information
  -?, -h, --help  Show help and usage information

Commands:
  install <version>    Installs the specified node version or the latest LTS by default []
  uninstall <version>  Uninstalls the specified node version []
  use <version>        Sets the Node Version []
  list                 Shows the available node versions

nvmfs install --help

Description:
  Installs the specified node version or the latest LTS by default

Usage:
  NvmFs install [<version>] [options]

Arguments:
  <version>  Installs the specified node version []

Options:
  -l, --lts <lts>          Ignores version and pulls down the latest LTS version []
  -c, --current <current>  Ignores version and pulls down the latest Current version []
  -d, --default            Sets the downloaded version as default [default: False]
  -?, -h, --help           Show help and usage information

nvmfs use --help

Description:
  Sets the Node Version

Usage:
  NvmFs use [<version>] [options]

Arguments:
  <version>  Installs the specified node version []

Options:
  -l, --lts <lts>          Ignores version and pulls down the latest LTS version []
  -c, --current <current>  Ignores version and pulls down the latest Current version []
  -?, -h, --help           Show help and usage information

nvmfs uninstall --help

Description:
  Uninstalls the specified node version

Usage:
  NvmFs uninstall [<version>] [options]

Arguments:
  <version>  Installs the specified node version []

Options:
  -?, -h, --help  Show help and usage information

nvmfs list --help

Description:
  Shows the available node versions

Usage:
  NvmFs list [options]

Options:
  -r, --remote <remote>  Displays the last downloaded version index in the console []
  -u, --update <update>  Use together with --remote, pulls the version index from the node website []
  -?, -h, --help         Show help and usage information