· Sebastian Kubat

MedusaJS: co to jest i kiedy warto zbudować na niej sklep internetowy

MedusaJS to darmowy silnik sklepu internetowego open source, napisany w Node.js i TypeScript. Nie ma własnego „wyglądu”. Dostarcza logikę sprzedaży (produkty, koszyk, zamówienia, płatności, magazyn) przez API, a frontend buduje się osobno, najczęściej w Next.js. Medusa opłaca się firmom, które potrzebują własnej logiki sprzedaży: cenników B2B, wielu magazynów, marketplace’u albo sprzedaży w wielu krajach, i nie chcą płacić abonamentu ani prowizji od obrotu. Przy prostym sklepie z gotowym szablonem lepszym i tańszym wyborem pozostaje PrestaShop, WooCommerce albo Shopify.

Poniżej wyjaśniamy, jak działa Medusa, czym różni się od popularnych platform, ile kosztuje sklep zbudowany na niej i kiedy lepiej jej nie wybierać.

Czym jest MedusaJS?

Medusa to platforma e-commerce typu headless. Część „sklepowa” (backend) działa na serwerze i udostępnia dane przez API. Część, którą widzi klient (storefront), to osobna aplikacja, która z tego API korzysta. Dzięki temu ten sam silnik może obsługiwać sklep www, aplikację mobilną, portal dla klientów B2B czy kiosk w salonie.

Najważniejsze cechy:

  • Open source. Rdzeń Medusy jest udostępniany na licencji MIT. Można go bezpłatnie używać, modyfikować i hostować na własnym serwerze, bez opłat licencyjnych i prowizji od sprzedaży.
  • Architektura modułowa. Od wersji 2 (październik 2024) każda funkcja, np. produkty, ceny, koszyk, zamówienia, magazyn czy płatności, jest osobnym modułem. Moduły można wymieniać, rozszerzać i dopisywać własne.
  • TypeScript i Node.js. Ten sam język po stronie backendu i frontendu. Jeden zespół JavaScript może rozwijać cały sklep.
  • Panel administracyjny w zestawie. Medusa Admin pozwala zarządzać produktami, zamówieniami, klientami i promocjami. Panel można rozszerzać o własne widoki.
  • Workflows. Procesy biznesowe, np. złożenie zamówienia, zwrot czy synchronizację z ERP, opisuje się jako kroki z automatycznym wycofaniem zmian, gdy któryś krok się nie powiedzie.

Jak wygląda architektura sklepu na Medusie?

Typowy sklep, który budujemy na Medusie, składa się z czterech warstw:

  1. Medusa (backend): logika sprzedaży, baza PostgreSQL, API dla frontendu i integracji.
  2. Storefront w Next.js: szybki frontend renderowany po stronie serwera, dobrze widoczny w Google i gotowy pod dane strukturalne produktów.
  3. CMS, np. Sanity: dział marketingu sam edytuje landingi, opisy kategorii i kampanie, bez udziału programisty.
  4. Integracje: płatności, kurierzy, ERP, Merchant Center, analityka GA4.

Taki podział sprawia, że każdą warstwę można rozwijać i skalować osobno. Więcej o samej idei przeczytasz we wpisie Co to jest headless CMS i jak wykorzystać go w e-commerce B2B.

MedusaJS vs Shopify vs PrestaShop: porównanie

MedusaJS Shopify PrestaShop
Model Open source, headless SaaS (abonament) Open source, klasyczny (możliwy headless)
Opłaty licencyjne Brak (rdzeń MIT) Abonament + opłaty transakcyjne zależne od planu i bramki Brak, płatne moduły
Własna logika sprzedaży Pełna swoboda, kod po Twojej stronie Ograniczona do API i aplikacji Duża, przez moduły i nadpisania
Gotowe wtyczki Mniej, część integracji trzeba napisać Bardzo dużo aplikacji Bardzo dużo modułów, także pod rynek polski
Hosting Własny serwer lub Medusa Cloud W cenie abonamentu Własny serwer
Technologia Node.js, TypeScript Liquid / Hydrogen (React) PHP, Symfony
Najlepszy dla B2B z nietypowym procesem, marketplace, wiele kanałów i krajów Marki D2C, szybki start Sklepy B2B i B2C z dużym katalogiem

Kiedy Medusa się opłaca?

  • Masz nietypowy proces sprzedaży. Na przykład cenniki per kontrahent, limity kupieckie, akceptację zamówień przez kilka osób, sprzedaż na raty albo subskrypcje. W Medusie piszemy tę logikę bezpośrednio, zamiast obchodzić ograniczenia gotowej platformy.
  • Sprzedajesz w wielu kanałach. Jeden backend obsługuje sklep www, portal B2B, aplikację mobilną i marketplace.
  • Chcesz być właścicielem kodu i danych. Bez uzależnienia od dostawcy SaaS i bez prowizji od każdej transakcji. Przy dużym obrocie różnica w kosztach rośnie z każdym rokiem.
  • Masz lub planujesz zespół JavaScript. Ten sam stack (TypeScript, Node.js, React/Next.js) po stronie sklepu i frontendu ułatwia rozwój.
  • Myślisz o sprzedaży przez agentów AI. Medusa od początku komunikuje się przez API, więc łatwiej przygotować ją na zakupy realizowane przez asystentów AI.

