NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1008 most downloaded on pub.dev
A simple cli to manage Flutter SDK versions per project. Support channels, releases, and local cache for fast switching between versions.
Latest stable
4.3.2
Last release 1 months ago
15 Oct 2026
Release timing varies
gaps range from 8 days to 10 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
145 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
fix: preserve live command input/output, exit status, and Ctrl+C cleanup when falling back to the system PATH without a project or global SDK selectio
btwld/fvm (#1078)See the full changelog for changes in earlier releases.
fix: wait for proxied Flutter commands to finish cleanup after Ctrl+C before FVM exits with status 130, preventing terminals from being left in raw mo
Your coding agent can read these notes before it upgrades. Set up the MCP server →
pub_updater 0.4 and 0.5 in dependency resolution while retaining Dart 3.6 compatibility (#1022)See the full changelog for changes in earlier releases.
feat: add fvm cleanup to preview unused cached SDKs and exact same-line stable patch upgrades, and to remove unused versions with --remove-unused . Re
fvm cleanup to preview unused cached SDKs and exact same-line stable patch upgrades, and to remove unused versions with --remove-unused. Recommended upgrade targets stay cached until a project or global pin moves; fvm list Unused now points herefvm api cleanup with upgrades, unused, and removable. unused matches fvm list Unused and fvm api list unreferencedVersions; removable is what --remove-unused would deletefvm list has no local project version to markSee the full changelog for changes in earlier releases.
feat: add a Projects column to fvm list that shows how many known projects pin each cached SDK. Versions that no known project pins and that are not s
Projects column to fvm list that shows how many known projects pin each cached SDK. Versions that no known project pins and that are not selected globally are labeled Unused. FVM records projects after fvm use or fvm install and reads their current .fvmrc values when listingfvm api list as projects and unreferencedVersionsmyfork/3.24.0@beta to the installed myfork/3.24.0 SDK in the Local and Projects columnsSee the full changelog for changes in earlier releases.
perf: skip git-cache maintenance when running Flutter or Dart through an already-installed SDK
See the full changelog for changes in earlier releases.
docs: record how the repo migration broke the release pipeline
Moving the repository between accounts left the release tool naming an
owner that only redirected. GitHub keeps those redirects alive, and
cli_pkg does not follow them on POST, so pkg-github-release failed with
307 Moved Permanently after every test job had already passed and the
v4.1.3 deploy published nothing.
The repository is back on leoafarias, so the owner constant itself is
correct and unchanged here. This only records why it is load-bearing, so
the next account move updates it deliberately instead of rediscovering
this through a failed release.
The 4.1.3 tag never published anything: the deploy failed at the GitHub
release step because the repository had moved accounts, so pub.dev,
Homebrew, Chocolatey, Docker and the binaries were all skipped. Releasing
the same changes as 4.1.4 rather than reusing the unpublished 4.1.3 tag.
GIT_DIR, GIT_WORK_TREE, GIT_INDEX_FILE, and the rest of the git rev-parse --local-env-vars set) when it runs git, flutter, or dart. Tools launched through FVM from inside a git hook, such as fvm dart run in a pre-commit hook, no longer see the hook's repository variables and will read the real index instead of the hook's staged index. Transport and auth variables like GIT_SSH_COMMAND and GIT_ASKPASS are preserved. (#1060)See the full changelog for changes in earlier releases.
fix: stop rebuilding the git cache on every command when macOS leaves .DS_Store files in it
.DS_Store files in it (#1043)See the full changelog for changes in earlier releases.
Bumps version to 4.1.2 and finalizes the CHANGELOG.
fix: prevent git cache bloat and stale SDK installs caused by outdated cache clones
See the full changelog for changes in earlier releases.
feat: opt out of update checks for quieter CI and offline runs
See the full changelog for changes in earlier releases.
feat: migrate install script to v2 with user-local default install
.fvm/fvm_config.json file loading (#996)See the full changelog for changes in earlier releases.
fix: remove leading newline from fvm dart/flutter output
See the full changelog for changes in earlier releases.
fix: preserve all project settings on fvm install
See the full changelog for changes in earlier releases.
fix: version detection for Flutter 3.38+ (version file removal)
See the full changelog for changes in earlier releases.
add: fvm install now runs setup by default
fvm install now runs setup by defaultfvm doctor crash when version not pinnedSee the full changelog for changes in earlier releases.
add: Manage Flutter SDKs from custom or forked repositories
sdkPath in melos.yamlupdateMelosSettings configuration option to control Melos integration per projectSee the full changelog for changes in earlier releases.
refactor: Restore simple tag-based release workflow (removes complex GitHub release automation)
See the full changelog for changes in earlier releases.
Runtime deprecation warnings - Clear warnings for unsupported environment variables
Excited to announce FVM 4.0.0, a major release that brings enterprise-grade features to Flutter version management. This release introduces fork repository support, modular workflow architecture, and enhanced integrations for teams managing complex Flutter environments.
Manage Flutter SDKs from custom or forked repositories - perfect for enterprise teams with proprietary Flutter modifications.
# Add a fork
fvm fork add mycompany https://github.com/mycompany/flutter.git
# Install from fork
fvm install mycompany/stable
fvm install mycompany/3.19.0
# Use fork version in project
fvm use mycompany/stable
First-class monorepo support with automatic sdkPath management in melos.yaml.
9 new workflows for better separation of concerns and maintainability.
fvm fork commands - Add, remove, and list fork repositories<fork>/<version> formatfvm integration-test command for comprehensive testing~/.fvm/versions/<fork>/<version>updateMelosSettings flag for Melos controlFVM_HOME works as fallback when FVM_CACHE_PATH is not setFVM_GIT_CACHE (deprecated since v3.0.0) is no longer supported
FVM_FLUTTER_URL instead of FVM_GIT_CACHEFVM_HOME is still supported as a fallback for FVM_CACHE_PATH but shows a deprecation warning# Homebrew (recommended)
brew tap leoafarias/fvm
brew install fvm
# Dart pub
dart pub global activate fvm
# Standalone script
curl -fsSL https://fvm.app/install.sh | bash
# Chocolatey
choco install fvm
# Dart pub
dart pub global activate fvm
Update FVM:
brew upgrade fvm # or your package manager
Update environment variables (if used):
FVM_GIT_CACHE with FVM_FLUTTER_URL (required - FVM_GIT_CACHE no longer works)FVM_HOME with FVM_CACHE_PATH (optional - FVM_HOME still works as fallback)For enterprise users - Set up your forks:
fvm fork add company https://github.com/company/flutter.git
fvm use company/stable
This release was made possible by contributions from the Flutter community. Special thanks to everyone who reported issues, submitted PRs, and provided feedback.
Found an issue? Please report it on our issue tracker.
Full Changelog: https://github.com/leoafarias/fvm/compare/3.2.1...4.0.0 See the full changelog for changes in earlier releases.
fix: --fvm-skip-input flag not applying to context
--fvm-skip-input flag not applying to contextfvm list now displays the cache path even if no version is installedSee the full changelog for changes in earlier releases.
add: support for skipping input requests by @Rexios80. Input requests are skipped when the --fvm-skip-input flag is passed.
--fvm-skip-input flag is passed.See the full changelog for changes in earlier releases.
Display the configured version in the fvm list command by @digoreis
fvm list command by @digoreisSee the full changelog for changes in earlier releases.
Improved messages when nested .fvmrc file is found.
See the full changelog for changes in earlier releases.
Improved mirror creation logging
See the full changelog for changes in earlier releases.
Disable git cache on CI environment by @leoafarias
See the full changelog for changes in earlier releases.
Fixed: Version weight handles custom versions properly by @quyenvsp
See the full changelog for changes in earlier releases.
Fixed: fvm api context command not been parsed correctly by @leoafarias
fvm api context command not been parsed correctly by @leoafariasSee the full changelog for changes in earlier releases.
Fixed: Empty flavors map been added to the project config by @leoafarias
See the full changelog for changes in earlier releases.
Initial release of JSON API, allows for better integration of third-party tools and CI/CD workflows.
See the full changelog for changes in earlier releases.
Improvement: versioned brew formulae by @leoafarias
See the full changelog for changes in earlier releases.
Added: fvm use [version] --force now skips install confirmation prompt by @mrgnhnt96
fvm use [version] --force now skips install confirmation prompt by @mrgnhnt96install and use, --skip-pub-get by @mrgnhnt96See the full changelog for changes in earlier releases.
Adds skipping version mismatch handling when using force or running with a custom fvm version. #653
See the full changelog for changes in earlier releases.
Removed fvm update command. Due to issue with brew and chocolatey install.
fvm update command. Due to issue with brew and chocolatey install.See the full changelog for changes in earlier releases.
Fixed issue when config is found in directory no pubspec.yaml. #638
See the full changelog for changes in earlier releases.
Adds .gitignore even if project is not a git repository. As IDEs and tools use it as a reference for project indexing.
See the full changelog for changes in earlier releases.
Implemented better validation checks for flavors #639
fvm global --unlink #619See the full changelog for changes in earlier releases.
However fvm_config.json is now deprecated in favor of .fvmrc file. FVM will migrate it automatically.
fvm use [version] and fvm install now also create legacy fvm_config.json file for easier 3.0 migration path.fvm_config.json is now deprecated in favor of .fvmrc file. FVM will migrate it automatically.See the full changelog for changes in earlier releases.
fvm flutter command falls back to global fvm version if version not found in directory.
fvm flutter command falls back to global fvm version if version not found in directory.See the full changelog for changes in earlier releases.
Added fallback when cannot validate Flutter SDK version using git tags. #627
See the full changelog for changes in earlier releases.
VsCode settings now supports jsonc (comments, trailing commma)
fvm install command not creating sdk reference #618See the full changelog for changes in earlier releases.
fvm install command not creating sdk reference #618Added check on update command for homebrew and chocolatey deployment.
See the full changelog for changes in earlier releases.
Removed validation for long commit hashes. FVM will now accept any length hash that git can return as a reference.
See the full changelog for changes in earlier releases.
Fixed Dart SDK download on brew installations.
See the full changelog for changes in earlier releases.
You can now use fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description f…
flutter, commands instead of fvm flutterfvm in unpriviledge mode, it will not require admin rights to run, however local Flutter SDK project references will be absolute paths instead of relative links.fvm flutter command proxy.fvm doctor command. Now provides much better output and information about the project and environment.fvm releases output.fvm list output.fvm global command.--update-check flag on fvm configfvm releases now defaults to stable channel. Use --all flag to see all releases, or filter by channel.fvm use {flavor}fvm remove --all.fvmrc instead of .fvm/fvm_config.json, and .fvm can be added to .gitignore, FVM will migrate it automatically.fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description for environment specific settings than flavor.commit hash, hash needs ot be 10 digits. FVM will now validate it, and provide the correct hash if it can..fvmrc instead of .fvm/fvm_config.json. FVM will migrate it automatically. However .fvm should be ignored, if you depend on fvm_config.json in your tools or CI, you should update your configuration.fvm install - Will not setup by default. Use --setup flag to setup Flutter SDK. Flag --skip-setup is removed.fvm releases - Defaults to stable releases. Use --all flag to see all releases, or filter by channel using --channel {channel}.fvm flavor - Removed in favor of fvm use {flavor}.fvm use - Will always setup by default. Use --skip-setup flag to skip setup.FVM_HOME is now FVM_CACHE_PATH.FVM_GIT_CACHE is now FVM_FLUTTER_URL.See the full changelog for changes in earlier releases.
You can now use fvm use {version} --env {flavor} as an alias for flavor. It might be deprecated since env has become a better description for environm…
flutter, commands instead of fvm flutterfvm in unprivileged mode, it will not require admin rights. However, local Flutter SDK project references will be absolute paths instead of relative links.fvm flutter command proxy.fvm doctor command. Now, it provides much better output and information about the project and environment.fvm releases output.fvm list output.fvm global command.--update-check flag on fvm config.The command fvm releases now defaults to the stable channel. Use the --all flag to see all releases or filter by channel.
fvm use {flavor}.fvm remove --all.
The Configuration file is now .fvmrc instead of .fvm/fvm_config.json, and .fvm can be added to .gitignore. FVM will migrate it automatically.fvm use {version} --env {flavor} as an alias for flavor. It might be deprecated since env has become a better description for environment-specific settings than flavor.commit hash, the hash must be ten digits. FVM will now validate it and provide the correct hash if it can..fvmrc instead of .fvm/fvm_config.json. FVM will migrate it automatically. However, .fvm should be ignored; if you depend on fvm_config.json in your tools or CI, you should update your configuration.fvm install - This will not be set up by default. Use the --setup flag to set up Flutter SDK. The flag --skip-setup is removed.fvm releases - Defaults to stable releases. Use the --all flag to see all releases, or filter by channel using --channel {channel}.fvm flavor - Removed in favor of fvm use {flavor}.fvm use - Will always be set up by default. Use the --skip-setup flag to skip setup.FVM_HOME is now FVM_CACHE_PATH.FVM_GIT_CACHE is now FVM_FLUTTER_URL.See the full changelog for changes in earlier releases.
You can now use fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description f…
flutter, commands instead of fvm flutterfvm in unpriviledge mode, it will not require admin rights to run, however local Flutter SDK project references will be absolute paths instead of relative links.fvm flutter command proxy.fvm doctor command. Now provides much better output and information about the project and environment.fvm releases output.fvm list output.fvm global command.--update-check flag on fvm configfvm releases now defaults to stable channel. Use --all flag to see all releases, or filter by channel.fvm use {flavor}fvm remove --all.fvmrc instead of .fvm/fvm_config.json, and .fvm can be added to .gitignore, FVM will migrate it automatically.fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description for environment specific settings than flavor.commit hash, hash needs ot be 10 digits. FVM will now validate it, and provide the correct hash if it can..fvmrc instead of .fvm/fvm_config.json. FVM will migrate it automatically. However .fvm should be ignored, if you depend on fvm_config.json in your tools or CI, you should update your configuration.fvm install - Will not setup by default. Use --setup flag to setup Flutter SDK. Flag --skip-setup is removed.fvm releases - Defaults to stable releases. Use --all flag to see all releases, or filter by channel using --channel {channel}.fvm flavor - Removed in favor of fvm use {flavor}.fvm use - Will always setup by default. Use --skip-setup flag to skip setup.FVM_HOME is now FVM_CACHE_PATH.FVM_GIT_CACHE is now FVM_FLUTTER_URL.See the full changelog for changes in earlier releases.
You can now use fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description f…
flutter, commands instead of fvm flutterfvm in unpriviledge mode, it will not require admin rights to run, however local Flutter SDK project references will be absolute paths instead of relative links.fvm flutter command proxy.fvm doctor command. Now provides much better output and information about the project and environment.fvm releases output.fvm list output.fvm global command.--update-check flag on fvm configfvm releases now defaults to stable channel. Use --all flag to see all releases, or filter by channel.fvm use {flavor}fvm remove --all.fvmrc instead of .fvm/fvm_config.json, and .fvm can be added to .gitignore, FVM will migrate it automatically.fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description for environment specific settings than flavor.commit hash, hash needs ot be 10 digits. FVM will now validate it, and provide the correct hash if it can..fvmrc instead of .fvm/fvm_config.json. FVM will migrate it automatically. However .fvm should be ignored, if you depend on fvm_config.json in your tools or CI, you should update your configuration.fvm install - Will not setup by default. Use --setup flag to setup Flutter SDK. Flag --skip-setup is removed.fvm releases - Defaults to stable releases. Use --all flag to see all releases, or filter by channel using --channel {channel}.fvm flavor - Removed in favor of fvm use {flavor}.fvm use - Will always setup by default. Use --skip-setup flag to skip setup.FVM_HOME is now FVM_CACHE_PATH.FVM_GIT_CACHE is now FVM_FLUTTER_URL.See the full changelog for changes in earlier releases.
You can now use fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description f…
flutter, commands instead of fvm flutterfvm in unpriviledge mode, it will not require admin rights to run, however local Flutter SDK project references will be absolute paths instead of relative links.fvm flutter command proxy.fvm doctor command. Now provides much better output and information about the project and environment.fvm releases output.fvm list output.fvm global command.--update-check flag on fvm configfvm releases now defaults to stable channel. Use --all flag to see all releases, or filter by channel.fvm use {flavor}fvm remove --all.fvmrc instead of .fvm/fvm_config.json, and .fvm can be added to .gitignore, FVM will migrate it automatically.fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description for environment specific settings than flavor.commit hash, hash needs ot be 10 digits. FVM will now validate it, and provide the correct hash if it can..fvmrc instead of .fvm/fvm_config.json. FVM will migrate it automatically. However .fvm should be ignored, if you depend on fvm_config.json in your tools or CI, you should update your configuration.fvm install - Will not setup by default. Use --setup flag to setup Flutter SDK. Flag --skip-setup is removed.fvm releases - Defaults to stable releases. Use --all flag to see all releases, or filter by channel using --channel {channel}.fvm flavor - Removed in favor of fvm use {flavor}.fvm use - Will always setup by default. Use --skip-setup flag to skip setup.FVM_HOME is now FVM_CACHE_PATH.FVM_GIT_CACHE is now FVM_FLUTTER_URL.See the full changelog for changes in earlier releases.
You can now use fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description f…
flutter, commands instead of fvm flutterfvm in unpriviledge mode, it will not require admin rights to run, however local Flutter SDK project references will be absolute paths instead of relative links.fvm flutter command proxy.fvm doctor command. Now provides much better output and information about the project and environment.fvm releases output.fvm list output.fvm global command.--update-check flag on fvm configfvm releases now defaults to stable channel. Use --all flag to see all releases, or filter by channel.fvm use {flavor}fvm remove --all.fvmrc instead of .fvm/fvm_config.json, and .fvm can be added to .gitignore, FVM will migrate it automatically.fvm use {version} --env {flavor} as an alias for flavor. Might be deprecated in the future since env has become a better description for environment specific settings than flavor.commit hash, hash needs ot be 10 digits. FVM will now validate it, and provide the correct hash if it can..fvmrc instead of .fvm/fvm_config.json. FVM will migrate it automatically. However .fvm should be ignored, if you depend on fvm_config.json in your tools or CI, you should update your configuration.fvm install - Will not setup by default. Use --setup flag to setup Flutter SDK. Flag --skip-setup is removed.fvm releases - Defaults to stable releases. Use --all flag to see all releases, or filter by channel using --channel {channel}.fvm flavor - Removed in favor of fvm use {flavor}.fvm use - Will always setup by default. Use --skip-setup flag to skip setup.FVM_HOME is now FVM_CACHE_PATH.FVM_GIT_CACHE is now FVM_FLUTTER_URL.See the full changelog for changes in earlier releases.
Filter out Mac releases based on architecture.
See the full changelog for changes in earlier releases.
Upgraded minimum Dart version to 2.17.0 for better Flutter 3.0 compatibility
See the full changelog for changes in earlier releases.
Update Flutter releases endpoint
See the full changelog for changes in earlier releases.
Implemented fvm exec command. Execute terminal commands with the configured Flutter/Dart SDK version in the environment. - Use command will install co
fvm exec command. Execute terminal commands with the configured Flutter/Dart SDK version in the environment. - Use command will install configured version by default if not version is provided.See the full changelog for changes in earlier releases.
fvm exec command. Execute terminal commands with the configured Flutter/Dart SDK version in the environment.fvm use command will install configured version by default if no version is provided.Implemented fvm exec command. Execute terminal commands with the configured Flutter/Dart SDK version in the environment. - Use command will install co
fvm exec command. Execute terminal commands with the configured Flutter/Dart SDK version in the environment. - Use command will install configured version by default if not version is provided.See the full changelog for changes in earlier releases.
Fixed issue with routing to older Dart SDK directory path (before 1.17.5)
See the full changelog for changes in earlier releases.
Clean dart command output stdout #361 - Better experience when running dart pub cache repair #352 - Dart proxy points to correct path when version is
dart pub cache repair #352 - Dart proxy points to correct path when version is older than 1.20.0 #348 - Flavors sequence of command causes null check exception #358See the full changelog for changes in earlier releases.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Clean dart command output stdout #361 - Better experience when running dart pub cache repair #352 - Dart proxy points to correct path when version is
dart pub cache repair #352 - Dart proxy points to correct path when version is older than 1.20.0 #348 - Flavors sequence of command causes null check exception #358See the full changelog for changes in earlier releases.
Ensures SDK is setup when running use command.
use command.See the full changelog for changes in earlier releases.
Fix archive url from release info
See the full changelog for changes in earlier releases.
One column per quarter.