---
title: hydrogen dev
description: |-
  Runs a Hydrogen storefront in a local runtime that emulates an Oxygen worker for development.

    If your project is [linked](/docs/api/shopify-cli/hydrogen/hydrogen-link) to a Hydrogen storefront, then its environment variables will be loaded with the runtime.
api_name: shopify-cli
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
---

# hydrogen devcommand

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.

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

* #### hydrogen dev

  ##### hydrogen dev

  ```bash
  shopify hydrogen dev [flags]
  ```