Programista Next.js w Krakowie

Programista Next.js dla firm z Krakowa: metadane i mapy witryn po polsku, headless WordPress i WooCommerce, płatności z potwierdzeniem po stronie serwera, dostępne komponenty klienckie. Pisemny zakres, kontrakt B2B.

Programista Next.js

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 Kraków

Mój profil na WordPress.org

#Next.js dla krakowskich firm: co tu naprawdę rozstrzyga o jakości

Piszę frontendy w Next.js 16 dla firm, które sprzedają, rekrutują albo pokazują ofertę w sieci, a ich zaplecze stoi w WordPressie, WooCommerce albo własnym API. Nie opisuję tu każdej funkcji frameworka. Opisuję trzy miejsca, w których projekty w Polsce najczęściej tracą: metadane i mapy witryn w języku polskim, płatności potwierdzane po stronie serwera oraz dostępność komponentów klienckich.

Pracuję sam, zdalnie, od 2006 roku z WordPressem. Układ widoków, makiety i projekt graficzny dostarczasz ty albo twój grafik, ja wdrażam je w działającym, responsywnym interfejsie.

#Skąd w Krakowie zapotrzebowanie na dobry frontend

Krakowski Park Technologiczny ma siedzibę przy ul. Podole 60 i drugi budynek w Czyżynach, przy ul. Życzkowskiego 14, a w ofercie biura w Ruczaju i Czyżynach, coworking oraz programy dla firm. Na swojej stronie opisuje hub4industry jako punkt wsparcia dla firm przemysłowych, które wprowadzają rozwiązania przemysłu 4.0, oraz KPT ScaleUp, program akceleracyjny dla firm przemysłowych z konkretnymi zapotrzebowaniami. Dla branży gier KPT działa od 2012 roku, głównie pod marką Digital Dragons, a jej konferencja odbywa się co roku w maju w ICE Kraków Congress Centre.

Dla briefu to wygodny punkt odniesienia: producent z hubu przemysłowego i studio gier mają różnych odbiorców, ale obie firmy potrzebują serwisu, który opisuje ofertę po polsku i po angielsku, nie dźwiga zbędnych skryptów i pokazuje poprawny podgląd po wklejeniu linku.

Biurowce na Zabłociu w Krakowie

Zdjęcie: Igor123121, CC BY 4.0, Wikimedia Commons.

Miasto samo przesuwa pierwszy krok nowych firm do sieci. W komunikacie na krakow.pl z 29 października 2026 r. Urząd Miasta informuje, że od 1 listopada 2026 r. wnioski o wpis nowej firmy do CEIDG składa się wyłącznie drogą elektroniczną: przez Biznes.gov.pl, usługę Firma w aplikacji mObywatel albo wybrane bankowości elektroniczne. Zmiany danych i zawieszenie działalności można dalej załatwić w Punkcie Obsługi Przedsiębiorcy przy ul. Zabłocie 22. Nowa firma zakłada więc działalność w sieci, a zaraz potem potrzebuje strony, na której klient znajdzie jej nazwę i ofertę.

#Metadane i hreflang w App Routerze, bez niespodzianek

W Next.js 16 metadane definiujesz eksportem metadata albo funkcją generateMetadata, a oba działają tylko w komponentach serwerowych. To ma praktyczny skutek dla stron z interaktywnością: plik page.tsx zostaje serwerowy, a formularz czy konfigurator trafia do osobnego pliku z dyrektywą 'use client'.

Kilka zasad, które stosuję w polskich serwisach:

  • metadataBase w głównym layoucie. Bez niej względna ścieżka w polu wymagającym pełnego adresu kończy się błędem budowania. Z nią alternates.canonical i obrazy Open Graph mają pełne adresy.
  • alternates.languages dla wersji językowych. Z tej samej konfiguracji powstają znaczniki link rel="alternate" hreflang. Kody języków składam z jednej listy adresów, a nie wpisuję ręcznie na każdej stronie.
  • Płytkie scalanie. Dokumentacja podkreśla, że zagnieżdżone pola, jak openGraph i robots, zdefiniowane w layoucie są w całości zastępowane przez stronę, która ustawi własne. Częsty skutek to strona bez opisu Open Graph, bo ktoś podał tylko tytuł.
  • openGraph.locale. Dokumentacja pokazuje format en_US, więc dla polskiej wersji podaję pl_PL.
  • Szablon tytułu. title.template działa dla segmentów potomnych, a nie dla segmentu, w którym go zdefiniowano, i wymaga title.default. Tytuł strony głównej bywa przez to inny niż reszty.

