Bugfix 🐛

• #368 Update 'ring' to '0.16.17' (@gucheen)
• #347 Check if $ZDOTDIR exists to find correct path to .zshrc (@thales-maciel)

Documentation 📝

• #341 Update installation instructions (@Schniz)
• #329 Add scoop support (@Armaldio)
• #334 Add installation instructions from cargo (@zhmushan)

Committers: 5

• Cheng Gu (@gucheen)
• Gal Schlezinger (@Schniz)
• Quentin Goinaud (@Armaldio)
• Thales Maciel (@thales-maciel)
• 木杉 (@zhmushan)

Documentation 📝

• #327 Make ls and ls-remote aliases visible (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

Bugfix 🐛

• #317 Bring back --using-file flag with a deprecation warning. (@bjornua)

Committers: 1

• Bjørn Arnholtz (@bjornua)

New Feature 🎉

• #304 Make the first installed version the default one (@Schniz)

Bugfix 🐛

• #308 Allow unsuccessful symlink deletion in fnm use (@Schniz)
• #303 Add ARM handling to installation script (@Schniz)
• #289 Remove logs from automatic version switching in --use-on-cd (@maxjacobson)
• #301 UserVersion: Fix different parsing for leading v (@Schniz)

Documentation 📝

• #306 Throw an error instead of panicking when can't infer shell (@Schniz)
• #297 Update CI badge (@jameschensmith)

Committers: 3

• Gal Schlezinger (@Schniz)
• James Chen-Smith (@jameschensmith)
• Max Jacobson (@maxjacobson)

Introducing... Windows Support! 🕺 💃

fnm has been reimplemented in Rust, and added the awaited Windows support request:

• All e2e tests are running on Windows using PowerShell
• There are some e2e tests that are running on WinCmd, but all features work. Writing the DSL adapters was a little hard for someone with that little Batch scripting knowledge. Feel free to help out!

I've been using the Rust implementation for a while and it didn't fail me, but we'll keep it in beta for a while.

Changelog

1.22.0 (2020-10-07)

New Feature 🎉

• #244 Allow using homebrew to install with the installation script (@Schniz)

Bugfix 🐛

• #225 Remove unused condition (@joliss)

Internal 🛠

• #246 Rewrite fnm in Rust (merge fnm.rs into fnm) — adding Windows support! (@Schniz)
• #243 Add installation script testing (@Schniz)

Documentation 📝

• #247 fixed a typo (@0xflotus)
• #245 Shorten the installation script (@Schniz)
• #237 docs: add explanation of uninstall command to README (@kazushisan)
• #235 Mention fnm omf plugin for Fish users (@idkjs)

Committers: 5

• 0xflotus (@0xflotus)
• Alain Armand (@idkjs)
• Gal Schlezinger (@Schniz)
• Jo Liss (@joliss)
• Kazushi Konosu (@kazushisan)

New Feature 🎉

• #220 Add current command to retrieve the current Node version (@vladimyr)
• #210 Allow aliasing and removing an alias (@Schniz)

Bugfix 🐛

• #217 Set version on new shell initialization in fish (@jaredramirez)
• #207 Format dotfiles versions before comparison (@amitdahan)

Committers: 4

• Amit Dahan (@amitdahan)
• Dario Vladović (@vladimyr)
• Gal Schlezinger (@Schniz)
• Jared Ramirez (@jaredramirez)

v1.20.0 (2020-03-22)

New Feature 🎉

• #201 Create alias from version range (Closes #185) (@tatchi)

Bugfix 🐛

• #199 Fix typo criterias -> criteria (@waldyrious)

Documentation 📝

• #204 Improve eval expression in README.md (@loliee)

New Feature 🎉

• #194 Add fnm exec to run commands with the fnm environment (@Schniz)
• #191 uninstall allows prefix (Closes #121) (@tatchi)
• #190 Version filtering in ls-remote (@tatchi)

Bugfix 🐛

• #200 Do not repeat installation prompt for unrecognized versions (@tatchi)
• #197 Fix capitalization of message in Use.re (@waldyrious)

Internal 🛠

• #202 Update rely (@tatchi)
• #192 Bump ocaml to 4.08 (@tatchi)

Committers: 3

• Corentin Leruth (@tatchi)
• Gal Schlezinger (@Schniz)
• Waldir Pimenta (@waldyrious)

