btwld /fvm
Flutter Version Management: A simple CLI to manage Flutter SDK versions.
★ 5,542⑂ 283👁 24⑃ 473● 580▤ 130
-1
日增长
5,542
stars
283
forks
24
watchers
473
prs
580
issues
130
releases
README
fvm !GitHub stars FVM manages Flutter SDK versions per project. Switch between Flutter versions instantly without reinstalling, making it easy to test new releases and maintain consistent builds across your team. Why FVM? - Need for simultaneous use of multiple Flutter SDKs. - SDK testing requires constant channel switching. - Channel switches are slow and need repeated reinstalls. - Difficulty managing the latest successful SDK version used in an app. - Flutter's major updates demand total app migration. - Inconsistencies occur in development environments within teams. For more information, read the Getting Started guide. Release Process (For Maintainers) FVM uses GitHub releases to trigger automated deployments across all platforms: Creating a New Release 1. Ensure main branch is ready - All changes merged and tested - Version will be set automatically from release tag 2. Create GitHub Release - Go to GitHub Releases - Click "Create a new release" - Choose tag: v4.0.0-beta.2 (follows semver with 'v' prefix) - Write release notes in GitHub editor - Click "Publish release" 3. Automated Deployment - release.yml triggers automatically - Deploys to: pub.dev, GitHub binaries, Homebrew, Chocolatey, Docker - Monitor progress in Actions tab Dart SDK requirements: Day-to-day development now targets the repository SDK constraint (=3.6.0 tool/release_tool/ and requires Dart SDK =3.8.0. CI pins this higher tool chain via the RELEASE_DART_SDK environment variable (currently 3.9.0) so it matches the versions packaged for Homebrew and other installers. If you run release tasks locally, switch to a Dart SDK 3.8.0 or newer before executing commands from tool/release_tool/. Emergency Releases For hotfixes or emergency releases: 1. Update version manually in pubspec.yaml 2. Use individual platform workflows via manual dispatch: - deploy_homebrew.yml for Homebrew updates - deploy_docker.yml for Docker deployment - Individual platform deployments as needed For complete emergency deployment, create a GitHub release as normal. See Workflow Documentation for detailed information. Contributors --- Checkout Flutter Sidekick. Read more about it here. Troubleshooting Please view our FAQ. License This project is licensed under the MIT License; see LICENSE file for details.
Top issues
#689[BUG] Version 3.0 broke shell completion and is less readable10 comments · 2024-03-11#757[Feature Request] Add support to shorebird8 comments · 2024-07-31#767[BUG] Android Studio cannot change the project's Flutter SDK path7 comments · 2024-08-26#681[Enhancement] Maintain project reference to cache versions after switch7 comments · 2024-03-04#577[Feature Request] Use the flutter version defined in pubspec.yaml when running `fvm install`5 comments · 2023-12-01#1009Custom fork issues4 comments · 2026-01-02#826[Feature Request] Add package to Winget4 comments · 2025-02-25#635[BUG] `fvm use` makes unrelated changes to settings.json.4 comments · 2024-02-20
Discussions
#1010Is there any equivalent of `uv run` for fvm?1 comments · 2026-01-11#951How do I update a particular channel?1 comments · 2025-10-31#950Why does my beta need a setup? and why doesn't the beta have a release date?3 comments · 2025-10-31#896FVM and pubspec.lock1 comments · 2025-07-20#844Drawbacks of not having a global Flutter version?0 comments · 2025-05-10#817How to use fvm in a flutter-pre-installed docker container without reinstalling flutter?0 comments · 2025-01-30#804Hot reload from terminal1 comments · 2024-12-13#795Posix compliant scripts0 comments · 2024-11-07
Latest release
fvm 4.3.2 4.3.2 2026-10-15fix: preserve live command input/output, exit status, and Ctrl+C cleanup when falling back to the system PATH without a project or global SDK selection (1080) chore: migrate FVM repository, release metadata fallback, and installer references to btwld/fvm (1078) See the full changelog for changes in earlier releases.