otty / apps

All apps/FVM

FVM

fvm

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

Runs as fvm|macOS, Linux, Windows|fvm.app

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

FVM in your home directory Every rule on this page, by file

cachePathgitCachePath

Each machine keeps its own copy of these.

· versions/ Exclude

· cache.git/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/fvm/otty.tomlThe file this page is generated from

id = "fvm"

name = "FVM"

homepage = "https://fvm.app"

description = "Flutter Version Management: A simple CLI to manage Flutter SDK versions."

# The logo fvm.app puts in its own header.

icon = "https://fvm.app/assets/logo.svg"

executables = ["fvm"]

[dotfiles]

# lib/src/utils/constants.dart: kAppConfigFile = join(_configHome, kPackageName,

# kFvmConfigFileName) with kPackageName "fvm" and kFvmConfigFileName ".fvmrc".

# _configHome is %APPDATA% on Windows, <home>/Library/Application Support on

# macOS, and $XDG_CONFIG_HOME or <home>/.config on Linux — the [appData] base

# directory. The file is JSON — LocalAppConfig.read() parses it with

# LocalAppConfig.fromJson.

paths = ["[appData]/fvm/.fvmrc"]

# Same file: kAppDirHome = <home>/fvm is where FVM caches the SDKs, one full

# Flutter checkout per version, plus the git mirror it clones them from.

exclude = ["~/fvm/versions/", "~/fvm/cache.git/"]

secret = []

# Read once while building the effective config for a command.

side_effect = false

# lib/src/models/config_model.dart LocalAppConfig: cachePath is the directory

# this machine keeps the installed SDKs in and gitCachePath the local Flutter

# git mirror — both absolute paths on this disk. flutterUrl, the update-check

# and editor-integration flags are preferences and stay. The user moved those

# two directories themselves — usually to keep a pile of SDKs off the system

# volume — so the values are kept to set this machine up again: backup.

# `.fvmrc` has no extension that names a parser, so the format is declared.

[[dotfiles.machine_lines]]

file = "[appData]/fvm/.fvmrc"

format = "json"

match = { key_path = ["cachePath", "gitCachePath"] }

scope = "backup"

[commands]

format = 1

label = "Manage Flutter SDK versions"

description = "Install, select, list and remove Flutter SDK versions with FVM. Config, flavors and proxied dart/flutter commands are left out."

quality = "ai-draft"

base = "fig:fvm"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fvm.ts"

license = "MIT"

[[commands.subcommand]]

path = ["install"]

label = "Install a Flutter SDK"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fvm.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "version"

label = "Version or channel"

type = "string"

position = 0

suggestions = [{ value = "stable", label = "stable" }, { value = "beta", label = "beta" }, { value = "dev", label = "dev" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "skip_setup"

label = "Skip Flutter setup"

type = "boolean"

option = ["--skip-setup", "-s"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "install"

label = "Install version"

fields = ["version", "skip_setup"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["version", "skip_setup"]

[[commands.subcommand]]

path = ["use"]

label = "Use a version in this project"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fvm.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "version"

label = "Version or channel"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "pin"

label = "Pin latest release of channel"

type = "boolean"

option = ["--pin", "-p"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "force"

label = "Skip project checks"

type = "boolean"

option = ["--force", "-f"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "use"

label = "Use version"

fields = ["version", "pin", "force"]

required = ["version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["version", "pin", "force"]

[[commands.subcommand]]

path = ["remove"]

label = "Remove an installed version"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fvm.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "force"

label = "Skip global version check"

type = "boolean"

option = ["--force"]

effect = "delete"

sources = ["fig"]

[[commands.subcommand.task]]

id = "remove"

label = "Remove version"

fields = ["version", "force"]

required = ["version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["version", "force"]

[[commands.subcommand]]

path = ["list"]

label = "List installed versions"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fvm.ts"

license = "MIT"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/fvm. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits cachePath and gitCachePath for you — that part is Otty’s own sync, or a template you write by hand.