Skip to main content

hydrogen setup

Hydrogen 2026-04 and earlier

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.

Scaffold routes and core functionality.

Anchor to flagsFlags

The following flags are available for the hydrogen setup command:

Anchor to --install-deps
--install-deps
env: SHOPIFY_HYDROGEN_FLAG_INSTALL_DEPS

Auto installs dependencies using the active package manager.

Anchor to --json-schema
--json-schema
env: SHOPIFY_FLAG_JSON_SCHEMA

Print the command's JSON schemas.

Anchor to --markets <value>
--markets <value>
string
env: SHOPIFY_HYDROGEN_FLAG_I18N

Sets the URL structure to support multiple markets. Must be one of: subfolders, domains, subdomains, none. Example: --markets subfolders.

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 --shortcut
--shortcut
env: SHOPIFY_HYDROGEN_FLAG_SHORTCUT

Creates a global h2 shortcut for Shopify CLI using shell aliases. Deactivate with --no-shortcut.

Anchor to -f, --force
-f, --force
env: SHOPIFY_HYDROGEN_FLAG_FORCE

Overwrites the destination directory and files if they already exist.

Examples

hydrogen setup

shopify hydrogen setup [flags]
Was this page helpful?