Kiedy Medusa się NIE opłaca?

  • Prosty sklep B2C z typowym procesem. PrestaShop, WooCommerce lub Shopify uruchomisz szybciej i taniej, korzystając z gotowych modułów.
  • Brak budżetu na rozwój. Medusa daje swobodę, ale każdą funkcję spoza standardu trzeba zaprojektować i zaprogramować.
  • Potrzebujesz wielu gotowych integracji z polskimi usługami „od ręki”. Ekosystem wtyczek jest mniejszy niż w PrestaShop czy WooCommerce, więc część integracji (np. z wybranymi kurierami, bramkami płatności czy systemami księgowymi) trzeba napisać.
  • Nie masz kto utrzymywać aplikacji Node.js. Sklep na Medusie to aplikacja, którą trzeba aktualizować i monitorować. Bez opieki technicznej lepiej wybrać SaaS.

Ile kosztuje sklep na MedusaJS?

Sama Medusa jest bezpłatna. Płaci się za wdrożenie, hosting i rozwój:

  • Wdrożenie. Sklep na Medusie z frontendem w Next.js to projekt headless. W naszej praktyce takie projekty kosztują zwykle 100–500 tys. zł, zależnie od liczby integracji, złożoności logiki cenowej i zakresu frontendu. Rozbicie kosztów opisujemy we wpisie Ile kosztuje sklep internetowy B2B w 2026 roku.
  • Hosting. Do wyboru jest własna infrastruktura (serwer lub chmura, baza PostgreSQL) albo Medusa Cloud, czyli płatny hosting od twórców platformy z planami od kilkudziesięciu dolarów miesięcznie. Przy dużym ruchu dochodzą opłaty za wykorzystanie zasobów.
  • Utrzymanie i rozwój. Aktualizacje, monitoring i nowe funkcje rozliczane zwykle w miesięcznym abonamencie SLA.

Dla porównania: prosty sklep na PrestaShop lub WooCommerce z dopasowanym designem to zwykle od ok. 15–30 tys. zł. Medusa nie jest tańsza na starcie. Zwraca się dopiero przy złożonych procesach, dużym obrocie lub wielu kanałach sprzedaży.

Jak wygląda wdrożenie sklepu na Medusie?

  1. Analiza procesu sprzedaży. Sprawdzamy, czy Medusa to właściwy wybór. Jeśli Twój proces dobrze obsłuży PrestaShop lub Shopify, powiemy to wprost.
  2. Architektura i specyfikacja. Moduły, integracje, model danych produktów i cen.
  3. UX/UI storefrontu. Ścieżka zakupowa, karta produktu, panel klienta B2B.
  4. Wdrożenie. Backend Medusy, frontend w Next.js, CMS i integracje.
  5. Testy, migracja danych i start. Z mapą przekierowań SEO, jeśli przenosisz istniejący sklep.
  6. Opieka i rozwój w ramach SLA.

FAQ: najczęstsze pytania o MedusaJS

Czy MedusaJS jest darmowa?

Tak, rdzeń Medusy jest open source na licencji MIT i można go używać bez opłat licencyjnych. Koszty to wdrożenie, hosting i rozwój. Płatne są też niektóre usługi dodatkowe producenta, np. hosting Medusa Cloud.

Czy Medusa nadaje się do sklepu B2B?

Tak, to jeden z jej najmocniejszych obszarów. Dzięki modułowej budowie można zaimplementować cenniki per kontrahent, konta firmowe z wieloma użytkownikami, limity kupieckie czy akceptację zamówień, bez obchodzenia ograniczeń gotowej platformy.

Czy sklep na Medusie będzie dobrze widoczny w Google?

Tak, jeśli storefront jest zbudowany poprawnie. Next.js renderuje strony po stronie serwera, więc Google widzi pełną treść, a my dodajemy dane strukturalne produktów, mapy strony i przyjazne adresy URL. O SEO decyduje frontend, a nie sam silnik sklepu.

Czy można przenieść istniejący sklep na Medusę?

Tak. Migrujemy produkty, klientów i historię zamówień, a przed startem przygotowujemy przekierowania 301, żeby nie stracić pozycji w Google. Najpierw jednak sprawdzamy, czy zmiana platformy rzeczywiście się opłaci.

Zastanawiasz się, czy Medusa to dobry wybór dla Twojego sklepu? Zobacz, jak pracujemy jako agencja e-commerce, i porównaj ją z innymi podejściami do architektury headless, np. PrestaShop headless z frontendem w Next.js.