Documentation
Guides
Quick Reference

FVM Quick Reference

Essential Commands

CommandDescriptionExample
fvm use [version]Set project SDK versionfvm use 3.19.0
fvm install [version]Download SDK versionfvm install stable
fvm listShow installed versionsfvm list
fvm global [version]Set system defaultfvm global 3.19.0
fvm flutter [cmd]Run Flutter commandsfvm flutter doctor
fvm dart [cmd]Run Dart commandsfvm dart pub get

Version Formats

FormatExampleDescription
Release3.19.0Specific version number
ChannelstableLatest from channel
Commitfa345b1Git commit hash
Forkmyco/stableCustom repository

Common Options

OptionCommandsPurpose
--forceuse, globalSkip validation
--pinusePin channel version
--flavoruseSet flavor version
--setupinstallRun Flutter setup
--skip-pub-getuse, installSkip dependencies

Workflows

New Project Setup

cd myproject
fvm use 3.19.0

Switch Versions

fvm use 3.16.0 --force

Test Multiple Versions

fvm spawn 3.19.0 test
fvm spawn 3.16.0 test

Custom Fork

fvm fork add myco https://github.com/myco/flutter.git
fvm use myco/stable

File Structure

myproject/
├── .fvm/
│   ├── flutter_sdk → ../../../.fvm/versions/3.19.0
│   └── fvm_config.json
├── .fvmrc
└── .gitignore (updated)

Environment Variables

  • FVM_CACHE_PATH - Custom cache directory
  • FVM_GIT_CACHE_PATH - Git cache location
  • FVM_FLUTTER_URL - Custom Flutter repo

Tips

  • Use fvm doctor to troubleshoot issues
  • Add .fvm/flutter_sdk to .gitignore
  • Commit .fvmrc for team consistency
  • Use --skip-setup for faster switching
  • Enable git cache for faster installs