hydrogen

Документы | Обсуждения | Журнал изменений

Hydrogen — это стек Shopify для безголовой коммерции. Он предоставляет набор инструментов, утилит и лучшие в своем классе примеры для создания динамичных и производительных коммерческих приложений. Hydrogen разработан для совместимости с Remix, полнофункциональной веб-инфраструктурой Shopify, но также предоставляет библиотеку React, переносимую на другие поддерживающие платформы.

Водородное наследие v1

Hydrogen Legacy v1 перенесен в отдельный репозиторий, а документацию можно найти здесь.

Начало работы с водородом

Требования:

• Node.js версии 16.14.0 или выше
• npm (или менеджер пакетов по вашему выбору, например, yarn или pnpm )

1. Установите последнюю версию Hydrogen:

   npm create @shopify/hydrogen@latest

2. Запустите локальный сервер разработки:

   npm install
   npm run dev

3. Откройте новое приложение Hydrogen, работающее по адресу http://localhost:3000.

См. полную документацию по водороду.

Пакеты в этом репозитории

Hydrogen организован как монорепозиторий, который включает в себя несколько пакетов, которые можно использовать вместе.

Упаковка	Последняя версия	Описание	Readme
@shopify/hydrogen		Авторские инструменты, утилиты и лучшие в своем классе примеры для создания коммерческих приложений с помощью Remix.	Readme
@shopify/hydrogen-react		Независимая и производительная библиотека коммерческих компонентов, перехватчиков и утилит, ориентированных на Shopify.	Readme
@shopify/cli-hydrogen		Расширение Hydrogen для Shopify CLI.	Readme
@shopify/create-hydrogen		Создайте новый проект Hydrogen из командной строки.	Readme
@shopify/hydrogen-codegen		Автоматически создавайте типы для запросов Storefront API.	Readme
@shopify/remix-oxygen		Адаптер Remix, позволяющий Hydrogen работать в среде выполнения Oxygen.	Readme
@shopify/mini-oxygen		Локальная среда выполнения для приложений Hydrogen, имитирующая среду производства Oxygen.	Readme

Управление версиями

Водород и водородная реакция привязаны к конкретным версиям Shopify Storefront API, который следует за Calver.

Например, если вы используете Storefront API версии 2023-01 , то версии Hydrogen и Hydrogen React 2022.1.x полностью совместимы.

Если обновление версии Storefront API включает критические изменения, то Hydrogen и Hydrogen-react также могут включать критические изменения. Поскольку версия API обновляется каждые три месяца, критические изменения могут происходить каждые три месяца.

Узнайте больше о графиках выпуска API на Shopify.

Вклад в водород

Прочтите наше руководство по участию

Другие полезные ссылки

Узнайте больше о водороде.