Skip to content
Flutter Version Management: A simple cli to manage Flutter SDK versions per project
Branch: master
Clone or download
Latest commit 1900666 Jan 3, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode skip: Small code clean up and preparation for some refactoring Jul 25, 2019
bin Pana linting fixes Dec 26, 2019
coverage Improved exception handling and error messages Nov 8, 2019
example Simple example Oct 24, 2019
lib Adjusted type for removeConfig function Jan 3, 2020
test Exception test for check version Dec 26, 2019
.all-contributorsrc docs: update .all-contributorsrc [skip ci] Dec 26, 2019
.gitignore Recursively query the fvm. Oct 16, 2019 Updated changelog Dec 26, 2019
LICENSE Update LICENSE Mar 3, 2019 Update Jan 3, 2020
analysis_options.yaml Fixed linting issues Dec 26, 2019
pubspec.yaml Pana linting fixes Dec 26, 2019


Coverage MIT Licence Awesome Flutter

Flutter Version Management: A simple cli to manage Flutter SDK versions.


  • Configure Flutter SDK version per project
  • Ability to install and cache multiple Flutter SDK Versions
  • Easily switch between Flutter channels & versions
  • Per project Flutter SDK upgrade

Version Management

This tool allows you to manage multiple channels and releases, and caches these versions locally, so you don't have to wait for a full setup every time you want to switch versions.

Also, it allows you to grab versions by a specific release, i.e. 1.2.0. In case you have projects in different Flutter SDK versions and do not want to upgrade.


To Install:

> pub global activate fvm

Read docs for more info on how to run global dart scripts.

And then, for information on each command:

> fvm help

Install a SDK Version

FVM gives you the ability to install many Flutter releases or channels.

> fvm install <version>

Version - use master to install the Master channel and 1.8.0 to install the release.

Use a SDK Version

You can use different Flutter SDK versions per project. To do that you have to go into the root of the project and:

> fvm use <version>

Remove a SDK Version

Using the remove command will uninstall the SDK version locally. This will impact any projects that depend on that version of the SDK.

> fvm remove <version>

List Installed Versions

List all the versions that are installed on your machine.

> fvm list

Change FVM Cache Directory

There are some configurations that allows for added flexibility on FVM.

fvm config --cache-path <path-to-use>

List Config Options

Returns list of all stored options in the config file.

fvm config --ls

Running Flutter SDK

There are a couple of ways you can interact with the SDK setup in your project.

Proxy Commands

Flutter command within fvm proxies all calls to the CLI just changing the SDK to be the local one.

> fvm flutter run

This will run flutter run command using the local project SDK. If no FVM config is found in the project. FMV will recursively try for a version in a parent directory.

Call Local SDK Directly

FVM creates a symbolic link within your project called fvm which links to the installed version of the SDK.

> ./fvm run

This will run flutter run command using the local project SDK.

As an example calling fvm flutter run is the equivalent of calling flutter run using the local project SDK.

Configure Your IDE


Add the following to your settings.json

"dart.flutterSdkPaths": [

Add your IDE instructions here


This project is licensed under the MIT License - see the LICENSE file for details


Thanks goes to these wonderful people (emoji key):

Leo Farias

📖 🤔 💻 💡 👀 🚧 🚇

Ianko Leite



💻 🤔



This project follows the all-contributors specification. Contributions of any kind welcome!

You can’t perform that action at this time.