Programista Shopify w Gdańsku

Programista Shopify w Gdańsku, jednoosobowo i zdalnie. Kiedy headless na Hydrogen i Storefront API ma sens, a kiedy motyw Liquid wystarcza, według dokumentacji shopify.dev.

Programista Shopify

Moje miejsce w społeczności WordPress

  • Konto na wordpress.org mam od 2006 roku.
  • Współtworzyłem rdzeń WordPressa w wersjach 7.0 i 7.1.
  • Utrzymuję 30 wtyczek na wordpress.org.
  • Organizuję WordCampy i występuję na nich jako prelegent.
  • Byłem na każdym WordCamp Europe od 2017 do 2026 roku.
  • Lokalne spotkania WordPressa: WordUp Trójmiasto

Mój profil na WordPress.org

#Programista Shopify w Gdańsku, jednoosobowo i zdalnie

Jestem Mariusz Szatkowski i prowadzę jednoosobową firmę w Gdyni. Z WordPressem pracuję od 2006 roku, a sklepy na Shopify robię dla firm z Gdańska zdalnie, bez spotkań i telefonów. Ta strona odpowiada na jedno pytanie, które pada najczęściej przy większym sklepie: czy iść w headless, czyli własny frontend na Storefront API, czy zostać przy motywie Liquid.

Odpowiedź w dokumentacji Shopify jest ostrożniejsza, niż sugerują materiały sprzedażowe. Według przeglądu headless na shopify.dev headless rozważasz wtedy, gdy potrzeb firmy nie da się zrealizować kanałami sprzedaży, motywami i aplikacjami. Ten sam przegląd zaznacza, że headless kosztuje więcej w budowie i utrzymaniu niż motyw, więc przed decyzją trzeba mieć zgodę właściciela na ten koszt i złożoność oraz developerów, którzy zajmą się sklepem po starcie.

Gdańsk, ulica Mariacka

Zdjęcie: tawa, CC BY-SA 3.0, Wikimedia Commons.

#Co to jest headless w rozumieniu Shopify

Headless oddziela frontend sklepu od backendu. Frontend budujesz sam, a dane i funkcje handlowe, czyli produkty, kolekcje, klientów, koszyk, checkout i ceny międzynarodowe, dostajesz z Shopify. Do którejkolwiek strony możesz też podłączyć inne systemy, na przykład CMS, CRM, ERP albo PIM.

Shopify udostępnia dwa API do takiego sklepu:

  • Storefront API zwraca produkty, kolekcje, wyszukiwanie i koszyk, a potem przekazuje klienta do checkoutu.
  • Customer Account API pozwala klientowi zalogować się i zwraca jego zamówienia, adresy i profil.

Dostęp dostajesz przez jeden z dwóch kanałów sprzedaży w panelu Shopify. Kanał Headless jest dla frontendu hostowanego gdziekolwiek, kanał Hydrogen dla sklepów wdrażanych na Oxygen, czyli hostingu Shopify. Każdy z nich daje publiczny token do żądań z przeglądarki i prywatny token do żądań z serwera. Prywatnego tokenu nie wolno umieszczać w kodzie po stronie klienta ani nadawać mu przedrostka przeglądarkowego, takiego jak NEXT_PUBLIC_. Źródło: przegląd headless.

#Czym Hydrogen jest dzisiaj

Jeśli ostatnio czytałeś o Hydrogenie jako o szkielecie opartym na Remixie, ta wiedza jest nieaktualna. Dokumentacja Hydrogen obejmuje wersję 2026-10 i opisuje go jako zestaw narzędzi, który dodajesz do frameworka, którego już używasz. Dla pełnych sklepów współpracuje z frameworkami uruchamiającymi kod serwerowy, jak Next.js, React Router, Nuxt, Astro i SvelteKit. Routing, renderowanie i interfejs zostają po stronie frameworka.

Dokumentacja podaje dwa szablony startowe:

  • React Router 7 w trybie framework, wdrażany na Oxygen,
  • Next.js (szablon Vercel Shop, App Router), wdrażany na Vercel.

Dla Astro, Nuxt, SvelteKit i SolidStart repozytorium zawiera przykłady rozwojowe, ale nie szablony startowe. Starsze wersje Hydrogen, 2026-04 i wcześniejsze, mają osobną dokumentację legacy oraz przewodnik migracji.

