Vytvořeno: 20.5.2026 | Aktualizováno: 20.05.2026 08:09
MedusaJS / Medusa je open-source headless commerce platforma a framework pro stavbu vlastních e-shopů, marketplace, B2B portálů nebo jiných commerce aplikací. Není to hotové klikací řešení typu Shoptet, ale vývojářský backend s adminem, API, commerce moduly a možností hlubokých úprav.
Medusa je podle licence v repozitáři vydaná pod MIT licencí. To znamená, že ji lze používat i komerčně, upravovat, self-hostovat a stavět na ní vlastní produkt. Základní povinnost je zachovat licenční a copyright oznámení u distribuovaných částí softwaru.
Pricing Medusy se netýká licence k open-source kódu, ale hlavně služby Medusa Cloud. Podle pricing stránky nejde o poplatek z obratu – Medusa uvádí 0 % GMV fee, unlimited orders, products, sales channels a regions/currencies. Platí se za infrastrukturu a provozní služby.
Medusa Cloud podle dokumentace ke Cloudu řeší hlavně:
Prakticky to znamená: open-source Medusu lze provozovat zdarma na vlastní infrastruktuře, ale Medusa Cloud dává smysl ve chvíli, kdy je důležitější rychlý a stabilní provoz než správa vlastní infrastruktury.
Medusa se hodí pro projekty, které potřebují vlastní commerce logiku a nestačí jim běžná krabicová e-shopová platforma.
Typické příklady:
Naopak pro jednoduchý e-shop bez výrazné custom logiky může být Medusa zbytečně vývojově náročná. V takovém případě může být praktičtější hotová platforma, kde se většina funkcí nakliká.
Podle architektonického přehledu je Medusa headless commerce platforma. Storefront, admin dashboard nebo jiný klient komunikuje s backendem přes API.
Základní vrstvy aplikace:
Zjednodušeně:
Storefront / Admin / vlastní klient
↓
API routes
↓
Workflows
↓
Commerce modules / custom modules
↓
PostgreSQL + externí služby
Podle instalační dokumentace se lokální projekt vytvoří příkazem:
npx create-medusa-app@latest my-medusa-store
Volitelně lze rovnou přidat Next.js Starter Storefront:
npx create-medusa-app@latest --with-nextjs-starter
Po instalaci je k dispozici Medusa backend a admin dashboard. Backend běží typicky na http://localhost:9000, admin na http://localhost:9000/app a Next.js storefront na http://localhost:8000.
V základu Medusa poskytuje commerce moduly popsané v přehledu Commerce Modules. Patří sem například:
Medusa má vlastní produktový model přes Product Module. Podle dokumentace Product Module produkt podporuje varianty, options, organizaci přes kategorie/kolekce/tagy a cenové strategie.
Pro vlastní produktová data jsou typické dvě možnosti.
První možnost je použít produktový model Medusy a doplnit vlastní data přes metadata nebo vlastní modul.
Příklad pro technický e-shop:
Product: Baterie Pylontech US5000 Varianty: - standardní sada - sada s držákem Vlastní data: - kompatibilní měniče - kapacita - datasheet URL - záruční doba - doporučené použití
Medusa v takovém případě řeší commerce část: produkt, variantu, cenu, sklad, košík, objednávku a zákazníka. Vlastní modul řeší doménová data navíc.
Druhá možnost je mít hlavní produktová data v ERP/PIM/CMS a Medusu používat jako commerce vrstvu. Vlastní workflow pak může produkty synchronizovat do Medusy nebo číst doplňková data z externího systému.
Workflows jsou jedna z hlavních výhod Medusy. Workflow je série kroků, které dohromady provedou obchodní operaci. Na rozdíl od obyčejné funkce může workflow sledovat průběh kroků, definovat rollback logiku a lépe držet konzistenci při operacích přes více systémů.
Příklad použití:
Objednávka zaplacena
↓
vytvořit přístup zákazníkovi
↓
poslat e-mail
↓
synchronizovat data do CRM
Pokud některý krok selže, workflow může mít kompenzační logiku pro vrácení předchozích kroků.
Medusa se dá použít i pro prodej kurzů, ale je potřeba oddělit commerce část od LMS části.
Medusa může řešit:
Sama o sobě ale není plnohodnotný LMS. Standardně neřeší lekce, sledování progresu, kvízy, certifikáty, studentskou sekci nebo ochranu videí. To je potřeba doplnit vlastním modulem, CMS/LMS integrací nebo vlastní aplikací nad Medusa API.
Možná struktura pro kurz:
Medusa Product: title: Kurz Home Assistant pro začátečníky Varianty: - Online kurz - Online kurz + konzultace - Firemní licence pro 5 lidí Custom Course Module: Course Lesson CourseAccess LessonProgress
Typický tok:
1. Zákazník koupí kurz. 2. Medusa vytvoří objednávku. 3. Platba se potvrdí. 4. Subscriber nebo workflow vytvoří CourseAccess. 5. Zákazník po přihlášení vidí kurz ve studentské sekci.
Pro jednoduchý digitální produkt existuje v dokumentaci i Digital Products Recipe. Ten ukazuje obecný princip: vlastní modul pro digitální produkt, propojení s produktovou variantou, uložení souborů přes File Module, admin rozhraní a doručení zákazníkovi po nákupu.
Kurz se dá tímto způsobem pojmout jako digitální produkt nebo jako produkt napojený na vlastní kurzový modul.
Self-hosting dává smysl hlavně ve fázi prototypu nebo pokud je k dispozici člověk, který zvládne provoz Node.js aplikace, PostgreSQL, Redis, storage, zálohy, deployment a monitoring.
Medusa Cloud dává větší smysl, pokud:
Pro první produkční projekt v Meduse vypadá jako rozumný minimální tarif spíš Launch než Develop, protože obsahuje custom storefront domains, automatické backupy, autoscaling a zero-downtime deployment. Develop je vhodnější pro vývoj a ověření technologie.
Než se Medusa použije jako základ reálného e-shopu, je vhodné udělat malý proof of concept:
Course nebo TechnicalSpec.Pro kurzový projekt by minimální MVP mohlo vypadat takto:
Medusa: - katalog kurzů - checkout - platby - objednávky Custom část: - Course - Lesson - CourseAccess - jednoduchá studentská sekce Externí služby: - Stripe nebo jiný payment provider - video hosting - e-mailový provider
MedusaJS je vhodná volba, pokud má být e-shop spíš vlastní commerce platforma než jednoduchý naklikaný obchod. Open-source MIT licence umožňuje self-hosting i komerční použití bez licenčního poplatku z obratu. Placený Medusa Cloud řeší hlavně infrastrukturu, deploye, zálohy, scaling a provozní pohodlí.
Pro e-shop na kurzy je Medusa použitelná jako commerce backend. Prodej, platby, objednávky a zákazníky zvládne dobře, ale kurzovou část typu lekce, progres a studentská sekce je potřeba doplnit vlastním modulem nebo napojit na LMS/CMS.