Autoryzacja klienta
Rejestracja, logowanie i zarządzanie sesją klienta — route handlery BFF, automatyczne odświeżanie, ochrona stron.
Rejestracja, logowanie i zarządzanie sesją klienta — route handlery BFF, automatyczne odświeżanie, ochrona stron.
Finalizacja zamówienia w storefroncie — adres, metoda wysyłki, płatność i cartComplete. Koszyk jest jedynym aggregate (brak osobnego obiektu Checkout).
DoSwiftly CLI — instalacja, konfiguracja, środowiska i deployment.
Skonfiguruj codegen jedną komendą i wysyłaj publiczne zapytania jako krótki identyfikator (documentId), aby mogły być cacheowane na brzegu.
Dokumentacja dla deweloperów budujących sklepy internetowe na platformie DoSwiftly.
Wielojęzyczność w storefront — SDK language store, next-intl, LanguageSwitcher
Pełna lista poleceń dostępnych w DoSwiftly CLI.
Pola konfiguratora na stronie produktu — dopłaty, komponenty z magazynu i pod-komponenty warunkowe, aż po dodanie skonfigurowanego produktu do koszyka.
Profil, adresy i historia zamówień klienta
Strona konta — dane profilu, statystyki i lista zamówień ze statusem płatności i realizacji. Kod kompilowany przeciw typom SDK (zero drift).
Kwota dopłaty (np. za obsługę pobrania) widoczna na kafelku metody płatności PRZED wyborem i w podsumowaniu PO wyborze. Kod kompilowany przeciw typom SDK (zero drift).
Zarządzanie koszykiem zakupów w storefront
Koszyk z podsumowaniem kosztów i kodami rabatowymi — zastosowanie, usuwanie i rozbicie rabatów. Kod kompilowany przeciw typom SDK (zero drift).
Formularz logowania, stan konta w nagłówku i sesja przeżywająca twardy refresh — bez dynamicznego renderowania layoutu. Kod kompilowany przeciw typom SDK (zero drift).
Use-case guide po mutacjach GraphQL Storefront API — kiedy używać, jak komponować w workflow, co weryfikuje backend.
Zapis i wypisanie z newslettera — widget w stopce, podwójna zgoda, obsługa błędów walidacji.
Wybór dostawy i płatności przetrwają odświeżenie strony — kasa odczytuje zaznaczenia z koszyka i odtwarza je tymi samymi mutacjami. Kod kompilowany przeciw typom SDK (zero drift).
Hooki useStorefrontQuery i useCustomerQuery dla odczytów po stronie przeglądarki, oraz jak podłączyć bibliotekę server-state (TanStack Query / SWR) dla cache w przeglądarce. SDK jest agnostyczne — sam wybierasz mechanizm.
Instrument-level deep-link checkout na storefront — renderowanie tiles per instrument (BLIK kod / mBank / Apple Pay), pre-selekcja z `cartSelectPaymentMethod`, error handling z distinct `INSTRUMENT_PRESELECTION_FAILED` code + warnings array, explicit deselect przez `cartClearPaymentSelection`.
Wyświetlanie, wyszukiwanie i filtrowanie produktów w storefront
Pełny flow poleceń — przechwycenie kodu z linku, rejestracja z kodem polecenia, panel udostępniania kodu ze statystykami. Kod kompilowany przeciw typom SDK (zero drift).
Dokumentacja GraphQL API dla deweloperów storefrontów.
Architektura i koncepcja Storefront SDK dla DoSwiftly
Sekcja „Dane do przelewu" na stronie potwierdzenia — odbiorca, rachunek, tytuł i kwota prosto z API, bez trzymania danych konta w kodzie storefrontu. Kod kompilowany przeciw typom SDK (zero drift).
Kompletne, działające implementacje typowych ekranów storefront — od pobrania danych po gotowy komponent.
Formularz rejestracji sterowany przez sklep (dane firmy, pola własne, ręczne zatwierdzanie kont), formularze kontaktowe oraz katalog z cenami widocznymi dopiero po zalogowaniu.
Jak SDK wpina się w Next.js 16 — StorefrontProvider, BFF auth, GraphQL codegen. To co `doswiftly init` scaffolduje za Ciebie, krok po kroku.
Pure SSR vs SSR z CF Edge cache vs ISR vs SSG z on-demand revalidate — pełna analiza trade-offów, profile użycia, decision matrix i rekomendacje DoSwiftly.
Kompletna strona marki — logo, opis, SEO i lista produktów marki pobrane jednym zapytaniem, plus indeks marek posortowany po liczbie produktów.
Kompletna strona produktu — wybór wariantu, cena z przekreśleniem, dostępność i dodanie do koszyka. Kod kompilowany przeciw typom SDK (zero drift).
Domyślna konwencja adresów storefrontu i deklaracja własnych szablonów URL — segmenty ścieżek, gramatyka szablonu, segment-strażnik bloga, wielojęzyczność i skutki zmiany slugów.
Stwórz swój pierwszy storefront na platformie DoSwiftly w kilka minut.
Anonimowa, cookieless telemetria odwiedzin wbudowana w SDK — źródła ruchu i licznik osób obecnych na stronie, bez ciasteczek i bez danych osobowych.
Reference typów GraphQL Storefront API — przekierowanie do auto-generowanego katalogu
Kolekcje, kategorie, marki, karty podarunkowe, program lojalnościowy, zwroty i multi-walutowość
Paczkomat i punkt odbioru w kroku dostawy — mapa przewoźnika albo wyszukiwarka punktów, w zależności od tego, co sklep ma skonfigurowane. Kod kompilowany przeciw typom SDK (zero drift).
Dostęp do podsumowania zamówienia — autentykowany customer, guest po checkout, top-level line items z N+1 prevention
Use-case guide po polsku — kiedy używać każdej query w DoSwiftly Storefront API, z inline reference auto-generowanym z @doswiftly/storefront-operations.