Storeware Docs

The CLI

Running it with npx, signing in, and deploying from CI.

Early access

The CLI and the SDK are not on npm yet, so the commands below do not run for everyone. If you would like to build an app now, tell us.

Run the CLI with npx, from your app's directory. npx fetches it the first time, so there is nothing to install.

npx @storeware/cli <command>

Every command, with its arguments, flags and examples, is in the command reference. Your terminal has the same: npx @storeware/cli help lists the commands, and --help after any command shows its page.

Signing in

npx @storeware/cli login

It shows a code and opens the admin in your browser. Approve the code there, where you are already signed in, and pick the organisation. The sign-in lasts until you log out.

logout ends the sign-in, on the server as well as here. whoami shows who you are, in which organisation, and your apps.

In CI

Make a CI token on the Developer page, for one app. It deploys that app and reads its releases, and nothing else: it reaches no store and cannot make another token. Set it as STOREWARE_CLI_TOKEN and deploy:

STOREWARE_CLI_TOKEN=swdk_... npx @storeware/cli app deploy

A CI token carries the authority of the person who made it, checked on every call, so it ends when they leave the organisation.

On this page