Osobny wątek to podgląd linku w komunikatorach i na portalach społecznościowych. Od wersji 15.2 metadane mogą być doładowane strumieniowo po wysłaniu pierwszego widoku. Dokumentacja pisze, że roboty wykonujące JavaScript, jak Googlebot, interpretują je poprawnie, a dla robotów, które go nie wykonują, jak facebookexternalhit, serwer czeka na generateMetadata i umieszcza metadane w head. Dla każdej ważnej strony sprawdzam na wdrożonej wersji, co zwraca serwer, zanim uznam sprawę za zamkniętą.

#Mapa witryny z WordPressa do Next.js

Gdy treść żyje w WordPressie, mapa witryny frontendu musi znać jego wpisy, ale ich adresy mają wyglądać tak, jak adresy w Next.js. Plik sitemap.ts zwraca tablicę adresów z lastModified, a od wersji 14.2 także z alternates.languages, więc hreflang trafia również do mapy.

Z REST API WordPressa potrzebuję trzech rzeczy z dokumentacji:

  1. Nagłówków X-WP-Total i X-WP-TotalPages, które mówią, ile wpisów i stron wyników jest do przejścia.
  2. Parametru per_page, ograniczonego do 100 rekordów na żądanie.
  3. Parametru _fields, który ogranicza odpowiedź do wskazanych pól, na przykład slug i modified. Dokumentacja pisze, że WordPress pomija wtedy niepotrzebne pola przy budowaniu odpowiedzi.

Dla dużego katalogu produktów dzielę mapę funkcją generateSitemaps. W przykładzie z dokumentacji Next.js limit Google to 50 000 adresów na mapę, a w wersji 16 parametr id jest obietnicą (promise), na którą trzeba poczekać przez await. Każdy adres w mapie sprawdzam potem względem tego, co frontend naprawdę zwraca, bo mapa z adresami przekierowanymi albo nieistniejącymi jest gorsza niż jej brak.

#Płatności: potwierdzenie przychodzi z serwera, nie z przeglądarki

Na przykładzie PayU, którego dokumentacja jest publiczna, widać wzorzec dla każdej polskiej bramki. Po zakończonej płatności klient wraca na adres continueUrl, ale to nie jest dowód zapłaty. Dowodem jest powiadomienie, które PayU wysyła na notifyUrl przy każdej zmianie statusu: PENDING, WAITING_FOR_CONFIRMATION, COMPLETED albo CANCELED.

Z dokumentacji cyklu życia płatności wynikają wymagania, które przekładam na Route Handler w Next.js:

  • Odpowiedź 200. Każdy inny kod powoduje ponowną wysyłkę. Dokumentacja podaje 20 prób, od natychmiastowej do wysłanej do 72 godzin po pierwszej.
  • Duplikaty. Ten sam status może przyjść kilka razy, więc zapis zamówienia musi być idempotentny.
  • Po COMPLETED. Kolejne powiadomienia dla tej płatności ignoruję.
  • Podpis. Nagłówek OpenPayu-Signature weryfikuję na każdym żądaniu: surowa treść powiadomienia plus drugi klucz, hash według wskazanego algorytmu, porównanie z podpisem. W Route Handlerze oznacza to odczyt treści przez request.text() przed jakimkolwiek parsowaniem JSON, bo hash liczy się z surowych bajtów.

Przy BLIK dokumentacja PayU wyróżnia dwa scenariusze. W pierwszym klient przechodzi na stronę płatności BLIK. W drugim wpisuje kod autoryzacyjny na stronie sklepu, a potwierdza w aplikacji banku. Drugi wariant wymaga osobnego punktu płatności (POS) z konfiguracją po stronie PayU i nie łączy się ze scenariuszem przekierowania. Wybór wpływa na układ checkoutu, więc rozstrzygam go w zakresie, zanim powstanie pierwszy komponent.

#Dostępność checkoutu i komponentów klienckich

