---
title: Hydrogen developer preview
description: >-
  Hydrogen's commerce primitives now work with any JavaScript framework. This
  developer preview covers the Storefront API client, cart, product, collection,
  analytics, and more.
source_url:
  html: 'https://shopify.dev/docs/storefronts/headless/developer-preview'
  md: 'https://shopify.dev/docs/storefronts/headless/developer-preview.md'
---

# Hydrogen developer preview

**Developer preview:**

This version of Hydrogen is an early preview. The APIs are still changing and aren't recommended for production yet. Share your feedback on what works, what breaks, and what's missing in the [Shopify developer community](https://community.shopify.dev/c/hydrogen-and-storefront-apis/9).

Hydrogen developer preview is a framework-agnostic version of Hydrogen's commerce primitives. Use it to work with the Storefront API, cart, product forms, analytics, and routing in your framework of choice.

***

## Choose between Hydrogen and the developer preview

Use current Hydrogen if you want Shopify's fully supported framework path for building with React Router.

Use this developer preview if you want to experiment with Hydrogen primitives in a custom JavaScript stack.

**Oxygen deployment:**

You can't currently deploy storefronts built with this developer preview to [Oxygen](https://shopify.dev/docs/storefronts/headless/hydrogen/deployments/oxygen-runtime). If you need Oxygen deployment, then use [current Hydrogen](https://shopify.dev/docs/storefronts/headless/hydrogen/getting-started).

***

## What's included

This preview includes:

* A typed Storefront API client that infers types from your GraphQL queries.
* Product and collection primitives for variant selection, filtering, and sorting.
* Cart primitives for optimistic updates, rollback, checkout routing, and Shop Pay buttons.
* First-party analytics with consent handling.
* Money formatting utilities.
* Route and proxy helpers, plus packaged skills for coding assistants.

Customer accounts and predictive search aren't available yet.

***

## Requirements

Before you start, make sure that you have:

* A JavaScript app created with your framework of choice.
* Node.js and npm installed.
* Storefront API access for a Shopify store when you're ready to connect Shopify data. To create a storefront and manage API credentials, use the [Headless channel](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels).

***

## Get started

From your app's project directory, install `@shopify/hydrogen-next` and its agent skills:

## Terminal

```text
npx @shopify/hydrogen-next setup
```

The `setup` command installs the developer preview package and skills in your app. Use the skills to set up the Storefront API client, wire up the cart, and build product pages with Hydrogen's framework-agnostic primitives.

***