Skip to main content

hydrogen build

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:

Anchor to --bundle-stats
--bundle-stats

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

Anchor to --codegen
--codegen

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.

Anchor to --entry <value>
--entry <value>
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.

Anchor to --lockfile-check
--lockfile-check
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.

Anchor to --path <value>
--path <value>
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.

Anchor to --sourcemap
--sourcemap
env: SHOPIFY_HYDROGEN_FLAG_SOURCEMAP

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

Anchor to --watch
--watch
env: SHOPIFY_HYDROGEN_FLAG_WATCH

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


Was this page helpful?