Hydrogen bierze na siebie te części, które są specyficzne dla Shopify i łatwo je zepsuć: klienta Storefront API, koszyk, wybór wariantu, filtrowanie kolekcji, analitykę oraz trasy potrzebne aplikacjom i checkoutowi. Przy tym:

  • Koszyk działa też bez JavaScriptu, bo zmiany wracają do Hydrogena przez zwykłe formularze HTML.
  • Gdy router nie znajdzie strony, Hydrogen sprawdza przekierowania zapisane w sklepie, zanim klient dostanie błąd 404. To ma znaczenie przy migracji ze starego sklepu.
  • Aplikacje i agenci zakupowi mogą czytać i zmieniać koszyk tym samym kontraktem zdarzeń, który obowiązuje w motywach Liquid.

#Czego Hydrogen nie robi za ciebie

Ta lista decyduje, ile naprawdę kosztuje headless. Według tej samej dokumentacji po stronie twojej aplikacji zostają:

  • komponenty, układ i styl, bo Hydrogen nie ma biblioteki komponentów,
  • routing, ładowanie danych i strategia renderowania,
  • przechowywanie sesji zalogowanego klienta, na przykład w podpisanym ciasteczku HttpOnly,
  • strony konta: profil, historia zamówień, adresy,
  • obrazy, SEO, metatagi i dane strukturalne.

Interfejsu checkoutu Hydrogen też nie zawiera, bo checkout zostaje na Shopify. To dobra wiadomość dla sklepu, który nie chce utrzymywać własnej obsługi płatności. To zła wiadomość dla kogoś, kto liczy, że headless pozwoli przebudować cały lejek zakupowy.

#Kiedy headless się nie opłaca

Poniższe wnioski to moja ocena oparta na zapisach z dokumentacji, nie cytat z niej.

SytuacjaMoja rekomendacjaDlaczego
Mały lub średni katalog, standardowy układ sklepuMotyw LiquidSekcje i bloki wystarczają, a headless dokłada pracę nad koszykiem, kontem i SEO
Brak developera po starcieMotyw LiquidShopify sam wymienia opiekę developerów nad sklepem jako warunek decyzji
Sklep mocno opiera się na aplikacjach z paneluMotyw LiquidRozszerzenia motywu działają w edytorze motywu, a w headless trzeba sprawdzić każdą aplikację osobno
Redaktorzy chcą sami układać strony w edytorze motywuMotyw LiquidHeadless przenosi układ do kodu albo do osobnego CMS
Treści redakcyjne w osobnym CMS, własny stos frontendowy, wiele kanałówHeadlessTo przypadki, które Shopify wymienia jako uzasadnione
Istniejąca infrastruktura, do której chcesz dodać handelHeadlessStorefront API da się wpiąć w gotowy serwis
Treści na WordPressie, a sprzedaż na ShopifyWtyczka Shopify dla WordPressa albo headlessZob. sekcja niżej

Test praktyczny: jeśli powód do headless da się zapisać jednym zdaniem w stylu “klient dzięki temu zrobi X, czego motyw nie pozwala”, to jest argument. Jeśli jedyny powód brzmi “bo będzie nowocześniej”, motyw jest tańszą i bezpieczniejszą drogą.

#Wersje API, limity i zmiany po starcie

Storefront API, Customer Account API i Hydrogen są wersjonowane. Według zasad wersjonowania nowa wersja wychodzi co trzy miesiące, pierwszego dnia kwartału o 17:00 UTC. Stabilna wersja jest wspierana co najmniej 12 miesięcy, a wersje nakładają się przez co najmniej dziewięć miesięcy. Przestarzałe pola są usuwane w kolejnym wydaniu, a nie z dnia na dzień. Hydrogen jest wersjonowany według wydań głównych.

Są też powierzchnie bez wersji, które mogą się zmienić w każdej chwili, między innymi Customer Privacy API, Web Pixels API, Liquid i Shop Pay. Dla sklepu headless znaczy to jedno: ktoś musi regularnie przeglądać dziennik zmian i podnosić wersję. Dlatego przy ofercie headless opisuję tę pracę jako osobną pozycję, a nie dodatek.

Limity Storefront API są łagodniejsze, niż wielu się obawia. Ruch prawdziwych kupujących nie ma stałego limitu żądań na minutę, a pojemność dla publicznego dostępu rośnie z liczbą kupujących. Ograniczany jest ruch automatyczny, czyli boty i crawlery, oraz tworzenie checkoutu, które jest dławione na minutę. Dostęp bez tokenu obejmuje produkty, kolekcje, wyszukiwanie i koszyk, z limitem złożoności zapytania 1000. To wygodne do prototypu, ale produkcyjny sklep używa tokenów.

