SpectreSkills
← All skills
★

shopify-cli-workflow

v1.0.0

Connect a theme to a real Shopify store with the Shopify CLI and run the build loop — authenticate, live-preview with hot reload, lint, and push. Trigger before building or editing any theme, or when previewing/deploying to a store.

Shopifyshopifyclithemeworkflowdeploy
Install
npx @spectre-apps/skills add shopify-cli-workflow

Writes .claude/skills/shopify-cli-workflow/SKILL.md. Add --user to install globally.

What it does

Shopify CLI workflow

Connect the theme to a real store and get a live preview before writing a line of Liquid. This is the loop to keep on screen while building.

Install & authenticate

  • Install once: npm i -g @shopify/cli@latest; verify with shopify version.
  • Log in against the store: shopify auth login --store your-store.myshopify.com (or pass --store on the first theme dev). A browser opens and the CLI caches the session. If commands start returning 401, re-run auth login.
  • No store yet? Create a free development store in the Shopify Partners dashboard and use its *.myshopify.com domain.

Start a theme

  • Scaffold fresh with shopify-theme-architect and run the CLI inside that folder, or shopify theme init <dir> to start from a reference theme.
  • Editing a live theme instead: shopify theme pull --store … to sync it down.

Live preview — the loop you demo

  • shopify theme dev --store your-store.myshopify.com serves the theme at http://127.0.0.1:9292 with hot reload — saves to .liquid/CSS/JS refresh the browser instantly. It also prints a shareable preview URL and a theme-editor link. Keep this window visible while Claude builds.

Ship it

  • Lint first: shopify theme check (see shopify-theme-check).
  • shopify theme push --unpublished uploads as a new, non-live theme and returns a preview link — the safe default. --theme <id> targets a specific theme; --live publishes. shopify theme list shows ids and roles.

Guardrails

  • Never --live push to a production store without explicit confirmation; prefer --unpublished + the preview link during a build.
  • Keep a .shopifyignore so dev/push never upload node_modules or source assets. One store = one auth session.

Start here, then hand off to shopify-theme-architect to scaffold and the page skills to build.