medusa

What it is

Medusa is a commerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic. The framework and modules can be used to support advanced B2B or DTC commerce stores, marketplaces, distributor platforms, PoS systems, service businesses, or similar solutions that need foundational commerce primitives. All commerce modules are open-source and freely available on npm.

How it works

Medusa provides a core architecture and modules to extend commerce functionality. It references architecture and commerce modules in its docs for further details. Getting started suggests using Medusa Cloud for managed deployments or installing locally following the Documentation.

Getting started

The fastest way to get started is with Medusa Cloud. Get started on Medusa Cloud (link provided in Getting Started). To set up a Medusa application locally, visit the Documentation. The repository README includes links to cloud onboarding and docs:

• Getting Started: The fastest way to get started is with Medusa Cloud. It provides a managed environment optimized for Medusa applications, with automated deployments, scaling, and maintenance. Get started on Medusa Cloud

Recent releases

Latest releases include:

• v2.18.0 (2026-07-23): Highlights: This release comes with new features, bug fixes, and dependency updates for better security. Medusa MCP users can update their project using the following prompt:

Update my Me

• v2.17.2 (2026-07-01): Highlights: before / after on widgets injection zones; Breaking change noted for LayoutComposer components controlled via Editor view.
• v2.17.1 (2026-06-25): Highlights: Regression fix for workers in Redis Event Bus; Not awaiting bullWorker_.run() in event-bus-redis onApplicationStart
• v2.17.0 (2026-06-24): Highlights: Important regression advisory; 2.17.1 recommended over upgrade to 2.17.0 due to worker instance regression.
• v2.16.0 (2026-06-18): Highlights: Many improvements and bug fixes; recommendation to update.

Note: The README excerpt includes truncated sections and release notes showing these versions and highlights.

Traction

• Stars: 35439
• Forks: 4992
• Open issues: 73

Behind the repo

This section not present in the provided facts; omitted.

Caveats

• License: MIT (as indicated in repository stats and MIT badge in README).
• Age: Created 2020-01-18; last push 2026-07-28.
• Language: TypeScript.
• Topics include ai-coding, ai-tools, commerce, e-commerce, ecommerce, framework, javascript, medusa, nodejs, react, typescript.