Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Discovering Packages

Use foton search to find packages that are available in your registries.

In the examples below, replace placeholders such as <query> and <registry-id> with real values.

Search for a package by name:

foton search <query>

Search with multiple query terms:

foton search <query-word-1> <query-word-2>

For multi-term searches, all query terms must match either the package name or the description.

Restrict the search to specific registries

If you want to search only selected package registries, pass --registry with a comma-separated list of package registry IDs.

foton search --registry <registry-id-1>,<registry-id-2> <query>

Control the number of results

By default, foton search shows up to 10 matching packages. Use --limit to change that number.

foton search --limit 20 <query>

Read the results

Search results are printed as package names with versions together with the registry ID that provided the package. If a package has a description, it is shown on the next line.

Example output:

example-font@1.2.3 [example]
  Example font family for UI and coding

By default, search does not include pre-release versions. Use --pre-release if you want search results to include pre-release versions. Once you have found a package you want, install it with foton install.