gem-hunter
Language: TypeScript
Command-line interface allowing interaction with Saleor Cloud environments.
Command-Line Interface for Saleor
Tip
Questions or issues? Check our discord channel for help.
Saleor CLI is designed to boost your productivity and improve development experience with Saleor and Saleor Cloud. It will take the burden of spawning new storefronts and apps locally, managing and connecting them with Saleor instances, or establishing tunnels for local development in seconds.
To install the latest version of Saleor CLI, run the following command:
npm i -g @saleor/cli
You can also use npx to execute the Saleor CLI commands on the spot without installing the package.
npx saleor env list
If you're using
nvm, make sure that theNVM_BINpath is added toPATH
If you're new to Saleor you might want to start by bootstrapping an end-to-end local storefront development environment (and Saleor Cloud sandbox API instance). Since it requires Cloud access, you will be asked to register to a free Saleor Cloud developer account or log in. Then the command will automatically create your new local storefront environment and connect it to a newly created Saleor API instance/sandbox:
saleor storefront create --demo
If you don't have a (free developer) Saleor Cloud account yet, create one with the following command:
saleor register
The saleor binary requires the Cloud API token that can be obtained via OAuth by running the login command:
saleor login
This command will open a browser and ask for your Saleor Cloud credentials. Once logged in, it will store your Cloud API token locally for the CLI to use.
You can now start executing any of the available commands.
Note: in order to log out you can use saleor logout.
The following command will take you through the process of creating a new react-storefront and configuring it with a chosen Saleor Cloud API instance:
saleor store create my-new-storefront
You can create new API endpoints by running:
saleor env create
Please check out the Saleor App Template docs for the latest documentation.
Coming soon 🔌
Usage: saleor <command> [options]
Commands:
saleor info Hello from Saleor
saleor status Show the login status for the systems that CLI depends on
saleor login Log in to the Saleor Cloud
saleor logout Log out from the Saleor Cloud
saleor configure [token] Configure Saleor CLI
saleor register Create a Saleor Cloud account [aliases: signup]
saleor trigger [event] This triggers a Saleor event
saleor organization [command] [aliases: org]
saleor environment [command] [aliases: env]
saleor backup [command]
saleor job [command]
saleor project [command]
saleor storefront [command] [aliases: store]
saleor webhook [command] [aliases: hook]
saleor app [command]
saleor vercel [command]
saleor github [command]
saleor checkout [command]
Options:
--json Output the data as JSON [boolean]
--short Output data as text [boolean] [default: false]
-u, --instance, --url [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]
for more information, find the documentation at https://saleor.io
This project uses pnpm for managing dependencies
pnpm install
pnpm watch
node build/cli.js ...
RUN_FUNCTIONAL_TESTS
Set to true to enable functional tests
DEBUG
Use it for debugging. Set to saleor-cli:* to show debug output for the Saleor CLI only. Set to * to show all debug output.
Commands should be executed locally.
main, e.g.git pull origin main
pnpm tscpnpm bundlesentry-cli login if you intend to upload source mapsrelease-* branch; all release-* branches are protectedgit checkout release/X.Y
where X and Y is the selected version
maingit log --no-merges --cherry-pick --right-only release/X.Y...main
merge commitsgit cherry-pick SHA1 SHA2 SHA3
where SHA1, SHA2, SHA3 are SHAs selected to be included in the upcoming version
git commit -m 'Release X.Y.0'
git tag X.Y.Z
git push origin release/X.Y
git push origin --tags
next tag for the RC versionpnpm publish
or
pnpm publish --tag next
Important
CLI is currently published in an identical form to three packages in npmjs.com:
When releasing a new version, modify name in package.json to saleor-cli and saleor respectively and repeat pnpm publish step.
Do not commit these package.json changes.