// the find
Shopify/cli
Build apps, themes, and hydrogen storefronts for Shopify
The official CLI for Shopify app, theme, and Hydrogen storefront development. Handles the full lifecycle: init, dev, deploy, and release across all three Shopify development surfaces. Only useful if you're building on Shopify — there's no general-purpose utility here.
Built on oclif with a well-organized monorepo: each surface (app, theme, Hydrogen) has its own package with typed GraphQL queries auto-generated from schemas, so the API layer is not a guess. The decision records under docs/decision-record/ document real architectural tradeoffs (ESM migration, Nx build graph, IDs persistence) — unusually honest paper trail for an official vendor tool. Changeset-based release management with per-package changelogs means you can track exactly what changed between versions without reading all commits. The .agents/ directory with AI skill definitions for pre-submit CI and issue investigation is a practical use of LLM tooling on the repo itself, not just a gimmick.
708 stars for an official Shopify tool signals this is used but not admired — it works but the DX has historically been rough (slow cold starts, auth flows that break). The Hydrogen CLI actually lives in a separate repo (shopify/hydrogen), so the README's claim to cover Hydrogen is a pointer, not the real code; split ownership makes it easy to fall out of sync. The custom esbuild plugins (dedup, stacktracey, vscode shims) in bin/bundling suggest accumulated workarounds rather than clean architecture — if the build breaks, debugging those plugins is unpleasant. Vendor lock-in is the entire point of the tool, but worth stating plainly: every workflow, auth model, and deploy target is Shopify-specific and gives you nothing transferable.