medusajs /medusa
The world's most flexible commerce platform for agents and developers
★ 37,256⑂ 5,531👁 198⑃ 12,295● 4,153▤ 176
下载:v2.22.7: Translation Module Stable, Cross Module Joins, Promotion Eventsv2.22.7 ↓2.22.72026-11-13
+15
日增长
+120
周增长
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 crTop issues
#8548Deleting an image does not trigger the delete method of AbstractFileProviderService79 comments · 2024-08-11#14106[Bug]: Draft Orders | It is not possible to add an variant if it is not available in stock.27 comments · 2025-11-22#17069[Bug]: Promotion edit form silently swallows server errors (no toast, no message)14 comments · 2026-09-29#16569[Bug]: Concurrent createReservationItems calls can oversubscribe stock and desynchronize reserved_quantity13 comments · 2026-08-23#16487[Bug]: `medusa plugin:build` does not resolve TypeScript path aliases in admin extensions13 comments · 2026-08-19#16474[Bug]: Caching module invalidation is unbounded and runs on `worker_mode: server` processes, OOMing the API container under bulk writes12 comments · 2026-08-17#15994[Bug]: Price list `min_quantity` tiered price not applied to cart line item when an override base price exists11 comments · 2026-07-10#16535[Bug]: custom path aliases breaks plugin dev hot reload10 comments · 2026-08-21
Discussions
#17845Open-source verification stack for AI-assisted full-stack TypeScript & e-commerce apps (92-rule security scanner, headless Playwright QA & 72-rule UI linter)0 comments · 2026-11-14#17808Feature: First-party cache-revalidation subscriber/recipe for Next.js storefronts + guaranteed event surface0 comments · 2026-11-13#17807Feature: Guard against published products being silently invisible on the storefront (opt-in default-channel auto-link / dashboard validation)0 comments · 2026-11-13#17806Feature: Translation module — support array (text[]) and jsonb fields with .translatable()2 comments · 2026-11-13#17805Feature: Handle inventory reservations in deleteProductsWorkflow — admin product deletion dead-ends when reservations exist0 comments · 2026-11-13#17796Store API: how should Add Line Item be retried safely after a lost response?1 comments · 2026-11-12#17783Expose the HTTP server to module loaders (ContainerRegistrationKeys.HTTP_SERVER)1 comments · 2026-11-12#17781Index notification by channel and recipient for feed queries0 comments · 2026-11-11
Latest release
v2.22.7: Translation Module Stable, Cross Module Joins, Promotion Events v2.22.7 2026-11-13Highlights 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