Next.js ma wbudowany komunikat o zmianie trasy dla czytników ekranu. Dokumentacja opisuje, że ogłasza on nazwę strony, szukając najpierw w document.title, potem w elemencie h1, a na końcu w ścieżce adresu. Każda strona potrzebuje więc unikalnego tytułu i jednego sensownego nagłówka. To zależy od metadanych z poprzedniej sekcji, a nie od osobnego narzędzia.

W dokumentacji eslint-config-next dla wersji 16 jako wchodzące w skład zestawu wymienione są wtyczki react, react-hooks i next. Dodaję więc eslint-plugin-jsx-a11y do konfiguracji sam, żeby brakujące teksty alternatywne i błędne role ARIA wychodziły w CI. Polecenie next lint zostało w Next.js 16 usunięte, więc uruchamiam ESLint bezpośrednio.

W komponentach klienckich pilnuję rzeczy, których lint nie złapie:

  • pole kodu BLIK i pola adresu mają powiązane etykiety i komunikaty błędów czytane przez czytnik,
  • zmiana statusu płatności trafia do regionu aria-live, a nie tylko zmienia kolor przycisku,
  • fokus po błędzie walidacji ląduje na pierwszym błędnym polu,
  • całą ścieżkę zamówienia da się przejść klawiaturą.

#Co mówi prawo

  • Ustawa z 26 kwietnia 2024 r. o zapewnianiu spełniania wymagań dostępności niektórych produktów i usług przez podmioty gospodarcze (tekst w API Sejmu, obowiązuje od 28 czerwca 2025 r.) obejmuje usługi handlu elektronicznego (art. 3 ust. 2 pkt 6). Z jej zakresu wyjęte są usługi mikroprzedsiębiorców (art. 4 pkt 1). Art. 18 pkt 2 wymaga w e-commerce zapewnienia postrzegalności, funkcjonalności, zrozumiałości i kompatybilności funkcji służących identyfikacji, bezpieczeństwu i dokonywaniu płatności.
  • Ustawa z 18 lipca 2002 r. o świadczeniu usług drogą elektroniczną (tekst jednolity, Dz.U. 2024 poz. 1513) w art. 8 ust. 1 pkt 2 wymaga nieodpłatnego udostępnienia regulaminu przed zawarciem umowy. Zakaz wysyłania informacji handlowej bez uprzedniej zgody jest dziś w art. 398 Prawa komunikacji elektronicznej. W Next.js oznacza to link do regulaminu przy zamówieniu i zgodę na newsletter w osobnym polu, bez domyślnego zaznaczenia.
  • Ustawa z 4 kwietnia 2019 r. o dostępności cyfrowej stron internetowych i aplikacji mobilnych podmiotów publicznych (tekst w API Sejmu) dotyczy podmiotów publicznych. Jeśli pracujesz dla jednostki publicznej, jej załącznik opiera się na wytycznych WCAG 2.1.

Nie jestem prawnikiem. Sprawdzenie, czy twoja firma podlega danemu obowiązkowi, zostaje po twojej stronie, a ja wdrażam wynik tej analizy w kodzie.

#Gdzie Next.js, a gdzie coś prostszego

Nie każda strona potrzebuje Next.js. Serwis firmowy bez interaktywnych funkcji zwykle lepiej wychodzi na Astro albo na dobrze przygotowanym motywie WordPress. Sklep na WooCommerce opisuję osobno na stronie o WooCommerce w Krakowie. Next.js wybieram, gdy frontend ma żyć własnym życiem: konto klienta, konfigurator, panel dla partnerów, wspólne komponenty z aplikacją. Ogólne podejście do oddzielenia frontendu od WordPressa opisuje strona o headless CMS.

#Etapy współpracy od pierwszego maila do odbioru

  1. Pisemny brief. Wysyłasz adres serwisu, cel, termin i obecny stack. Odpowiadam na piśmie, w dni robocze.
  2. Pytania i zakres. Zadaję pytania o adresy, które mają zostać, o integracje i o to, kto jest właścicielem treści. Dostajesz zakres z założeniami i wykluczeniami.
  3. Środowisko testowe. Budowa idzie na stagingu, z danymi testowymi bramki płatności.
  4. Odbiór. Przechodzisz listę odbioru, w tym ścieżkę zamówienia klawiaturą i weryfikację podpisu powiadomień płatniczych.
  5. Utrzymanie. Po uruchomieniu możesz zamówić opiekę nad aktualizacjami i monitoringiem. To osobna decyzja.

