Releases: Shopify/hydrogen
Release list
@shopify/cli-hydrogen@13.0.2
Patch Changes
-
Add noninteractive shop and storefront creation flags to
hydrogen link. (#3834) by @gonzaloriestra -
Use
--forceto bypass confirmation prompts inhydrogen upgrade. (#3835) by @gonzaloriestra
skeleton@2026.4.5
Patch Changes
-
Add an explicit
~app alias to new Hydrogen projects. (#3852) by @andguy95JavaScript projects use
jsconfig.json, which is not reliably covered by Vite's nativeresolve.tsconfigPathsbehavior. New projects now define Hydrogen's~/import convention directly in the Vite config so imports like~/assets/favicon.svgwork in both TypeScript and JavaScript projects.
@shopify/create-hydrogen@5.0.38
Patch Changes
-
Add an explicit
~app alias to new Hydrogen projects. (#3852) by @andguy95JavaScript projects use
jsconfig.json, which is not reliably covered by Vite's nativeresolve.tsconfigPathsbehavior. New projects now define Hydrogen's~/import convention directly in the Vite config so imports like~/assets/favicon.svgwork in both TypeScript and JavaScript projects.
@shopify/cli-hydrogen@13.0.1
Patch Changes
-
Read disabled command metadata from @Shopify/hydrogen and stop those commands with an actionable error. (#3846) by @graygilmore
-
Preserve actionable build errors during
h2 deploy. When the build step fails (for example, when thevitepackage is missing from the project), the original error and its guidance are now surfaced instead of being wrapped into a generic "Build function failed with error" message and reported as an uncaught crash. (#3848) by @bashu-shopify -
Add an explicit
~app alias to new Hydrogen projects. (#3852) by @andguy95JavaScript projects use
jsconfig.json, which is not reliably covered by Vite's nativeresolve.tsconfigPathsbehavior. New projects now define Hydrogen's~/import convention directly in the Vite config so imports like~/assets/favicon.svgwork in both TypeScript and JavaScript projects. -
Skip confirmation before deploying to non-preview environments with
--force. (#3832) by @gonzaloriestra -
Add
--forceand--dry-runflags tohydrogen env push. (#3831) by @gonzaloriestra -
Fix Hydrogen deploy asset directory resolution when Vite reports the client output directory as the SSR server output directory. (#3842) by @frandiox
@shopify/mini-oxygen@4.2.0
Minor Changes
-
-
Make the Oxygen Vite plugin self-sufficient by inferring a compatibility date from the resolved Hydrogen package when one is not provided. (#3819) by @frandiox
-
Worker-specific resolve conditions now apply only to the SSR worker environment so browser/client modules continue using Vite's normal client conditions.
-
oxygen.jsonis now emitted only during SSR builds. -
The Oxygen Vite plugin now loads Vite environment variables as Mini Oxygen bindings when no env bindings are provided by plugin options or the Hydrogen CLI.
-
vite previewcan now run the built Oxygen worker in Mini Oxygen, with an optionalpreviewEntryoverride for custom worker output paths.
-
Patch Changes
-
Fix
~/path alias resolution in the MiniOxygen SSR environment (#3823) by @jibin7joseThe Oxygen Vite plugin now captures the user's
resolve.tsconfigPathssetting
from the top-level Vite config and forwards it to the custom SSR environment
returned byconfigEnvironment(). Because Vite environments are isolated, the
top-level resolve config does not automatically apply to custom environments
created by plugins, so tsconfig path aliases (e.g.~/assets/favicon.svg)
would fail to resolve at runtime.Fixes #3816
@shopify/cli-hydrogen@13.0.0
Patch Changes
-
Add deploy flags and environment variables for configuring Oxygen's client assets directory and worker directory. The worker directory must contain an
index.jsorindex.mjsentry point. (#3819) by @frandioxDeployments now resolve output directories from explicit flags, Vite output directories, then
dist/clientanddist/serverfallbacks. Custom output deployments and0.0.0-preview-*Hydrogen versions default tonode --run buildinstead of the Hydrogen build pipeline when no build command is provided. -
Updated dependencies [
375ed8e512b8d1f85867e8b7e52c48893cf6e4fb,091f8ec62f9e213b02f68f540d81c65e9ee41cd2]:- @shopify/mini-oxygen@4.2.0
skeleton@2026.4.4
Patch Changes
- Updated dependencies [
23431c956193420bce3442e9e5cc711dc95cc497]:- @Shopify/hydrogen@2026.4.4
@shopify/hydrogen@2026.4.4
@shopify/cli-hydrogen@12.0.2
Patch Changes
- Show a clear, actionable error when
vitecannot be found in your project instead of crashing with an unhandledCannot find module 'vite'. This typically happens when a Hydrogen command is run outside the app directory or before installing dependencies; the CLI now explains how to fix it. (#3796) by @lucyxiang
skeleton@2026.4.3
Patch Changes
-
Include line item children recursively in cart. (#3753) by @martin-pettersson
-
Add generic cart result typing to
createCartHandlerso custom cart fragments can use their generated fragment types. (#3767) by @andguy95 -
Widen React Router peer dependency ranges so Hydrogen packages accept compatible React Router 7.16 patch versions without npm peer dependency conflicts. New Hydrogen projects now default to React Router 7.16.0. (#3771) by @fredericoo
-
Updated dependencies [
3ccc22e0a3407298e835104e29adfb036f261474,a810db483c108ac8bbeaac45595b130ed95a2ec7,d17057eb4630710743e81b83573973100ec56d23,995190036d99e02ba6fb559b8e3c406c90043599,39f2b326e9fddda36b1d12149794bf4ffcc0d4b8]:- @Shopify/hydrogen@2026.4.3