Installing and Updating Packages

This chapter covers the commands you will use most often after discovering a package: install and update.

In the examples below, replace placeholders such as <package-name>, <version>, <registry-id>, and <manifest-path> with real values.

Install packages from package registries

Install a package by name:

foton install <package-name>

Install multiple packages at once:

foton install <package-name-1> <package-name-2>

Install a specific version:

foton install <package-name>@<version>

By default, foton resolves packages from the package registries enabled in your configuration. When resolving a package by name, it does not consider pre-release versions unless you pass --pre-release. To resolve packages only from specific package registries, pass --registry.

foton install --registry <registry-id-1>,<registry-id-2> <package-name>

Install packages from manifest files

install can also install packages defined in local manifest files. This is mainly useful when authoring or testing packages.

foton install --manifest <manifest-path>

You can specify --manifest multiple times. Do not combine --manifest with --registry, --pre-release, or package names.

For more details, see Writing a Package Manifest.

Update installed packages

Update every installed package that has a newer version available:

foton update

Update only selected packages:

foton update <package-name-1> <package-name-2>

You can also select an exact installed version first:

foton update <package-name>@<version>

When you specify an exact version, update selects the matching installed package first, then looks for a newer version of the same package name. By default, update does not look for pre-release versions. Use --pre-release if you want pre-release updates to be considered.

If you want to control which package registries are used to find updates, pass --registry.

foton update --registry <registry-id-1>,<registry-id-2> <package-name>

Confirmation prompts

Commands that change installed packages ask for confirmation before applying changes. If you want to skip the prompt, pass the global --no-confirm option.

foton --no-confirm install <package-name>

foton --no-confirm update

Notes

If an install request does not require any changes, foton reports that the package is already installed.
If an update request does not require any changes, foton reports that the selected packages are already up to date.
If an install or update does not complete cleanly, use foton repair to clean up any packages left behind.
Package installation and update operate on package definitions, not on individual font files.

Keyboard shortcuts