#Zgody na cookies i analityka w sklepie headless

W motywie zgody ustawia się w panelu Shopify i w aplikacjach. W headless frontend jest twój, więc baner i analityka też. Dokumentacja analityki Hydrogen wymaga zgodności z przepisami o zgodzie klienta, zanim zaczniesz zbierać dane. Poleca wbudowane Customer Privacy API i natywny baner Shopify albo zewnętrzne narzędzie do zarządzania zgodami.

Polski punkt odniesienia to Prawo komunikacji elektronicznej, Dz.U. 2024 poz. 1221, status w bazie Sejmu: obowiązujący. Art. 399 ust. 1 dopuszcza przechowywanie informacji w urządzeniu końcowym albo dostęp do niej po uprzednim poinformowaniu użytkownika o celu i po jego zgodzie. Ust. 3 wyłącza ten wymóg, gdy zapis lub dostęp jest konieczny do świadczenia usługi żądanej przez użytkownika. Informacja handlowa, na przykład newsletter, ma osobną zasadę w art. 398: wymaga uprzedniej zgody. Które cookies i piksele w twoim sklepie są konieczne, a które wymagają zgody, ustalam z tobą na piśmie przed wdrożeniem, bo od tego zależy konfiguracja analityki.

#Sprzedaż z WordPressa na Shopify

Jeśli treści masz na WordPressie, jest trzecia droga. Według dokumentacji wtyczka Shopify działa jak kanał sprzedaży dla sklepów osadzonych w witrynie WordPress. Pokazuje produkty i kolekcje ze Shopify, a zamówieniami zarządzasz w Shopify. Karty produktów, widoki szybkiego podglądu, strony produktów i kolekcje opierają się na Storefront Web Components. Wtyczka jest oficjalnie wspierana z domyślnymi motywami blokowymi Twenty Twenty-Three, Twenty Twenty-Four i Twenty Twenty-Five. Inne motywy mogą wymagać dodatkowej pracy. Wtyczkę pobiera się z wordpress.org/plugins/shopify-plugin.

To dobra opcja dla firmy, która ma rozbudowany blog lub strony ofertowe na WordPressie i nie chce ich przenosić do headless CMS. Szersze omówienie samego Shopify znajdziesz na stronie programista Shopify, a headless z osobnym CMS na stronie programista headless CMS.

#Gdańsk: targi AMBERIF jako przykład sprzedaży B2B i B2C

Gdańsk ma jedno wydarzenie, które dobrze ilustruje dylemat headless. AMBERIF, Międzynarodowe Targi Bursztynu i Biżuterii, odbywa się co roku wiosną. Organizator podaje, że edycja 2026 trwała 26 do 28 marca i miała 213 wystawców, a najbliższa jest zaplanowana na 11 do 13 marca 2027.

Weźmy hipotetyczną pracownię jubilerską, która sprzedaje detalicznie i hurtowo. Ma to konkretne skutki dla wyboru technologii. Katalog z wariantami, certyfikatami i opisami materiałów zmieści się w motywie. Osobne ceny dla kontrahentów z targów to temat B2B w samym Shopify i nie wymaga headless. Headless zaczyna mieć sens dopiero wtedy, gdy ta sama marka chce połączyć sklep z własnym serwisem redakcyjnym o historii wyrobów, z rozbudowaną wyszukiwarką albo z aplikacją mobilną. To jest przykład rozumowania, nie opis klienta.

#Przebieg projektu Shopify od briefu do akceptacji

  1. Piszesz brief: adres sklepu, cel, termin, obecny stos i aplikacje.
  2. Odpowiadam pytaniami na piśmie. Pytam o katalog, liczbę wariantów, integracje z ERP lub magazynem i o to, kto będzie utrzymywał sklep.
  3. Dostajesz pisemną rekomendację: motyw czy headless, z uzasadnieniem po każdym punkcie z tabeli wyżej, oraz zakres i założenia.
  4. Pracuję na środowisku testowym. Przy motywie to kopia motywu w Shopify, przy headless osobne wdrożenie podglądowe.
  5. Akceptacja odbywa się na liście kontrolnej uzgodnionej na początku: koszyk, checkout, przekierowania, zgody, wyniki Core Web Vitals.
  6. Po starcie możesz zamówić opiekę, w tym podnoszenie wersji API opisane wyżej.

