hydrogen build
This command works with Hydrogen 2026-04 and earlier. Hydrogen 2026-10 doesn't support the command. In a Hydrogen 2026-10 project, use your framework's commands or the @shopify/hydrogen commands instead. To check which commands Hydrogen 2026-10 supports, refer to Shopify CLI Hydrogen commands.
This command works with Hydrogen 2026-04 and earlier. Hydrogen 2026-10 doesn't support the command. In a Hydrogen 2026-10 project, use your framework's commands or the @shopify/hydrogen commands instead. To check which commands Hydrogen 2026-10 supports, refer to Shopify CLI Hydrogen commands.
Builds a Hydrogen storefront for production. The client and app worker files are compiled to a /dist folder in your Hydrogen project directory.
Anchor to flagsFlags
The following flags are available for the hydrogen build command:
- Anchor to --bundle-stats--bundle-stats--bundle-stats
Show a bundle size summary after building. Defaults to true, use
--no-bundle-statsto disable.- Anchor to --codegen--codegen--codegen
Automatically generates GraphQL types for your project’s Storefront API queries.
- Anchor to --codegen-config-path <value>--codegen-config-path <value>--codegen-config-path <value>stringstring
Specifies a path to a codegen configuration file. Defaults to
<root>/codegen.tsif this file exists.- Anchor to --disable-route-warning--disable-route-warning--disable-route-warningenv: SHOPIFY_HYDROGEN_FLAG_DISABLE_ROUTE_WARNINGenv: SHOPIFY_HYDROGEN_FLAG_DISABLE_ROUTE_WARNING
Disables any warnings about missing standard routes.
- Anchor to --entry <value>--entry <value>--entry <value>stringstringenv: SHOPIFY_HYDROGEN_FLAG_ENTRYenv: SHOPIFY_HYDROGEN_FLAG_ENTRY
Entry file for the worker. Defaults to
./server.- Anchor to --force-client-sourcemap--force-client-sourcemap--force-client-sourcemapenv: SHOPIFY_HYDROGEN_FLAG_FORCE_CLIENT_SOURCEMAPenv: SHOPIFY_HYDROGEN_FLAG_FORCE_CLIENT_SOURCEMAP
Client sourcemapping is avoided by default because it makes backend code visible in the browser. Use this flag to force enabling it.
- Anchor to --json-schema--json-schema--json-schemaenv: SHOPIFY_FLAG_JSON_SCHEMAenv: SHOPIFY_FLAG_JSON_SCHEMA
Print the command's JSON schemas.
- Anchor to --lockfile-check--lockfile-check--lockfile-checkenv: SHOPIFY_HYDROGEN_FLAG_LOCKFILE_CHECKenv: SHOPIFY_HYDROGEN_FLAG_LOCKFILE_CHECK
Checks that there is exactly one valid lockfile in the project. Defaults to
true. Deactivate with--no-lockfile-check.- Anchor to --path <value>--path <value>--path <value>stringstringenv: SHOPIFY_HYDROGEN_FLAG_PATHenv: SHOPIFY_HYDROGEN_FLAG_PATH
The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.
- Anchor to --sourcemap--sourcemap--sourcemapenv: SHOPIFY_HYDROGEN_FLAG_SOURCEMAPenv: SHOPIFY_HYDROGEN_FLAG_SOURCEMAP
Controls whether server sourcemaps are generated. Default to
true. Deactivate--no-sourcemaps.- Anchor to --watch--watch--watchenv: SHOPIFY_HYDROGEN_FLAG_WATCHenv: SHOPIFY_HYDROGEN_FLAG_WATCH
Watches for changes and rebuilds the project writing output to disk.
hydrogen build
Examples
Hydrogen build
hydrogen build
shopify hydrogen build [flags]