This version fixes an issue derived from using Lwt 5 in a wrong way, causing fnm to show OCaml error messages every time it tried to exit with a status other than 0 (or, in a failed state)

Bugfix 🐛

• #182 Closes #181 by dropping exit(1) (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

Highlight

Regarding #173 #174 and #177, this version stops compiling libgmp with custom machine code for Intel ADX. This should make fnm run smoothly on most CPU architectures. See more in #177 and let me know if there are more issues with it.

Changelog

New Feature 🎉

• #176 Specify the release to the install script (@chrisdaley)

Bugfix 🐛

• #177 Fix "illegal instruction" errors on some CPUs (@Schniz)

Internal 🛠

• #179 Bump lwt version (@Schniz)

Committers: 2

• Chris Daley (@chrisdaley)
• Gal Schlezinger (@Schniz)

Critical change

moving from ocaml-ssl to ocaml-tls, dropping OpenSSL in favor of a pure OCaml implementation. This results in no certificate errors, smaller file size for Linux and no dynamic linking problems on macOS.

Thanks to everyone who chimed in on #170 and #110

Changelog 🔦

Bugfix 🐛

• #169 Support spaces in directory name in Bash (@Schniz)

Internal 🛠

• #172 Revert into using ocaml-tls instead of ocaml-ssl (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

New Feature 🎉

• #146 Add support for lts/* (@Schniz)

Bugfix 🐛

• #150 Add missing log level to env output for Fish shell (@thomsj)

Internal 🛠

• #154 Run all feature tests (@Schniz)
• #148 Make env smoke test pass when run with fish (@thomsj)
• #153 Add missing exit 1s to partial_semver tests (@thomsj)
• #151 Add a CI check for code formatting (@Schniz)
• #149 Update to v6.17.1 in partial_semver feature test (@thomsj)
• #143 Try to install new deps (@Schniz)
• #142 Drop buildsInSource (@Schniz)

Documentation 📝

• #157 Rename --base-dir to --fnm-dir in README (@thomsj)
• #158 Uncapitalise "Node" in --multi description (@thomsj)

Committers: 2

• Gal Schlezinger (@Schniz)
• @thomsj

Bugfix 🐛

• #138 Do uninstallation in steps (@Schniz)

Documentation 📝

• #132 Fix spelling of availability in install.sh (@trevershick)

Committers: 2

• Gal Schlezinger (@Schniz)
• Trever Shick (@trevershick)

v1.14.0 (2019-08-20)

New Feature 🎉

• #134 Alias -v to --version (@Schniz)

Bugfix 🐛

• #131 Deprecates MacOS installation using the script in favor of Homebrew (@Schniz)

Internal 🛠

• #133 Fix Windows build once again! (@Schniz)

Highlight 🔦

