medusajs /medusa

The world's most flexible commerce platform for agents and developers

★ 37,256⑂ 5,531👁 198⑃ 12,295● 4,153▤ 176
TypeScriptNOASSERTIONCreated 2020-01-18medusajs.com
Download: v2.22.7: Translation Module Stable, Cross Module Joins, Promotion Eventsv2.22.7 ↓2.22.72026-11-13
+15
Daily
+120
Weekly
37,256
stars
5,531
forks
198
watchers
12,295
prs
4,153
issues
176
releases

README

Medusa



  Documentation |
  Website



  Building blocks for digital commerce


  
    
  
  
    
  
  
    
  
  
    
  


Medusa is an open-source commerce platform with a built-in framework for customization. Use it to build B2B or DTC stores, marketplaces, distributor platforms, PoS systems, and other applications that need commerce primitives such as products, carts, orders, and payments, without reinventing core commerce logic.

 Getting Started

The fastest way to get started is with Medusa Cloud, a managed environment for Medusa applications with automated deployments, scaling, and maintenance. Get started on Medusa Cloud.

To create a Medusa application locally, you need Node.js v22.22.0 or later and a running PostgreSQL database. Then run:

bash
npx create-medusa-app@latest my-medusa-store


This sets up the Medusa server and admin dashboard, and optionally the Next.js Starter Storefront. See the installation guide for all options, or install with Docker.

 Repository structure

This is a Yarn workspaces monorepo. Every Medusa package published to npm lives under packages.

| Path | Contents |
| --- | --- |
| packages/medusa | @medusajs/medusa: the main package installed in Medusa applications. Holds the Store and Admin API routes, CLI commands, subscribers, and jobs, and re-exports the modules and @medusajs/core-flows. |
| packages/core/ | Core libraries: the framework runtime (framework), types, utils, Workflows SDK, Modules SDK, predefined workflows (core-flows), Query, orchestration, and the JS SDK. |
| packages/modules/ | Commerce Modules (product, cart, order, pricing, payment, and more) and Infrastructure Modules (event bus, caching, file, locking, workflow engine, and more). |
| packages/modules/providers/ | Module Providers, such as Stripe payments, S3 file storage, SendGrid notifications, Redis locking and caching, and auth providers for email/password, GitHub, Google, and OIDC. |
| packages/admin/ | The Medusa Admin dashboard and the SDK, Vite plugin, and bundler used to build and extend it. |
| packages/design-system/ | Medusa UI: the React component library, icons, Tailwind preset, and a Figma import tool. |
| packages/cli/ | CLI tools: create-medusa-app, the medusa CLI, OpenAPI tooling, and the HTTP types generator. |
| packages/plugins/ | Official plugins, such as draft orders and loyalty. |
| integration-tests | HTTP and module integration test suites run against a real PostgreSQL database. |
| www | The source of the Medusa documentation website. |

 About Medusa

Medusa's commerce modules are open-source and freely available on npm. Enterprise Edition features are identified separately in the repository.

Learn more about Medusa's architecture and Commerce Modules in the documentation.

 Upgrades & Integrations

Follow the Release Notes to keep your Medusa project up-to-date.

Check out all available Medusa integrations.

 Community & Contributions

The core team is available in GitHub Discussions, where you can cr

Top issues

Discussions

Latest release

v2.22.7: Translation Module Stable, Cross Module Joins, Promotion Events v2.22.7 2026-11-13
Highlights

 Translation Module Stable

The Translation Module is out of beta is now installed in all Medusa projects by default. You can use translation features to translate content for products, categories, custom data models, and more.

Learn more in the Translation Module documentation.

---

 Cross-Module Joins Replace the Index Module

Medusa now resolves cross-module queries using direct database joins rather than the Index Module, including in the /store/products API route. The Index Module is deprecated and will be removed in a future release.

If you have explicitly re

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON