Adastra CLI ✨ is a CLI toolkit built on top of Shopify CLI 3.X, this means that existing Adastra commands are the same as Shopify's. The goal from this package is to allow developers to use one CLI intefrace between the Vite and Shopify development servers.

Please make sure you have these two already set up in your local environment for Adastra CLI to work properly.

• NodeJS >= 14 (Install NodeJS LTS)
• Shopify Theme CLI >= 3.0

Shopify CLI is managed as a set of Node.js packages, To install Shopify CLI for themes, install the @shopify/cli and @shopify/theme Node.js packages globally using the command line and same for adastra-cli as well.

npm install -g @shopify/cli @shopify/theme adastra-cli

Using Yarn/PNPM

yarn global add @shopify/cli @shopify/theme adastra-cli
# pnpm add -g @shopify/cli @shopify/theme adastra-cli

You can install adastra-cli separately with the following command.

npm install -g adastra-cli

Using Yarn/PNPM

yarn global add adastra-cli
# pnpm add -g adastra-cli

To verify that Shopify CLI is installed properly, run the following command (The command returns a version number)

shopify version

Verify Adastra CLI with (The command returns a help message)

adastra --help

To launch Shopify and Vite development server, you can use adastra dev command which support all shopify theme dev flags and arguments. Here is an example:

adastra dev -s example-store.myshopify.com
# same as shopify theme dev -s example-store.myshopify.com

💡 The command will launch two dev servers, the first for Vite at localhost:5173 to server static files from the src directory and the second for Shopify at localhost:9292 to serve your theme.

All commands must run from the root of the theme project.

This Adastra cli was inspired by Shopify Theme CLI made by the Shopify team.

Feel free to check our documentation or jump into our Discord server.