hydrogen

Documents | Discussions | Journal des modifications

Hydrogen est la pile de Shopify pour le commerce sans tête. Il fournit un ensemble d'outils, d'utilitaires et des exemples de premier ordre pour créer des applications commerciales dynamiques et performantes. Hydrogen est conçu pour s'intégrer à Remix, le framework Web complet de Shopify, mais il fournit également une bibliothèque React portable avec d'autres frameworks de support.

Héritage de l'hydrogène v1

Hydrogen Legacy v1 a été déplacé vers un référentiel distinct et la documentation peut être trouvée ici.

Débuter avec l'hydrogène

Exigences:

• Node.js version 16.14.0 ou supérieure
• npm (ou le gestionnaire de paquets de votre choix, tel que yarn ou pnpm )

1. Installez la dernière version d'Hydrogen :

   npm create @shopify/hydrogen@latest

2. Exécutez le serveur de développement local :

   npm install
   npm run dev

3. Ouvrez votre nouvelle application Hydrogen exécutée sur http://localhost:3000.

Voir la documentation complète sur l'hydrogène.

Packages dans ce dépôt

Hydrogen est organisé comme un monorepo, qui comprend plusieurs packages pouvant être utilisés ensemble.

Emballer	Dernière version	Description	Lisez-moi
@shopify/hydrogen		Des outils avisés, des utilitaires et des exemples de premier ordre pour créer une application commerciale avec Remix.	Lisez-moi
@shopify/hydrogen-react		Bibliothèque sans opion et performante de composants, hooks et utilitaires commerciaux spécifiques à Shopify.	Lisez-moi
@shopify/cli-hydrogen		Extension hydrogène pour Shopify CLI.	Lisez-moi
@shopify/create-hydrogen		Générez un nouveau projet Hydrogen à partir de la ligne de commande.	Lisez-moi
@shopify/hydrogen-codegen		Générez automatiquement des types pour les requêtes de l'API Storefront.	Lisez-moi
@shopify/remix-oxygen		Adaptateur Remix permettant à Hydrogen de fonctionner sur le runtime Oxygen.	Lisez-moi
@shopify/mini-oxygen		Un environnement d'exécution local pour les applications Hydrogen qui simule l'environnement de production d'Oxygène.	Lisez-moi

Gestion des versions

L'hydrogène et l'hydrogène-réaction sont liés à des versions spécifiques de l'API Shopify Storefront, qui suit Calver.

Par exemple, si vous utilisez la version 2023-01 de l'API Storefront, les versions 2022.1.x d'Hydrogen et d'hydrogène-react sont entièrement compatibles.

Si la mise à jour de la version de l’API Storefront inclut des modifications majeures, Hydrogen et Hydrogen-React peuvent également inclure des modifications majeures. Étant donné que la version de l'API est mise à jour tous les trois mois, des modifications importantes peuvent survenir tous les trois mois.

Apprenez-en davantage sur les calendriers de publication des API sur Shopify.

Contribuer à l'hydrogène

Lisez notre guide de contribution

Autres liens pratiques

Apprenez-en davantage sur l’hydrogène.