---
title: "Hydrogen v2"
description: "Hydrogen is Shopify's stack for headless commerce."
url: "https://vercel.com/templates/remix/hydrogen-2"
links:
  repository: "https://github.com/vercel/examples/tree/main/framework-boilerplates/hydrogen-2"
  demo: "https://hydrogen-v2-template.vercel.app"
  deploy: "https://vercel.com/new/clone?demo-title=Hydrogen+v2&demo-description=Hydrogen+is+Shopify%27s+stack+for+headless+commerce.&demo-url=https%3A%2F%2Fhydrogen-v2-template.vercel.app&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F5ZajIKVps2sCOhxbbuK6iY%2F61846bb93c40b7835d9c9f6e97a52710%2FHydrogen_Light.png&project-name=Hydrogen+v2&repository-name=hydrogen-2&repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fexamples%2Ftree%2Fmain%2Fframework-boilerplates%2Fhydrogen-2&from=templates&skippable-integrations=1"
---

# Hydrogen v2

Hydrogen is Shopify's stack for headless commerce.

# Hydrogen v2

This directory is a brief example of a [Hydrogen v2](https://shopify.dev/custom-storefronts/hydrogen) storefront that can be deployed to Vercel with zero configuration.

## Deploy Your Own

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/vercel/examples/tree/main/framework-boilerplates/hydrogen-2&template=hydrogen-2)

_Live Example: https://hydrogen-v2-template.vercel.app_

You can also deploy using the [Vercel CLI](https://vercel.com/docs/cli):

```sh
npm i -g vercel
vercel
```

Hydrogen is Shopify’s stack for headless commerce. Hydrogen is designed to dovetail with [Remix](https://remix.run/), Shopify’s full stack web framework. This template contains a **minimal setup** of components, queries and tooling to get started with Hydrogen.

[Check out Hydrogen docs](https://shopify.dev/custom-storefronts/hydrogen)
[Get familiar with Remix](https://remix.run/docs/en/v1)

## What's included

- Remix
- Hydrogen
- Oxygen
- Shopify CLI
- ESLint
- Prettier
- GraphQL generator
- TypeScript and JavaScript flavors
- Minimal setup of components and routes

## Environment Variables

Using Hydrogen requires a few [environment variables](https://shopify.dev/docs/custom-storefronts/hydrogen/environment-variables) to be set in order to properly connect to Shopify. For this template, the minimal set of environment variables are defined in the `vercel.json` file, which will be applied to the deployment when deployed to Vercel. However, you should migrate these default environment variables to your Project's Environment Variables configuration in the Vercel dashboard (or using the `vc env` commands), and update them according to your needs (also change the `SESSION_SECRET` to your own value). Once that is done, delete the `vercel.json` file from your project to prevent the environment variables defined there from taking precedence.

## Local development

Rename the `.env.example` file to `.env` in order for the Shopify dev server to use those environment variables during local development. If you defined/modified additional environment variables based on the section above, be sure to apply those changes in your `.env` file as well.

Then run the following commands:

```bash
npm install
npm run dev
```

## Related Templates

### [Remix Boilerplate](https://vercel.com/templates/remix/remix-boilerplate)

A new Remix app — the result of running \`npx create-remix\`.

---

## Additional documentation

The [Vercel Knowledge Base](https://vercel.com/kb) contains guides and answers to common questions about Vercel, including deployment, framework configuration, domains, caching, and troubleshooting.