Shopify Hydrogen je Shopify-jev alat za izradu headless prodavnica: prilagođenih prednjih delova sajta koji rade na vašem kodu, dok Shopify upravlja proizvodima, korpom, naplatom i porudžbinama. Od verzije Hydrogen 2026-10, objavljene 14. oktobra 2026, to je JavaScript biblioteka koju dodajete u okvir (framework) kao što su React Router 7 ili Next.js, a ne samostalan okvir.
To je velika promena u odnosu na Hydrogen koji većina članaka i dalje opisuje. Ovaj vodič objašnjava šta je Hydrogen u 2026, na čemu radi, kako funkcionišu hosting i API-ji, šta se promenilo od 2024. i kada se headless izrada isplati u poređenju sa Shopify temom. Headless prodavnice pravimo za klijente, pa poslednji deo dolazi iz stvarnih projekata, a ne samo iz dokumentacije.
Šta je Shopify Hydrogen?
Hydrogen je zvanični Shopify paket za headless prodaju. Objavljen je na npm-u kao @shopify/hydrogen, pod MIT licencom. Shopify ga u dokumentaciji naziva „Shopify-jevim headless alatom“ i „jednim od načina da se napravi headless prodavnica na Shopify-ju“.
U headless postavci, prodavnica koju kupci vide je zasebna veb aplikacija. Ona čita podatke iz Shopify-ja preko API-ja i šalje kupce na Shopify naplatu. Hydrogen toj aplikaciji daje delove koji su potrebni za prodaju:
- Tipizovan Storefront API klijent sa keširanjem.
- Obrađivače zahteva za rute koje pripadaju Shopify-ju, kao što su naplata, trajni linkovi za korpu, URL preusmerenja i API korpe.
- Korpu koja radi i pre nego što se JavaScript učita i koja prikazuje promene pre nego što server odgovori.
- Izbor varijanti, filtere kolekcija, sortiranje, straničenje i pretragu sa predlozima.
- Formatiranje cena, kontekst za Shopify Markets, Shop Pay dugmad i Shopify analitiku koja poštuje pristanak kupca.
- Customer Account API klijent sa prijavom, odjavom i sesijama.
Hydrogen više ne isporučuje biblioteku komponenti. Stranice gradite sopstvenim komponentama i dizajn sistemom. Naplata ostaje na Shopify-ju, a Hydrogen pokriva samo Storefront API i Customer Account API, ne i Admin API.
Na čemu je Hydrogen izgrađen u 2026?
Kratak odgovor: na okviru koji vi izaberete. Duži odgovor ima tri faze.
- Do maja 2025: Remix. Hydrogen je bio kompletan okvir za klijentski i serverski deo, izgrađen na Remix-u, sa sopstvenim CLI alatom, komponentama i strukturom projekta.
- Od maja 2025. do oktobra 2026: React Router 7. U maju 2024. Remix tim je najavio da će planirani Remix v3 izaći kao React Router v7. React Router v7 je postao stabilan 22. novembra 2024. Hydrogen 2025.5.0, objavljen 21. maja 2025, prešao je sa Remix 2 na React Router 7.
- Od oktobra 2026: bilo koji okvir. Shopify je 17. juna 2026. objavio razvojnu probnu verziju koja „izmešta logiku prodaje iz React Router-a u jezgro nezavisno od okvira“. Hydrogen 2026-10 ju je učinio opšte dostupnom 14. oktobra 2026.
Hydrogen 2026-10 ima jezgro koje ne zavisi ni od jednog okvira, plus povezivanja za React i Vue:
@shopify/hydrogen: jezgro, sa Storefront API klijentom, obrađivačima zahteva, korpom, formom proizvoda, kolekcijama, pretragom sa predlozima, formatiranjem cena, analitikom i Shop Pay-om.@shopify/hydrogen/react: React komponente i hukovi izgrađeni na jezgru. Zaseban paket@shopify/hydrogen-reactostaje na liniji 2026-04.@shopify/hydrogen/vue: iste komponente za Vue, sa kompozicionim funkcijama (composables) umesto hukova.@shopify/hydrogen/customer-account: Customer Account API klijent i pomoćne funkcije za sesije kupaca.
Shopify održava početni šablon za React Router 7 koji se objavljuje na Oxygen. Vercel održava Vercel Shop, početni šablon za Next.js 16 izgrađen na Hydrogen-u. Hydrogen repozitorijum ima i primere za Nuxt, Astro, SvelteKit i SolidStart, ali Shopify napominje da su to test projekti, a ne početni šabloni.
Jezgro koristi standardne API-je veb platforme, kao što su fetch, Request, Response i Web Crypto. Zato radi na Oxygen-u, Node.js-u, Cloudflare Workers-u, Deno-u i Vercel-u. Shopify testira Hydrogen 2026-10 sa React 19, Vite 8 i Node.js 22.12 ili 24.
Šta je Oxygen i gde još možete da hostujete Hydrogen?
Oxygen je Shopify-jeva hosting platforma za Hydrogen prodavnice. Vašu prodavnicu pokreće kao Web Worker, a ne kao Node server, na okruženju zasnovanom na Cloudflare-ovom workerd projektu otvorenog koda. Njime upravljate iz Hydrogen prodajnog kanala u Shopify administraciji, gde se nalaze okruženja, promenljive okruženja i objave svake prodavnice.
Šta treba da znate o Oxygen-u u 2026:
- Cena. Oxygen je uključen bez doplate u plaćene Shopify planove, od Starter do Plus. U najavi iz oktobra 2026. Shopify kaže da je Oxygen „i dalje besplatan“.
- Testiranje. Od avgusta 2026. i razvojne prodavnice i prodavnice na probnom planu mogu da objavljuju na Oxygen. Njihovi linkovi za objave uvek traže prijavu u prodavnicu, jer nemaju javna okruženja.
- Objavljivanje. Možete objavljivati automatski pri svakom slanju koda na GitHub, iz sopstvenog CI/CD sistema ili iz terminala komandom
npx shopify hydrogen deploy. Kada napravite prodavnicu, Shopify sam dodaje promenljive za Storefront API i Customer Account API. - Ograničenja. Worker mora imati 10 MB ili manje i može da koristi do 128 MB memorije. Neki Node.js API-ji nisu dostupni, pa proverite Shopify dokumentaciju za Oxygen okruženje pre nego što dodate biblioteke koje rade samo na Node-u.
Ne morate da koristite Oxygen. Shopify dokumentacija za objavljivanje opisuje tri puta:
| Hosting | Kada odgovara | Odakle dolazi veza sa prodavnicom |
|---|---|---|
| Oxygen | Koristite React Router početni šablon i želite da ga Shopify hostuje | Hydrogen kanal |
| Vercel | Gradite na Next.js-u, na primer uz Vercel Shop | Headless kanal |
| Node.js, Cloudflare Workers, Deno ili drugo okruženje | Vaš okvir se već objavljuje tamo | Headless kanal |
Van Oxygen-a, Storefront API tokene pravite u Headless kanalu, a hosting plaćate posebno.
Koje Shopify API-je Hydrogen koristi?
Dva: Storefront API za prodavnicu i Customer Account API za prijavljene kupce.
Storefront API
Storefront API je GraphQL API za proizvode, kolekcije, pretragu, korpu i cene za različite zemlje. Kada je kupac spreman da plati, API ga prosleđuje na Shopify naplatu. Podržava tri vrste pristupa:
- Pristup bez tokena za osnovno, kao što su proizvodi, kolekcije, pretraga i korpa.
- Javni token za zahteve iz pregledača ili mobilne aplikacije, gde kupci mogu da vide token.
- Privatni token za zahteve sa servera, kao što je serverski deo Hydrogen aplikacije, gde token ostaje tajan.
Zahtevi stvarnih kupaca nemaju fiksno ograničenje broja zahteva po minutu. Automatizovan saobraćaj je ograničen.
Customer Account API
Customer Account API pokreće stranice za prijavljene kupce: istoriju porudžbina, profil i adrese. Potvrđuje identitet kupaca, ne aplikacija, i prati OAuth 2.0, uz PKCE za javne klijente kao što su veb i mobilne aplikacije. Hydrogen 2026-10 sadrži klijent, obrađivače za prijavu i odjavu i sesije kupaca u @shopify/hydrogen/customer-account. Dodaje i pomoćni alat za lokalni HTTPS, jer prijava preko Customer Account API-ja ne radi na običnom localhost-u.
Hydrogen prati Shopify-jeve kvartalne verzije API-ja. Hydrogen 2026.10.x koristi verziju 2026-10 oba API-ja. Svaka stabilna verzija API-ja ima podršku najmanje 12 meseci.
Kako sada izgleda Hydrogen CLI?
Manji je nego ranije. U Hydrogen-u 2026-10 vaš okvir pokreće razvojni server i pravi produkcijsku verziju. Shopify CLI komande kao što su shopify hydrogen dev, build, preview, codegen i upgrade rade samo sa Hydrogen-om 2026-04 i starijim, a shopify hydrogen init i dalje pravi projekat na verziji 2026-04. Ovo su komande koje se sada koriste:
| Komanda | Šta radi |
|---|---|
npx @shopify/hydrogen@latest setup | Instalira Hydrogen i kopira njegove veštine za AI agente u .claude/skills i .agents/skills. U praznoj fascikli nudi React Router šablon. |
npx @shopify/hydrogen skills sync | Usklađuje veštine sa instaliranom verzijom Hydrogen-a. Pokrenite je posle svake nadogradnje. |
npx @shopify/hydrogen skills check | Javlja grešku kada su veštine zastarele, pa može da se pokreće u CI-ju. |
npx @shopify/hydrogen gql check | Proverava vaše GraphQL upite prema šemi Storefront API-ja. |
npx @shopify/hydrogen certs install | Podešava pouzdan lokalni HTTPS za testiranje korisničkih naloga. |
npx shopify hydrogen link i env pull | Povezuju projekat sa prodavnicom u Hydrogen kanalu i preuzimaju njene promenljive okruženja. |
npx shopify hydrogen deploy | Objavljuje produkcijsku verziju na Oxygen. |
Veštine za AI agente (skills) su novost u 2026. Hydrogen ih ima 20, po jednu za svaki deo prodavnice, od korpe i forme za varijante do analitike i Oxygen-a. Shopify predlaže da prva poruka agentu bude „Set up my store with Shopify.“ (u prevodu: „Podesi moju prodavnicu uz Shopify.“) Agent zatim pravi početnu stranu, stranice kolekcija, pretrage, proizvoda, korpe i naloga i dodaje analitiku. Taj rezultat tretirajte kao prvu verziju. Programer i dalje treba da pregleda kod, dizajn i praćenje pre pokretanja.
Šta se promenilo u Hydrogen-u od 2024?
- 22. novembar 2024: React Router v7 je postao stabilan kao naslednik Remix-a.
- 21. maj 2025: Hydrogen 2025.5.0 je prešao sa Remix 2 na React Router 7.
- Od 2025. do aprila 2026: kvartalna izdanja (2025.7, 2025.10, 2026.1, 2026.4) pratila su nove verzije API-ja i donela nove funkcije korpe, kao što su kodovi poklon kartica i adrese za dostavu. Hydrogen 2026.4.0 je posrednik (proxy) za Storefront API učinio obaveznim i prebacio praćenje pristanka na kolačiće koje postavlja server.
- 17. jun 2026: Shopify je objavio razvojnu probnu verziju Hydrogen-a nezavisnog od okvira.
- Avgust 2026: Oxygen je otvoren za razvojne prodavnice (3. avgusta) i prodavnice na probnom planu (25. avgusta). Shopify je 5. avgusta dodao WebMCP alate u Liquid i Hydrogen prodavnice, pa AI agenti u podržanim pregledačima mogu da pretražuju katalog i upravljaju korpom.
- 14. oktobar 2026: Hydrogen 2026-10 je postao opšte dostupan, sa početnim šablonima za React Router i Next.js, povezivanjima za React i Vue i veštinama za AI agente.
Prodavnice na Hydrogen-u 2026-04 ili starijem nastavljaju da rade, a Shopify kaže da trenutno ne morate ništa da preduzimate. Linija 2026.4 je i u oktobru 2026. dobijala izdanja sa ispravkama. Shopify preporučuje prelazak i objavljuje vodič za migraciju, kao i veštinu za migraciju namenjenu AI agentima. Ako prodavnica i dalje radi na Remix-u, prelazak na React Router 7 je deo te migracije.
Jedno praktično upozorenje: opseg sa znakom ^, kao što je ^2026.4.0 u package.json, može da instalira 2026-10, koji donosi izmene koje nisu kompatibilne sa starim kodom. Koristite opseg sa znakom ~, kao što je ~2026.4.0, dok ne budete spremni za migraciju.
Da li se Hydrogen isplati ili je Shopify tema bolji izbor?
Za većinu prodavnica tema je bolji izbor. Shopify u sopstvenoj dokumentaciji kaže da headless prodavnica „košta više za izradu i održavanje nego tema“. Headless preporučuje kada vam treba nešto što „ne može da se postigne Shopify prodajnim kanalima, temama i aplikacijama“, ili kada vaš veb sistem ne koristi Liquid.
| Faktor | Shopify tema (Liquid) | Hydrogen (headless) |
|---|---|---|
| Cena | Niža. Plaćate temu i podešavanje. Hosting je deo vašeg Shopify plana. | Viša. Plaćate prilagođen prednji deo sajta i programere koji ga održavaju. Oxygen je uključen u plaćene planove, a drugi hosting se plaća posebno. |
| Brzina pokretanja | Brže. Online Store, uređivač teme i blokovi aplikacija su odmah spremni. | Sporije. Naši headless projekti sa prilagođenim dizajnom obično traju oko 9 do 10 nedelja. |
| Fleksibilnost | Dobra unutar strukture teme: sekcije, blokovi, metapolja i uređivač teme. | Puna kontrola nad rasporedom, interakcijama, rutama, izvorima podataka i dizajn sistemom. |
| Aplikacije | Većina aplikacija iz App Store-a se instalira u nekoliko klikova, mnoge preko blokova aplikacija u temi. | Blokovi aplikacija u temi ne važe. Svakoj aplikaciji treba API, SDK ili podrška za Shopify-jeve standardne akcije prodavnice, a nekima je potreban dodatni rad. |
| Održavanje | Malo. Shopify hostuje i prikazuje prodavnicu. Temu ažurirate kada vi odlučite. | Stalno. Vi ste vlasnik koda, nadogradnji okvira i Hydrogen-a, promena verzija API-ja i osnovnog SEO-a, kao što su mape sajta i meta tagovi. |
| Uređivanje sadržaja | Vaš tim uređuje stranice u uređivaču teme. | Zavisi od onoga što napravite: metaobjekti, headless CMS ili sopstveni alati. |
Kada se Hydrogen isplati
- Vaš dizajn ili interakcije ne mogu da stanu u temu bez velikih zaobilaznih rešenja, na primer konfiguratori proizvoda ili urednički rasporedi stranica.
- Vaša prodavnica uzima podatke iz više sistema, kao što su headless CMS, PIM, servis za pretragu ili vaši sopstveni API-ji.
- Već imate React ili Vue prednji deo sajta. Od verzije 2026-10 možete da dodate Hydrogen u postojeću Next.js ili React Router aplikaciju, umesto da je pravite ispočetka.
- Iz jedne baze koda opslužujete više brendova, tržišta ili kanala.
- Imate programere, u svom timu ili u agenciji, koji će se starati o prodavnici posle pokretanja.
Kada je tema bolji izbor
- Pokrećete novu prodavnicu ili još proveravate proizvod.
- Vaš tim sam uređuje stranice i kampanje i oslanja se na uređivač teme.
- Vaša prodavnica zavisi od mnogo aplikacija iz App Store-a koje se uklapaju u temu.
- Brzina vam je glavni cilj. Dobro napravljena tema može da bude brza, a headless izrada sama po sebi ne popravlja sporu prodavnicu.
- Želite da vaša prodavnica radi sa AI agentima za kupovinu. Od avgusta 2026. i Liquid prodavnice dobijaju WebMCP alate, pa to samo po sebi nije razlog za prelazak na headless.
Kako koristimo Hydrogen na projektima za klijente?
Headless prodavnice za klijente pravimo na Hydrogen-u i Remix-u. Jedan primer je Carl Friedrik, brend kožnih putnih dodataka. Prešli su na Shopify Plus, a mi smo njihovu prodavnicu iznova izradili kao headless, na Hydrogen-u i Remix-u. Razlozi su bili konkretni: stara postavka je udarala u ograničenje broja varijanti proizvoda i nosila teret previše aplikacija drugih proizvođača. Danas jedan headless sistem pokreće i njihovu direktnu prodaju kupcima i B2B portal sa cenama prema ulozi kupca.
Pre svake Hydrogen izrade planiramo četiri stvari:
- Aplikacije. Popišite svaku aplikaciju koju prodavnica koristi. Recenzije, pretplate, pretraga i programi lojalnosti traže integraciju spremnu za headless ili dodatni rad.
- SEO. Mape sajta, kanonski URL-ovi, strukturirani podaci i meta tagovi sada su deo vašeg koda. Hydrogen 2026-10 je uklonio svoje pomoćne funkcije za mape sajta i SEO, pa ih pišete sami.
- Uređivanje. Dajte marketing timu način da menja sadržaj bez programera, preko metaobjekata ili headless CMS-a.
- Održavanje. Shopify izbacuje novu verziju API-ja svakog kvartala. Predvidite vreme za nadogradnju bar jednom godišnje.
Ako razmišljate o headless izradi, naša usluga Shopify headless razvoja počinje pregledom vaše postojeće prodavnice i iskrenim odgovorom na pitanje da li headless ima smisla. Za Hydrogen projekte, uključujući prelazak na Hydrogen 2026-10, pogledajte Shopify Hydrogen razvoj. Ako vam više odgovara tema, pravimo i prilagođene Shopify teme.
FAQ
Da li je Shopify Hydrogen besplatan?
Jeste. Hydrogen paket je otvorenog koda pod MIT licencom, a Oxygen hosting je uključen bez doplate u plaćene Shopify planove. Pravi trošak je razvoj, jer prilagođenoj prodavnici trebaju programeri koji će je napraviti i održavati.
Da li vam treba Shopify Plus za Hydrogen?
Ne treba. Oxygen je dostupan na plaćenim planovima, od Starter do Plus. Od avgusta 2026. razvojne prodavnice i prodavnice na probnom planu takođe mogu da objavljuju na Oxygen radi testiranja.
Da li je Hydrogen i dalje izgrađen na Remix-u?
Nije. Hydrogen je prešao sa Remix 2 na React Router 7 u verziji 2025.5.0, u maju 2025, nakon što se Remix spojio sa React Router-om. Od verzije 2026-10 Hydrogen je biblioteka koja radi sa React Router 7, Next.js-om i drugim okvirima.
Da li Hydrogen može da se koristi sa Next.js-om?
Može, od verzije Hydrogen 2026-10. Vercel održava Vercel Shop, Next.js prodavnicu izgrađenu na Hydrogen-u koja se objavljuje na Vercel. Sa vašom prodavnicom se povezuje preko Headless kanala.
Da li Shopify aplikacije rade sa Hydrogen prodavnicom?
Neke rade, neke ne. Aplikacije koje dodaju funkcije preko blokova aplikacija u temi napravljene su za Liquid teme. Na Hydrogen-u aplikaciji treba API, SDK ili podrška za Shopify-jeve standardne akcije prodavnice. Proverite svaku aplikaciju od koje zavisite pre prelaska na headless.
Da li je Hydrogen bolji za SEO od teme?
Ne sam po sebi. Hydrogen prodavnice se prikazuju na serveru, pa pretraživači mogu da ih pročitaju, ali mape sajta, meta tagove i strukturirane podatke pravite sami. Brza i dobro strukturirana tema može da se rangira jednako dobro. Hydrogen birajte zbog fleksibilnosti, a ne samo zbog SEO-a.
Idete headless sa Hydrogenom?
Dizajniramo i isporučujemo Hydrogen storefronts koji drže performanse pod stvarnim opterećenjem.
Checklista koju prolazimo pre nego što dotaknemo kod klijenta
Stiže vam na email, uz nekoliko kratkih poruka u naredne dve nedelje: šta najčešće vidimo na Shopify prodavnicama i šta zaista pomaže.
Želite više naših tekstova u Google pretrazi? Dodajte Codersy kao željeni izvor.
Dodaj Codersy na Google(otvara se u novom prozoru)