Support for lts/* has landed. Now you can refer to the latest Node v10 as lts/dubnium and both use and install will understand that. Moreover, fnm install latest creates an alias named latest so you can use it without thinking about the exact version.

Changelog 📝

New Feature 🎉

• #129 Alias latest versions on installation (@Schniz)

Bugfix 🐛

• #125 format versions in uninstall (@Schniz)
• #114 installation script: use $INSTALL_DIR instead of hard-coded $HOME/.fnm (@Schniz)

Documentation 📝

• #130 Fix issues related to help pages (@Schniz)
• #123 Fix typo in successfully (@pavelloz)
• #118 Add note about upgrading (@pavelloz)
• #119 Remove "Homebrew" from future plans as it is done (@pavelloz)

Committers: 2

• Gal Schlezinger (@Schniz)
• Paweł Kowalski (@pavelloz)

Highlight 🔦

@dangdennis has added a fnm default command that aliases to alias default, so it is more convenient to set a default version! Thanks Dennis!

Changelog 📝

New Feature 🎉

• #106 Add default, as a shortcut for alias default (@dangdennis)
• #104 Add a 'debug' log level (@Schniz)

Internal 🛠

• #88 Successfully build on Windows (@ulrikstrid)

Committers: 3

• Dennis Dang (@dangdennis)
• Gal Schlezinger (@Schniz)
• Ulrik Strid (@ulrikstrid)

Highlights 🔦

• We now have an uninstall command thanks to the amazing @tatchi!
• Binary size has dropped significantly thanks to @ulrikstrid and the migration to base. This takes us a little further in supporting Windows!
• System versions of Node can be used by fnm use system

Changelog 📝

New Feature 🎉

• #98 Add uninstall command (@tatchi)
• #97 Add the ability to use system version of Node (@Schniz)

Bugfix 🐛

• #103 Fix missing aliases due to newer realpath (@Schniz)
• #99 fix EACCES error when installing an already downloaded version (@tatchi)

Internal 🛠

• #101 Move from base to core (@ulrikstrid)
• #102 Implement realpath instead of binding to C library (@Schniz)
• #100 Add Semver to library, an simple non-spec implementation of semver (@Schniz)

Committers: 3

• Corentin Leruth (@tatchi)
• Gal Schlezinger (@Schniz)
• Ulrik Strid (@ulrikstrid)

Highlight 🔦

@ohana54 has added a global log level option:

eval "$(fnm env --multi --log-level=quiet)"

Changelog 📝

New Feature 🎉

• #93 Add support for log level (Closes #33) (@ohana54)

Documentation 📝

• #95 Shorten installation script url (@vladimyr)

Committers: 2

• Dario Vladović (@vladimyr)
• Tomer Ohana (@ohana54)

v1.9.1 (2019-04-14)

Bugfix 🐛

• #91 Fix fnm env for fish shell. (@hwartig)
• #90 Installation script doesn't use GitHub API, but a link to the latest directly (@Schniz)

Committers: 2

• Gal Schlezinger (@Schniz)
• Harald Wartig (@hwartig)

Highlight 🔦

fnm will now ask if you want to install the provided version if it isn't already

Changelog 📝

New Feature 🎉

• #86 Add support for interactive installation for use (@Schniz)

Documentation 📝

• #85 Update README.md (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

Binaries are now much smaller due to stripping of the debugging metadata (~30-40% smaller!)

Bugfix 🐛

• #83 fix: remove unmatched quote written in the fish config file (@ThomasMarcel)

Internal 🛠

• #84 Strip binaries to make them smaller (@Schniz)

Bugfix 🐛

• #79 Guard from more non-existent directories errors (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

Highlight 🔦

use-on-cd now works with .node-version files on Zsh, thanks to a bug that was fixed by @johnletey and reported by @MoOx. Thanks friends! This path is now fully tested

Changelog 📝

Bugfix 🐛

• #77 Fix "command not found: elsif" error (@johnletey)

Internal 🛠

• #78 Add a test to use-on-cd when .node-version is found (@Schniz)

Committers: 2

• Gal Schlezinger (@Schniz)
• John Letey (@johnletey)

Changelog

Bugfix 🐛

• #72 Fix alias paths (@Schniz)

Documentation 📝

• #70 Fix installation script parameters docs (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

Highlight 😳

Fixed a bug for the version inference (completion of the latest installation/version installed), happened by dropping curl for cohttp

Changelog

Bugfix 🐛

• #69 Fix version inference by throwing on http 404 again (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

Bugfix 🐛

• #61 Fix a bug where fnm env --multi didn't used the default alias (@Schniz)

Committers: 1

• Gal Schlezinger (@Schniz)

New features 🎉

• .node-version file support (#42, by @Dean177)
• fnm use exits with exit code 1 on errors now (#45, by @Schniz)

Docs

• Fix development setup guide (#44, by @AdamGS)

• Now licensed as GPLv3. It shouldn't do anything to your current workflow, but I believe this is the only license available based on the dependencies. I'm not a legal expert though, so please let me know if I'm wrong. (#22)

Feature list 🎉

• Skip installation if version already installed (#27, by @kentac55)
• Multi-shell and aliases support (#30, by @Schniz)
• Support Node.js mirrors (#36, by @Schniz - thanks @haishanh for opening the issue!)

Big stuff 🎉

Multi-shell support

By changing the line below, you can now start using fnm with different Node versions on each shell.

- eval `fnm env`
+ eval `fnm env --multi`

It means you can now have different versions for different projects and work in parallel in splits/tabs of your favorite terminal.

Aliases

A simple way of calling a version in a name:

fnm install v8.11.3
fnm alias v8.11.3 stable
fnm use stable # like `fnm use v8.11.3`

Bugfix: make sure installer script works on Linux (thanks @drazik!)

• Use .xz files instead of .gz (#17)
• Make --version show the correct version (#16)
• Fix throwing error on nonexistent directory when running fnm ls (#15)