The Wire · Showcase
CLI TOKEN DEBUGGING GETS TEETH, HYDROGEN STOPS NUKING SESSIONS ON BLIPS
By RepoJournal · Filed · About Shopify
Shopify CLI now exposes the actual reason token exchanges fail instead of dead-end error messages, while Hydrogen stops logging out customers when OAuth endpoints hiccup.
The CLI's token exchange failure has been a black box for developers hitting CI walls. Starting today, when an app automation token exchange dies, verbose output includes the OAuth error code and description from Identity's response [1], turning a useless "can't be used for the App Management API" into actionable debugging data. On the Hydrogen side, a transient failure in the Customer Account token refresh endpoint no longer nukes the entire session [2]. The fix distinguishes between transient 5xx errors and network blips, which should be retried, versus genuine credential rejection (4xx), which warrants logout. Polaris documentation infrastructure is being corrected after the repo rename from polaris-react to polaris-react-archive, ensuring the static GitHub Pages export deploys to the right base path [6]. The test suite across CLI continues to expand with comprehensive coverage for ShopifyConfig loaders, path utilities, and abort controllers [3], [4], [5]. Hydrogen storefronts now ship with agent-friendly guidance pointing scaffolded projects toward the Shopify AI Toolkit for LLM-compatible validation [7].
One email a day. Unsubscribe in one click.
Keep up with Shopify in about 3 minutes a day: what actually shipped — the commits, pull requests, releases, and security advisories that matter.
One email a day. Unsubscribe in one click. Read a past issue →
Action items
- → Pull the latest CLI to get token exchange error context in verbose logs Shopify/cli [plan]
- → Update Hydrogen deployments to stop session wipeouts on transient OAuth failures Shopify/hydrogen [plan]
- → Verify Polaris docs deploy to correct GitHub Pages path after repo rename Shopify/polaris [immediate]
References
- [1] Log the reason a token exchange fails in verbose output ↗ Shopify/cli
- [2] Fix customer logout when token refresh fails with transient errors ↗ Shopify/hydrogen
- [3] [Tests] Add unit tests for ShopifyConfig custom oclif loader ↗ Shopify/cli
- [4] Merge pull request #8176 from Shopify/tests-path-coverage-2046332310498932967 Shopify/cli
- [5] Merge pull request #8144 from Shopify/tests-abort-controller-8501718038938971862 Shopify/cli
- [6] Update Pages basePath for the repo rename, add npm deprecation workflow (#14422) Shopify/polaris
- [7] Recommend Shopify AI Toolkit in scaffolded storefronts ↗ Shopify/hydrogen