Skip to content
/ vfox Public
forked from version-fox/vfox

A cross-platform and extendable version manager with support for Java, Node.js, Flutter, .Net & more

License

Notifications You must be signed in to change notification settings

xxnuo/vfox

 
 

Repository files navigation

Logo

VersionFox

Go Report Card GitHub License GitHub Release Discord

[English] [中文文档]

Introduction

vfox is a cross-platform tool for managing SDK versions, extendable via plugins. It allows you to quickly install and switch between different versions of SDKs using the command line.

Why use VersionFox?

  • cross-platform support (Windows, Linux, macOS)
  • single CLI for multiple languages
  • consistent commands to manage all your languages
  • support GlobalProjectSession scopes when switching versions
  • simple plugin system to add support for your language of choice
  • automatically switches runtime versions as you traverse your project
  • shell completion available for common shells (Bash, Zsh, Powershell)
  • it's faster than asdf-vm, and offers more simple commands and genuine cross-platform unification. see Comparison with asdf

Demo

asciicast

Quickstart

For detailed installation instructions, see Quick Start

1. Choose an installation that works for you.

2. ⚠️ Hook vfox into your shell (pick one that works for your shell) ⚠️

echo 'eval "$(vfox activate bash)"' >> ~/.bashrc
echo 'eval "$(vfox activate zsh)"' >> ~/.zshrc
echo 'vfox activate fish | source' >> ~/.config/fish/config.fish

# For PowerShell:
# 1. Open PowerShell Profile:
New-Item -Type File -Path $PROFILE # Just ignore the 'file already exists' error.
Invoke-Item $PROFILE
# 2. Add the following line to the end of your $PROFILE and save:
Invoke-Expression "$(vfox activate pwsh)"

Remember to restart your shell to apply the changes.

3. Add an SDK plugin

$ vfox add nodejs/nodejs

4. Install a runtime

$ vfox install [email protected]

5. Switch runtime

$ vfox use [email protected]
$ node -v
21.5.0

Full Documentation

See vfox.lhan.me for full documentation.

Supported Plugins

If you have installed vfox, you can view all available plugins with the vfox available command.

plugins

For more details, see the version-fox-plugins

Contributors

Thanks to following people who contributed to this project. 🎉🎉🙏🙏

Contributing

Bug reports, contributions and forks are welcome. All bugs or other forms of discussion happen on issues.

See more at CONTRIBUTING.md.

Plugin Contributions, please go to version-fox-plugins.

Star History

Star History Chart

COPYRIGHT

Apache 2.0 license - Copyright (C) 2024 Han Li and contributors

About

A cross-platform and extendable version manager with support for Java, Node.js, Flutter, .Net & more

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 92.3%
  • Inno Setup 3.3%
  • Lua 2.5%
  • Shell 1.6%
  • PowerShell 0.3%