The Shopify CLI is an official command-line interface tool designed to streamline development for the Shopify platform. It provides a unified set of commands for building, testing, and deploying Shopify applications, themes, and custom functions. Currently stable at version 3.93.2, the CLI maintains a rapid release cadence, often seeing minor version updates weekly or bi-weekly, reflecting active development and continuous feature integration. Its key differentiators include tight integration with the Shopify ecosystem, support for multiple development paradigms (Hydrogen, App Extensions, Themes, Functions), and features like hot-reloading for themes and local development environments for apps, significantly enhancing developer productivity within the Shopify platform. It acts as the primary interface for managing project lifecycle from initialization to deployment for both partners and merchants.
npm install shopifyNo compatibility data collected yet for this library.
This quickstart demonstrates how to initialize a new Shopify application using `shopify app init` and then run it locally with `shopify app dev`. It also outlines how to start theme development and deploy an app.
Remove the `--routes` flag from your `shopify hydrogen init` command invocations. Routes will be automatically generated as part of the new project setup.
Ensure your Node.js environment meets the minimum requirement of `>=20.10.0`. Use a Node.js version manager like `nvm` to easily switch and manage Node.js versions: `nvm install 20 && nvm use 20`.
Be aware that re-authenticating with `shopify store auth` will preserve your existing granted scopes. If you intend to modify scopes, ensure you understand the implications or consult the Shopify CLI documentation for advanced authentication options.
Familiarize yourself with the new Dev Console in the Shopify admin when using `shopify app dev` for debugging and monitoring your app's local development activities. Access it directly from your development store's admin panel.
Upgrade to Shopify CLI version 3.91.0 or newer to resolve `401 Unauthorized` errors on cart AJAX endpoints during theme development, as fixes for this issue were included in that release.
Upgrade Node.js to version 20.10.0 or higher. Use `nvm install 20 && nvm use 20` or your preferred Node.js version manager.
Ensure you have installed the CLI globally using `npm install -g @shopify/cli` or `yarn global add @shopify/cli` and that your npm/yarn global bin directory is included in your system's PATH.
Run `shopify login` to authenticate with your Shopify Partner account, or `shopify auth login --store your-store-name.myshopify.com` to authenticate with a specific development store.
Adjust permissions for the `.shopify` directory in your home folder. For example, `sudo chown -R $(whoami) ~/.shopify` can fix ownership issues. Avoid `chmod 777` unless you understand the security implications.