---
title: hydrogen dev
description: >-
  Runs a Hydrogen storefront in a local runtime that emulates an Oxygen worker
  for development.
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-dev'
  md: 'https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-dev.md'
api_name: shopify-cli
---

# hydrogen dev

Runs a Hydrogen storefront in a local runtime that emulates an Oxygen worker for development.

If your project is [linked](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-link) to a Hydrogen storefront, then its environment variables will be loaded with the runtime.

#### Flags

The following flags are available for the `hydrogen dev` command:

* **--codegen**

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

* **--codegen-config-path \<value>**

  **string**

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

* **--customer-account-push**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_CUSTOMER\_ACCOUNT\_PUSH**

  Use tunneling for local development and push the tunneling domain to admin. Required to use Customer Account API's OAuth flow

* **--debug**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_DEBUG**

  Enables inspector connections to the server with a debugger such as Visual Studio Code or Chrome DevTools.

* **--disable-deps-optimizer**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_DISABLE\_DEPS\_OPTIMIZER**

  Disable adding dependencies to Vite's `ssr.optimizeDeps.include` automatically

* **--disable-version-check**

  Skip the version check when running `hydrogen dev`

* **--disable-virtual-routes**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_DISABLE\_VIRTUAL\_ROUTES**

  Disable rendering fallback routes when a route file doesn't exist.

* **--entry \<value>**

  **string**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_ENTRY**

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

* **--env \<value>**

  **string**

  Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.

* **--env-branch \<value>**

  **string**

  **env: SHOPIFY\_HYDROGEN\_ENVIRONMENT\_BRANCH**

  Specifies the environment to perform the operation using its Git branch name.

* **--env-file \<value>**

  **string**

  Path to an environment file to override existing environment variables. Defaults to the '.env' located in your project path `--path`.

* **--host**

  Expose the server to the local network

* **--inspector-port \<value>**

  **string**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_INSPECTOR\_PORT**

  The port where the inspector is available. Defaults to 9229.

* **--json-schema**

  **env: SHOPIFY\_FLAG\_JSON\_SCHEMA**

  Print the command's JSON schemas.

* **--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.

* **--port \<value>**

  **string**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_PORT**

  The port to run the server on. Defaults to 3000.

* **--verbose**

  **env: SHOPIFY\_HYDROGEN\_FLAG\_VERBOSE**

  Outputs more information about the command's execution.

Examples

### Examples

* ####

  ##### hydrogen dev

  ```sh
  shopify hydrogen dev [flags]
  ```

***