hydrogen

Dokumente | Diskussionen | Änderungsprotokoll

Wasserstoff ist Shopifys Stack für Headless Commerce. Es bietet eine Reihe von Tools, Dienstprogrammen und erstklassigen Beispielen für die Erstellung dynamischer und leistungsstarker Handelsanwendungen. Hydrogen ist so konzipiert, dass es mit Remix, dem Full-Stack-Web-Framework von Shopify, harmoniert, bietet aber auch eine React-Bibliothek, die auf andere unterstützende Frameworks portierbar ist.

Wasserstoff-Legacy v1

Hydrogen Legacy v1 wurde in ein separates Repo verschoben und die Dokumente finden Sie hier.

Erste Schritte mit Wasserstoff

Anforderungen:

• Node.js-Version 16.14.0 oder höher
• npm (oder Ihr Paketmanager Ihrer Wahl, z. B. yarn oder pnpm )

1. Installieren Sie die neueste Version von Hydrogen:

   npm create @shopify/hydrogen@latest

2. Führen Sie den lokalen Entwicklungsserver aus:

   npm install
   npm run dev

3. Öffnen Sie Ihre neue Hydrogen-App unter http://localhost:3000.

Sehen Sie sich die vollständigen Hydrogen-Dokumente an.

Pakete in diesem Repo

Wasserstoff ist als Monorepo organisiert, das mehrere Pakete umfasst, die zusammen verwendet werden können.

Paket	Neueste Version	Beschreibung	Readme
@shopify/hydrogen		Meinungsmeinende Tools, Dienstprogramme und erstklassige Beispiele für die Erstellung einer Commerce-Anwendung mit Remix.	Readme
@shopify/hydrogen-react		Unbestimmte und leistungsstarke Bibliothek mit Shopify-spezifischen E-Commerce-Komponenten, Hooks und Dienstprogrammen.	Readme
@shopify/cli-hydrogen		Wasserstofferweiterung für Shopify CLI.	Readme
@shopify/create-hydrogen		Generieren Sie ein neues Wasserstoffprojekt über die Befehlszeile.	Readme
@shopify/hydrogen-codegen		Generieren Sie automatisch Typen für Storefront-API-Abfragen.	Readme
@shopify/remix-oxygen		Remix-Adapter, der die Ausführung von Hydrogen auf der Oxygen-Laufzeitumgebung ermöglicht.	Readme
@shopify/mini-oxygen		Eine lokale Laufzeit für Hydrogen-Apps, die die Oxygen-Produktionsumgebung simuliert.	Readme

Versionierung

Hydrogen und Hydrogen-React sind an bestimmte Versionen der Shopify Storefront API gebunden, die Calver folgt.

Wenn Sie beispielsweise die Storefront-API-Version 2023-01 verwenden, sind die Versionen 2022.1.x von Hydrogen und Hydrogen-React vollständig kompatibel.

Wenn das Update der Storefront-API-Version Breaking Changes enthält, dann können Hydrogen und Hydrogen-React auch Breaking Changes enthalten. Da die API-Version alle drei Monate aktualisiert wird, können alle drei Monate wichtige Änderungen auftreten.

Erfahren Sie mehr über API-Release-Zeitpläne bei Shopify.

Beitrag zum Wasserstoff

Lesen Sie unseren Beitragsleitfaden

Weitere nützliche Links

Erfahren Sie mehr über Wasserstoff.