Shopify CLI for apps

Shopify CLI accelerates your app development process with the following features:

• Creates new apps using app templates
• Generates app extensions in your app
• Creates app records in the Partner Dashboard
• Builds your app and extensions, and creates a tunnel to let you preview your work in a development store
• Deploys your app extensions
• Lets you search the Shopify.dev docs

• You've installed Node.js 16 or higher.

• You've installed a Node.js package manager: either npm, Yarn 1.x, or pnpm.

• You've installed Git 2.28.0 or higher.

• You're using the latest version of Chrome or Firefox.

Shopify CLI is managed as a set of Node.js packages:

• @shopify/cli
• @shopify/app

If you're building a Shopify app, then you don't need to install Shopify CLI globally. Instead, these packages should be added as dependencies of your app. Using Shopify CLI this way enables a consistent development experience across environments.

Because Shopify CLI requires a conventional directory structure, if you're creating a new app, then you should run one of the following commands to initialize your app:

Refer to the following tutorials for additional details about creating an app that works with Shopify CLI, or to learn how to work on an existing app that uses Shopify CLI 3.0 or higher:

Create an app

Learn how to set up your app development environment and start building.

Build an app

After creating your app, follow this in-depth tutorial to learn how to add features to your app using Shopify templates, tools, and libraries.

Work on an existing app

Learn how to set up your development environment to collaborate on an app with others.

Refer to the Shopify CLI app command reference to explore the commands available to build apps with Shopify CLI.

To offer a better and more integrated development experience, apps created using Shopify CLI follow a conventional directory structure. This structure allows you to serve and deploy your app and its app extensions at the same time, easily generate new app extensions, and manage all of your app's dependencies in one place.

Learn more about the structure of apps built with Shopify CLI.

If you have an app extension that you want to deploy to Shopify regularly, then you can integrate Shopify CLI into your CI/CD pipeline to programmatically deploy your app components using the deploy command.

Learn more about running Shopify CLI in a CI/CD pipeline.

To upgrade Shopify CLI 3.x to the latest version, run the upgrade command from your app directory:

To check your CLI version, run the version command from your app directory:

If the version command doesn't return a version number, or the upgrade command fails, then you might be using the previous version of Shopify CLI. To work on an existing app with the newest version of Shopify CLI, you need to migrate your app. Alternatively, you can create a new app that uses Shopify CLI as a dependency.

To offer a better and more integrated development experience, apps created Shopify CLI 3.x follow a conventional directory structure and manage your Node-based dependencies for you.

If you have an app that was created using a previous version of Shopify CLI, or without Shopify CLI, then you can migrate your app so you can use the newest version of Shopify CLI.

Anonymous usage statistics are collected by default. To opt out, you can use the environment variable SHOPIFY_CLI_NO_ANALYTICS=1.

Shopify CLI is open source. Learn how to contribute to our GitHub repository.

• Open a GitHub issue - To report bugs or request new features, open an issue in the Shopify CLI repository.
• Shopify Community Forums - Visit our forums to connect with the community and learn more about Shopify CLI development.