Skip to main content

hydrogen build
command

Builds a Hydrogen storefront for production. The client and app worker files are compiled to a /dist folder in your Hydrogen project directory.

The following flags are available for the hydrogen build command:

Show a bundle size summary after building. Defaults to true, use --no-bundle-stats to disable.

Automatically generates GraphQL types for your project’s Storefront API queries.

Anchor to --codegen-config-path <value>
--codegen-config-path <value>
string

Specifies a path to a codegen configuration file. Defaults to <root>/codegen.ts if this file exists.

Anchor to --disable-route-warning
--disable-route-warning
env: SHOPIFY_HYDROGEN_FLAG_DISABLE_ROUTE_WARNING

Disables any warnings about missing standard routes.

string
env: SHOPIFY_HYDROGEN_FLAG_ENTRY

Entry file for the worker. Defaults to ./server.

Anchor to --force-client-sourcemap
--force-client-sourcemap
env: 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.

env: SHOPIFY_HYDROGEN_FLAG_LOCKFILE_CHECK

Checks that there is exactly one valid lockfile in the project. Defaults to true. Deactivate with --no-lockfile-check.

string
env: SHOPIFY_HYDROGEN_FLAG_PATH

The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.

env: SHOPIFY_HYDROGEN_FLAG_SOURCEMAP

Controls whether server sourcemaps are generated. Default to true. Deactivate --no-sourcemaps.

env: SHOPIFY_HYDROGEN_FLAG_WATCH

Watches for changes and rebuilds the project writing output to disk.

Was this section helpful?

Hydrogen build

shopify hydrogen build [flags]