Skip to content
FutureBlitz

    Install

    Tools

    fb login

    Signs in to a registry, and keeps its token.

    fb login [options]

    fb login opens the registry’s sign-in page in your browser, and shows a code, which the page shows too. Once you approve it there, fb gets a token and keeps it in the OS’s credential store: Windows’ Credential Manager, the macOS keychain, or the Secret Service on Linux. On a machine without one, FB_CREDENTIALS_FILE names a file to keep it in.

    Once it has the token, it says whose it is:

       Logged in to https://index.futureblitz.dev/ as ada

    --token reads a token made on the package site’s Tokens page from stdin instead. fb asks the registry whose it is first, and keeps it only if the registry takes it; one it doesn’t take is refused, and nothing is kept.

    fb publish, fb yank, and fb owner use the token. FB_REGISTRY_TOKEN, when it’s set, comes before it, as in CI. fb owner’s changes need the owners scope, which the sign-in page leaves unticked unless you tick it.

    Options

    Option
    --registry <name>A registry that project.toml’s [registries] names, or an index’s URL or folder. Without it, futureblitz.dev’s, or the mirror [registries] names for futureblitz, if there is one.
    --tokenReads a token, made on the registry’s dashboard, from stdin
    --color <when>Colors the output: auto, always, or never

    Examples

    fb login
    fb login --registry company

    Report an issue with this page or with FutureBlitz on GitHub.