Wdrożenie sklepu na Medusie - Medusa v2 i Next.js
Medusa v2 to framework e-commerce, który instalujesz u siebie, a nie abonament z gotowym szablonem. Sprawdza się tam, gdzie sposób sprzedaży nie mieści się w ustawieniach platformy i trzeba go zaprogramować, zamiast obchodzić.
Kiedy sklep abonamentowy przestaje wystarczać
Na początku platforma abonamentowa zwykle spełnia oczekiwania. Sklep działa, płatności przechodzą, aktualizacje robi dostawca, a Ty zajmujesz się sprzedażą.
Problem pojawia się po cichu, jako pytanie z firmy, na które odpowiedź brzmi „nie da się”. Inaczej liczony rabat dla stałych klientów, osobne pakowanie dla jednego kanału sprzedaży, dodatkowe pole na zamówieniu, o które prosi dział handlowy. Każde takie „nie da się” kończy się ręczną czynnością, którą ktoś powtarza co tydzień.
Model danych, zasady koszyka, terminy wydań i cennik ustala dostawca. Dopóki sprzedajesz tak, jak przewiduje szablon, to wygodne. Gdy zaczynasz sprzedawać inaczej, płacisz czasem pracowników, a nie wyższym abonamentem, i dlatego ten koszt tak długo pozostaje niezauważony.
Czym jest Medusa v2
Medusa v2 to framework e-commerce na licencji MIT, który uruchamiasz na własnej infrastrukturze. Jest napisany w TypeScripcie na Node.js i korzysta z bazy PostgreSQL. Możliwość rozbudowy jest w nim zaplanowana od początku, a nie dodana później.
Moduły. Opisujesz nimi to, co faktycznie funkcjonuje w Twojej firmie, zamiast dopasowywać firmę do gotowego modelu.
Workflow. Mają trwałe kroki, więc proces wieloetapowy przetrwa awarię w połowie i nie zostawia pytania, co się wykonało, a co nie.
Subscribery. Reagują na zdarzenia w sklepie, zamiast co kwadrans przeszukiwać bazę w poszukiwaniu zmian.
Rozszerzenia panelu. Nowy ekran w panelu dodajesz wtyczką, a nie zgłoszeniem do dostawcy i czekaniem.
Do tego baza danych należy do Ciebie. Docenisz to przy pierwszym pytaniu o własną sprzedaż, na które odpowiada zapytanie SQL, a nie zgłoszenie do supportu.
Front sklepu w Next.js
W modelu headless sklep, który widzi klient, to osobna aplikacja połączona z warstwą sprzedaży przez API. Budujemy ją w Next.js, a jako oficjalny partner Vercela znamy tę technologię od podszewki.
W praktyce oznacza to, że przebudowa sklepu jest pracą przy froncie. Nowy układ strony, nowe strony sprzedażowe, inny sposób przeglądania oferty: nic z tego nie wymaga zmian w warstwie sprzedaży ani walki z systemem szablonów. Obie części rozwijają się niezależnie.
Medusa czy platforma abonamentowa?
Headless nie zawsze jest dobrym wyborem i wolimy napisać to tutaj niż dopiero na trzecim spotkaniu.
Przy własnym wdrożeniu płacisz za front, który trzeba zbudować i utrzymać, oraz za aktualizacje, hosting i odpowiedzialność za działanie sklepu. Abonament załatwiał to wszystko bez Twojego udziału. Przy małym katalogu i standardowym procesie, gdy sklep ma przede wszystkim dobrze wyglądać i przyjmować płatności, platforma abonamentowa prawdopodobnie wyjdzie lepiej i taniej. Tak też doradzimy.
Wdrożenie na Medusie ma mocne uzasadnienie w czterech sytuacjach:
Proces nie mieści się w szablonie. Nie da się go ustawić w panelu platformy, choćby się próbowało.
Kilka systemów musi się zgadzać. Wokół jednego zamówienia pracuje więcej niż sam sklep.
Front jest Twoją przewagą. Sklep ma być czymś więcej niż gotowym motywem.
Ograniczenia platformy stały się stałą pracą ręczną. Ktoś co tydzień robi to, czego sklep nie potrafi.
Nasze wtyczki do Medusy
Wydaliśmy jako open source siedem wtyczek do Medusa v2, każdą z własną dokumentacją. To nie projekty na pokaz, tylko kod, który działa w naszym sklepie: subskrypcje i rozliczenia za użycie w naszej platformie obsługuje sklep na Medusie, który hostujemy sami.
Każda wtyczka trzyma paczki Medusy w peer dependencies i nie dołącza frameworka do siebie. Dzięki temu buduje się na wersji, którą sklep już ma, zamiast wymuszać własną. Przestrzegamy tego ograniczenia, bo sami musimy z nim żyć.
Kod i dokumentację możesz przejrzeć, zanim cokolwiek zamówisz. Lista wtyczek jest pod adresem /docs/medusa-plugins, a sprawdzenie czyjejś pracy przed zleceniem to rozsądne podejście.
Co dostajesz
Backend Medusa v2 na Twoim serwerze
Node.js i TypeScript z bazą PostgreSQL, uruchomione tam, gdzie wskażesz. Kod i dane leżą na Twoim koncie, nie w panelu dostawcy, do którego tylko się logujesz.
Model danych skrojony pod Twoją ofertę
Własne moduły dla tego, co sprzedajesz naprawdę, a czego szablon platformy nie przewiduje. Trudniejsza część katalogu nie musi już żyć w arkuszu obok sklepu.
Front sklepu w Next.js
Oddzielna aplikacja, która pobiera dane z API sprzedaży. Odświeżenie wyglądu sklepu to wtedy praca nad frontem, a nie przenosiny na inną platformę.
Obsługa zamówień zaprogramowana, nie wyklikana
To, co dzieje się po złożeniu zamówienia, działa jako workflow z trwałymi krokami i subscribery reagujące na zdarzenia. Nie ma ustawień, których możliwości kiedyś się kończą.
Panel dopasowany do Waszej codziennej pracy
Panel administracyjny Medusy dostaje ekrany i kolumny potrzebne przy obsłudze zamówień, więc zespół nie ucieka po cichu do eksportów i arkuszy.
Środowiska, deploy i dokumentacja
Środowisko testowe, powtarzalne wdrożenia i opis na tyle konkretny, że projekt przejmie inny zespół. Systemu, którego nie da się przekazać, nie posiadasz, tylko go od nas wynajmujesz.
Jak pracujemy
- 01
Szukamy procesu, który nie pasuje do platformy
Zwykle to jedna konkretna rzecz skłania do zmiany platformy. Poznajemy ją na początku, bo jeśli da się ją ustawić tam, gdzie jesteś, powiemy Ci, żebyś został.
- 02
Definiujemy produkt i zamówienie
Ustalamy, co jest produktem, a co wariantem i jakie warunki muszą być spełnione, gdy klient składa zamówienie. To decyzje biznesowe, a podjęte przed pisaniem kodu kosztują znacznie mniej.
- 03
Budujemy backend i front jednocześnie
To dwie niezależne aplikacje, które łączy uzgodnione wcześniej API. Zespół od frontu nie musi czekać, aż warstwa sprzedaży będzie gotowa.
- 04
Uruchamiamy nowy sklep równolegle ze starym
Przełączamy ruch dopiero wtedy, gdy katalog, ceny i zamówienia zgadzają się w obu systemach, a nie w terminie ustalonym z góry. Najpierw porównanie, potem przełączenie.
- 05
Przekazujemy wszystko
Repozytorium, infrastrukturę, dostępy i dokumentację. Framework ma licencję MIT, a baza jest Twoja, więc dalsze prowadzenie sklepu bez nas ma być realną możliwością.
Narzędzia i technologie
Tam, gdzie istnieje dobre narzędzie open source, wybieramy je zamiast zamkniętego. Bez uzależnienia od jednego dostawcy i z kosztami, które da się przewidzieć.
- Medusa v2
- Node.js
- TypeScript
- PostgreSQL
- Redis
- Next.js
- React
- Vercel
- Stripe
- Docker
- GitHub Actions
Najczęściej zadawane pytania
Pozostałe usługi w tej kategorii
Integracje z marketplace'ami: Allegro
Sprzedajesz na Allegro i we własnym sklepie? Zwykle oznacza to jeden katalog prowadzony w dwóch miejscach i arkusz, który próbuje je pogodzić. Oferty, stany i zamówienia z Allegro mogą trafiać do tego samego panelu, w którym zarządzasz resztą towaru.
Automatyzacja cen i kontrola marży
Sklep sam przelicza ceny w euro i dolarach po średnim kursie NBP, a koszt zakupu widać przy każdym produkcie. Marżę sprawdzasz w panelu od ręki, zamiast raz w miesiącu składać ją w arkuszu.
Fakturowanie i KSeF w sklepie internetowym
Od kwietnia 2026 faktura dla firmy z NIP musi trafić do KSeF, a od stycznia 2027 za brak wysyłki grożą kary. Sklep może wystawiać i wysyłać faktury automatycznie, jeśli w niejasnych sytuacjach zostawia decyzję człowiekowi.
Przeczytaj opinie firm, które nam zaufały
Dostarczone znacznie wcześniej niż termin.
Indywidualne podejście ZanReal jest imponujące.
Wiedza i intuicja biznesowa czynią ich wartościowym partnerem.
Szybkie rozwiązania, które obniżyły koszty o 99%.
+20% dostarczalności dla naszych kampanii e-mail.
Najnowsze
Poradniki techniczne, bezpieczeństwo i nasze doświadczenia z budowania rozwiązań AI.
Ciekawi Cię, co dalej?
Zobacz wszystkie postyCo w Twoim sklepie trzeba dziś robić obok platformy?
Napisz do nasOpisz jeden proces, który obchodzicie ręcznie albo w arkuszu. Odpowiemy uczciwie, czy przejście na Medusę się zwróci, czy lepiej zostać na obecnej platformie.
Nie nadążasz za zmianami w świecie AI?
Pozwól, że weźmiemy to na siebie. Co tydzień destylujemy najważniejsze wydarzenia ze świata AI w skupiony, 5-minutowy przegląd - żebyś był na bieżąco bez szumu.
Dowiedz się więcej