#Lista kontrolna przed zleceniem

ObszarPytanie do siebie
AdresyCzy mam listę adresów, które muszą zostać, i listę przekierowań?
MetadaneCzy każda strona ma unikalny tytuł i opis po polsku?
JęzykiCzy wersje językowe mają wzajemne hreflang i kanoniczne adresy?
PłatnościCzy status zamówienia zmienia się po zweryfikowanym powiadomieniu?
DostępnośćCzy da się złożyć zamówienie bez myszy?
RegulaminCzy link do regulaminu jest widoczny przed zawarciem umowy?
WydajnośćCzy znam progi z web.dev: LCP do 2,5 s, INP do 200 ms, CLS do 0,1?

#Pytania i odpowiedzi

#Czy strona w Next.js musi mieć osobną mapę witryny, skoro treść jest w WordPressie?

Tak, frontend w Next.js sam odpowiada za swoje adresy. Plik sitemap.ts pobiera listę wpisów z REST API WordPressa, przechodzi po stronach wyników według nagłówka X-WP-TotalPages i zwraca adresy już w kształcie, jaki ma frontend, a nie WordPress. Jeden plik przekroczy sensowny rozmiar przy dużym katalogu, wtedy dzielę go przez generateSitemaps.

#Dlaczego potwierdzenie płatności nie może zależeć od powrotu klienta na stronę?

Klient może zamknąć kartę po płatności w aplikacji banku. PayU wraca do twojej strony przez continueUrl, ale status zamówienia ogłasza osobno, powiadomieniem na notifyUrl. Dlatego zamówienie oznaczam jako opłacone dopiero po zweryfikowanym powiadomieniu o statusie COMPLETED.

#Czy mój sklep musi spełniać wymagania ustawy o dostępności produktów i usług?

Przepisy o dostępności produktów i usług z 2024 roku obejmują handel elektroniczny (art. 3 ust. 2 pkt 6) i obowiązują od 28 czerwca 2025 r. Usług świadczonych przez mikroprzedsiębiorców ustawa nie dotyczy (art. 4 pkt 1). Czy twoja firma jest mikroprzedsiębiorcą, ustalasz na podstawie własnych danych, najlepiej z księgową. Dostępny checkout zakładam niezależnie od progu, bo to część porządnie zrobionego formularza.

#Co z podglądem linku w komunikatorach, skoro metadane w Next.js mogą się doładować później?

Dokumentacja Next.js opisuje to wprost: roboty, które nie wykonują JavaScriptu, jak facebookexternalhit, dostają metadane w znaczniku head, bo serwer czeka na generateMetadata. Googlebot interpretuje metadane doładowane strumieniowo. Na ważnych stronach sprawdzam to jednak na gotowej stronie, a nie tylko w kodzie.

#Kiedy headless WordPress z Next.js ma sens, a kiedy wystarczy motyw klasyczny?

Headless ma sens, gdy redakcja zostaje w WordPressie, a frontend potrzebuje własnej interaktywności albo wspólnego systemu komponentów z aplikacją. Płacisz za to podglądem w edytorze i drugim wdrożeniem do utrzymania. Zwykły serwis firmowy bez takich wymagań zwykle lepiej zostawić na dobrze przygotowanym motywie, i tak to opiszę w pisemnej odpowiedzi.

#Co muszę przygotować przed startem?

Adres obecnego serwisu, dostęp do WordPressa z rolą administratora lub kopię na środowisku testowym, dane testowe bramki płatności, układ widoków od ciebie lub twojego grafika oraz listę adresów, które mają zostać. Wycenę i zakres dostajesz pisemnie, pierwszą wstępną wycenę bez opłat.

#Napisz do mnie

Jeśli prowadzisz firmę w Krakowie i planujesz nowy frontend, przebudowę sklepu albo oddzielenie strony od WordPressa, wyślij mi przez formularz kontaktowy adres obecnego serwisu, cel projektu, termin i używany stack. Odpiszę na piśmie, w dni robocze, a 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 Krakowie. 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 Next.js w Krakowie?

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

Opisz projekt

Sprawdź inne usługi WordPress i bazę wiedzy