Wydajność oceniam według progów z web.dev: LCP do 2,5 s, INP do 200 ms, CLS do 0,1, mierzone na danych z pola, a nie tylko w teście laboratoryjnym.

#Co przygotowujesz ty

  • Dostęp do sklepu Shopify w roli staff z uprawnieniami do motywów i aplikacji, o których zdecydujemy na piśmie.
  • Listę aplikacji, z których sklep korzysta, i informację, które są niezbędne.
  • Projekt graficzny, makiety i wireframe. Projektu graficznego nie wykonuję: wdrażam układ, który dostarczasz. Gdy układu jeszcze nie ma, dostajesz ode mnie arkusz do zaznaczenia, co ma się znaleźć na którym widoku.
  • Treści, zdjęcia produktów i, przy migracji, listę adresów starego sklepu.
  • Informację, kto po stronie firmy podejmuje decyzje o zakresie i odbiera pracę.

#Powiązane strony

Dla Gdańska opisałem osobno Next.js, Astro, WooCommerce i migrację do Astro i Next.js. Zasady współpracy w sąsiednim mieście opisuje strona programista Shopify w Gdyni.

#Najczęstsze pytania

#Czy sklep w Gdańsku musi być headless, żeby był szybki?

Nie. Shopify wymienia headless jako rozwiązanie na sytuacje, w których motywy, kanały sprzedaży i aplikacje nie dają tego, czego firma potrzebuje. Wolny sklep na motywie najczęściej da się przyspieszyć w samym motywie, więc zaczynam od pomiaru, a nie od zmiany architektury.

#Czy Hydrogen to nadal Remix?

Dokumentacja Hydrogen w wersji 2026-10 opisuje go jako zestaw narzędzi dodawany do frameworka, którego już używasz, na przykład React Router, Next.js, Nuxt, Astro albo SvelteKit. Szablon startowy oparty na React Router 7 jest wdrażany na Oxygen, a drugi, na Next.js, na Vercel. Starsze wersje 2026-04 i wcześniejsze mają osobną dokumentację legacy.

#Czy po przejściu na headless checkout też będzie mój?

Nie. Hydrogen nie zawiera interfejsu checkoutu, bo checkout zostaje na Shopify. Storefront API przekazuje klienta do checkoutu, a wygląd tej części ustawiasz w Shopify, nie w kodzie własnego frontendu.

#Co z aplikacjami z App Store, kiedy sklep jest headless?

To trzeba sprawdzić osobno dla każdej aplikacji. Rozszerzenia motywu są w dokumentacji opisane jako integracja z motywami Online Store 2.0, a w headless nie ma motywu. Dla każdej aplikacji pytam więc, czy ma własne API albo komponent, który da się wywołać z frontendu.

#Jak rozwiązać zgody na cookies w sklepie headless?

Dokumentacja Hydrogen poleca wbudowane Customer Privacy API wraz z natywnym banerem zgód albo zewnętrzne narzędzie do zarządzania zgodami. Podstawą prawną w Polsce jest art. 399 Prawa komunikacji elektronicznej. Konkretny wybór ustalamy na piśmie przed startem prac.

#Kto dostarcza projekt graficzny sklepu?

Ty. Projekt graficzny, makiety i wireframe pochodzą od klienta, a ja je wdrażam w motywie albo we frontendzie headless. Gdy układu jeszcze nie ma, dostajesz ode mnie arkusz do zaznaczenia, które elementy mają się znaleźć na których widokach.

#Napisz, jeśli wybierasz między motywem a headless

Wyślij mi przez formularz kontaktowy adres sklepu, cel, termin, obecny stos i listę aplikacji. Odpowiem pisemnie w dni robocze. Pierwsza wstępna wycena jest bezpłatna.

Zobacz też w innych miastach Polski

Najbliższe wydarzenia WordPress

Spotkaj się z nami na WordCampie

Dołącz do społeczności WordPress w Gdańsku. Regularnie bywam na meetupach i WordCampach w całej Polsce - WordUp Trójmiasto, WordCamp Polska i WordCamp Europe. Podejdź i porozmawiajmy.

Dodaj kalendarz WP

Potrzebujesz usługi: Programista Shopify w Gdańsku?

Opisz projekt mailem. Odpowiadam w ciągu 48 godzin.

Opisz projekt

Sprawdź inne usługi WordPress i bazę wiedzy