hydrogen

Dokumen | Diskusi | log perubahan

Hidrogen adalah tumpukan Shopify untuk perdagangan tanpa kepala. Ini menyediakan seperangkat alat, utilitas, dan contoh terbaik di kelasnya untuk membangun aplikasi perdagangan yang dinamis dan berkinerja. Hidrogen dirancang agar sesuai dengan Remix, kerangka web tumpukan penuh Shopify, tetapi juga menyediakan perpustakaan React yang portabel untuk kerangka kerja pendukung lainnya.

Warisan Hidrogen v1

Hydrogen legacy v1 telah dipindahkan ke repo terpisah dan dokumennya dapat ditemukan di sini.

Memulai dengan Hidrogen

Persyaratan:

• Node.js versi 16.14.0 atau lebih tinggi
• npm (atau manajer paket pilihan Anda, seperti yarn atau pnpm )

1. Instal Hidrogen versi terbaru:

   npm create @shopify/hydrogen@latest

2. Jalankan server pengembangan lokal:

   npm install
   npm run dev

3. Buka aplikasi Hidrogen baru Anda yang berjalan di http://localhost:3000.

Lihat dokumen Hidrogen selengkapnya.

Paket dalam repo ini

Hidrogen disusun sebagai monorepo, yang mencakup beberapa paket yang dapat digunakan bersama.

Kemasan	Versi terbaru	Keterangan	Baca saya
@shopify/hydrogen		Alat, utilitas, dan contoh terbaik di kelasnya untuk membangun aplikasi perdagangan dengan Remix.	Baca saya
@shopify/hydrogen-react		Pustaka komponen, pengait, dan utilitas perdagangan khusus Shopify yang tidak memiliki opionasi dan berkinerja baik.	Baca saya
@shopify/cli-hydrogen		Ekstensi hidrogen untuk Shopify CLI.	Baca saya
@shopify/create-hydrogen		Hasilkan proyek Hidrogen baru dari baris perintah.	Baca saya
@shopify/hydrogen-codegen		Hasilkan tipe untuk kueri Storefront API secara otomatis.	Baca saya
@shopify/remix-oxygen		Adaptor Remix memungkinkan Hidrogen berjalan pada runtime Oksigen.	Baca saya
@shopify/mini-oxygen		Runtime lokal untuk aplikasi Hidrogen yang menyimulasikan lingkungan produksi Oksigen.	Baca saya

Pembuatan versi

Hidrogen dan reaksi hidrogen terikat dengan versi spesifik API Shopify Storefront, yang mengikuti calver.

Misalnya, jika Anda menggunakan Storefront API versi 2023-01 , versi Hidrogen dan reaksi hidrogen 2022.1.x sepenuhnya kompatibel.

Jika pembaruan versi Storefront API menyertakan perubahan yang dapat menyebabkan gangguan, maka Hidrogen dan reaksi hidrogen juga dapat menyertakan perubahan yang dapat menyebabkan gangguan. Karena versi API diperbarui setiap tiga bulan, perubahan yang dapat menyebabkan gangguan dapat terjadi setiap tiga bulan.

Pelajari lebih lanjut tentang jadwal rilis API di Shopify.

Berkontribusi pada Hidrogen

Baca panduan kontribusi kami

Tautan berguna lainnya

Pelajari lebih lanjut tentang Hidrogen.