Skip to main content

Hydrogen templates

tip

Hydrogen 2.0 is out now. These archival Hydrogen 1.0 docs are provided only to assist developers during their upgrade process. Please migrate as soon as possible.

Hydrogen offers different templates that provide paths to building Shopify custom storefronts. This guide describes the templates that Hydrogen offers and how you can begin exploring them.

How it works

Hydrogen provides the following templates to help you get started:

  • Hello World: A minimal template for developers who want to build their Hydrogen storefront from the very beginning. Pick this template to start building from scratch.
  • Demo Store: The default template installed when creating a new Hydrogen storefront. It’s a complete Hydrogen storefront that uses live production data provided by Shopify. Pick this template to inspect a working Hydrogen codebase, or to use as a starting point for your own build.

Components

The Demo Store template provides a series of components that you can use to accelerate your development process. The components integrate directly with the Storefront API for efficient data-fetching, allowing you to save time on crafting GraphQL queries to interact with Shopify APIs or other third-party data sources.

The Demo Store template includes different categories of components.

Account

The following components render account information:

Cards

The following components render card elements:

Cart

The following components render cart elements:

Elements

The following components render small chunks of reusable content:

Global

The following components render global elements:

Product

The following components render product information:

The following components render search functionality:

Sections

The following components render specific pieces of content on a page:

Additional components

Routes

Hydrogen uses file-based routing. Any pages added to the src/routes directory will be automatically registered as routes by the app. The following routes are included in the Demo Store template: