# @medusajs/medusa

> Building blocks for digital commerce

Latest version **2.21.2** (published 2026-09-28) · SEE LICENSE IN LICENSE license · 0 weekly downloads

## Install

```sh
npm install @medusajs/medusa
pnpm add @medusajs/medusa
yarn add @medusajs/medusa
bun add @medusajs/medusa
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.21.2 |
| Published | 2026-09-28 |
| First published | 2020-03-24 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| >=22.12.0 |
| Dependencies | 71 |
| Unpacked size | 3.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 36547 |
| Author | Sebastian Rindom |
| Maintainers | sebrindom, oliverjuhl, nicolas-gorga, sradevski, olijuhl, shahednasser |

## Links

- npm: https://www.npmjs.com/package/@medusajs/medusa
- Repository: https://github.com/medusajs/medusa
- Homepage: https://medusajs.com
- Issues: https://github.com/medusajs/medusa/issues
- npm.io page: https://npm.io/package/@medusajs/medusa

## Dependencies (71)

- [qs](https://npm.io/package/qs.md) ^6.15.2
- [uuid](https://npm.io/package/uuid.md) ^11.1.1
- [boxen](https://npm.io/package/boxen.md) ^5.0.1
- [chalk](https://npm.io/package/chalk.md) ^4.1.2
- [multer](https://npm.io/package/multer.md) ^2.3.0
- [express](https://npm.io/package/express.md) ^4.21.0
- [slugify](https://npm.io/package/slugify.md) ^1.6.6
- [chokidar](https://npm.io/package/chokidar.md) ^4.0.3
- [request-ip](https://npm.io/package/request-ip.md) ^3.3.0
- [compression](https://npm.io/package/compression.md) ^1.8.0
- [jsonwebtoken](https://npm.io/package/jsonwebtoken.md) ^9.0.2
- [@medusajs/tax](https://npm.io/package/@medusajs/tax.md) 2.21.2
- [node-schedule](https://npm.io/package/node-schedule.md) ^2.1.1
- [@medusajs/auth](https://npm.io/package/@medusajs/auth.md) 2.21.2
- [@medusajs/cart](https://npm.io/package/@medusajs/cart.md) 2.21.2
- [@medusajs/file](https://npm.io/package/@medusajs/file.md) 2.21.2
- [@medusajs/rbac](https://npm.io/package/@medusajs/rbac.md) 2.21.2
- [@medusajs/user](https://npm.io/package/@medusajs/user.md) 2.21.2
- [@inquirer/input](https://npm.io/package/@inquirer/input.md) ^2.2.9
- [@medusajs/index](https://npm.io/package/@medusajs/index.md) 2.21.2
- [@medusajs/order](https://npm.io/package/@medusajs/order.md) 2.21.2
- [@medusajs/store](https://npm.io/package/@medusajs/store.md) 2.21.2
- [@medusajs/region](https://npm.io/package/@medusajs/region.md) 2.21.2
- [@medusajs/search](https://npm.io/package/@medusajs/search.md) 2.21.2
- [fs-exists-cached](https://npm.io/package/fs-exists-cached.md) ^1.0.0
- [@inquirer/confirm](https://npm.io/package/@inquirer/confirm.md) ^2.0.17
- [@medusajs/api-key](https://npm.io/package/@medusajs/api-key.md) 2.21.2
- [@medusajs/caching](https://npm.io/package/@medusajs/caching.md) 2.21.2
- [@medusajs/file-s3](https://npm.io/package/@medusajs/file-s3.md) 2.21.2
- [@medusajs/locking](https://npm.io/package/@medusajs/locking.md) 2.21.2
- [@medusajs/payment](https://npm.io/package/@medusajs/payment.md) 2.21.2
- [@medusajs/pricing](https://npm.io/package/@medusajs/pricing.md) 2.21.2
- [@medusajs/product](https://npm.io/package/@medusajs/product.md) 2.21.2
- [@inquirer/checkbox](https://npm.io/package/@inquirer/checkbox.md) ^2.3.11
- [@medusajs/currency](https://npm.io/package/@medusajs/currency.md) 2.21.2
- [@medusajs/customer](https://npm.io/package/@medusajs/customer.md) 2.21.2
- [@medusajs/settings](https://npm.io/package/@medusajs/settings.md) 2.21.2
- [@medusajs/analytics](https://npm.io/package/@medusajs/analytics.md) 2.21.2
- [@medusajs/auth-oidc](https://npm.io/package/@medusajs/auth-oidc.md) 2.21.2
- [@medusajs/inventory](https://npm.io/package/@medusajs/inventory.md) 2.21.2
- [@medusajs/promotion](https://npm.io/package/@medusajs/promotion.md) 2.21.2
- [@medusajs/telemetry](https://npm.io/package/@medusajs/telemetry.md) 2.21.2
- [@medusajs/core-flows](https://npm.io/package/@medusajs/core-flows.md) 2.21.2
- [@medusajs/file-local](https://npm.io/package/@medusajs/file-local.md) 2.21.2
- [@medusajs/auth-github](https://npm.io/package/@medusajs/auth-github.md) 2.21.2
- [@medusajs/auth-google](https://npm.io/package/@medusajs/auth-google.md) 2.21.2
- [@medusajs/cache-redis](https://npm.io/package/@medusajs/cache-redis.md) 2.21.2
- [@medusajs/draft-order](https://npm.io/package/@medusajs/draft-order.md) 2.21.2
- [@medusajs/fulfillment](https://npm.io/package/@medusajs/fulfillment.md) 2.21.2
- [@medusajs/translation](https://npm.io/package/@medusajs/translation.md) 2.21.2
- [@medusajs/link-modules](https://npm.io/package/@medusajs/link-modules.md) 2.21.2
- [@medusajs/notification](https://npm.io/package/@medusajs/notification.md) 2.21.2
- [@medusajs/admin-bundler](https://npm.io/package/@medusajs/admin-bundler.md) 2.21.2
- [@medusajs/caching-redis](https://npm.io/package/@medusajs/caching-redis.md) 2.21.2
- [@medusajs/locking-redis](https://npm.io/package/@medusajs/locking-redis.md) 2.21.2
- [@medusajs/sales-channel](https://npm.io/package/@medusajs/sales-channel.md) 2.21.2
- [@medusajs/auth-emailpass](https://npm.io/package/@medusajs/auth-emailpass.md) 2.21.2
- [@medusajs/cache-inmemory](https://npm.io/package/@medusajs/cache-inmemory.md) 2.21.2
- [@medusajs/payment-stripe](https://npm.io/package/@medusajs/payment-stripe.md) 2.21.2
- [@medusajs/stock-location](https://npm.io/package/@medusajs/stock-location.md) 2.21.2
- [@medusajs/analytics-local](https://npm.io/package/@medusajs/analytics-local.md) 2.21.2
- [@medusajs/event-bus-local](https://npm.io/package/@medusajs/event-bus-local.md) 2.21.2
- [@medusajs/event-bus-redis](https://npm.io/package/@medusajs/event-bus-redis.md) 2.21.2
- [@medusajs/search-postgres](https://npm.io/package/@medusajs/search-postgres.md) 2.21.2
- [@medusajs/locking-postgres](https://npm.io/package/@medusajs/locking-postgres.md) 2.21.2
- [@medusajs/analytics-posthog](https://npm.io/package/@medusajs/analytics-posthog.md) 2.21.2
- [@medusajs/fulfillment-manual](https://npm.io/package/@medusajs/fulfillment-manual.md) 2.21.2
- [@medusajs/notification-local](https://npm.io/package/@medusajs/notification-local.md) 2.21.2
- [@medusajs/notification-sendgrid](https://npm.io/package/@medusajs/notification-sendgrid.md) 2.21.2
- [@medusajs/workflow-engine-redis](https://npm.io/package/@medusajs/workflow-engine-redis.md) 2.21.2
- [@medusajs/workflow-engine-inmemory](https://npm.io/package/@medusajs/workflow-engine-inmemory.md) 2.21.2

## Recent versions

- 2.21.2 (latest) — 2026-09-28
- 2.22.0-snapshot-20261008225942 (snapshot) — 2026-10-08
- 2.22.0-preview-20261002101246 (preview) — 2026-10-02
- 2.16.0-options-preview-20260605124754 (options-preview) — 2026-06-05
- 2.0.0-rc-20241022183311 (rc) — 2024-10-22
- 1.20.6-next-20240505114610 (next) — 2024-05-05
- 1.13.1-canary-20230806135701 (canary) — 2023-08-06
- 1.10.1-nextjs-commerce-20230515081748 (nextjs-commerce) — 2023-05-15
- 2.22.0-snapshot-20261008220405 — 2026-10-08
- 2.22.0-snapshot-20261008144129 — 2026-10-08
- 2.22.0-snapshot-20261006025321 — 2026-10-06
- 2.22.0-preview-20261002093930 — 2026-10-02
- 2.21.2-snapshot-20260928075521 — 2026-09-28
- 2.21.2-snapshot-20260925150426 — 2026-09-25
- 2.21.2-preview-20260925133948 — 2026-09-25
- … 1186 more at https://npm.io/package/@medusajs/medusa/versions

## README

<p align="center">
  <a href="https://www.medusajs.com">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/59018053/229103275-b5e482bb-4601-46e6-8142-244f531cebdb.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/59018053/229103726-e5b529a3-9b3f-4970-8a1f-c6af37f087bf.svg">
    <img alt="Medusa logo" src="https://user-images.githubusercontent.com/59018053/229103726-e5b529a3-9b3f-4970-8a1f-c6af37f087bf.svg">
    </picture>
  </a>
</p>
<h1 align="center">
  Medusa
</h1>

<h4 align="center">
  <a href="https://docs.medusajs.com">Documentation</a> |
  <a href="https://www.medusajs.com">Website</a>
</h4>

<p align="center">
  Building blocks for digital commerce
</p>
<p align="center">
  <a href="https://github.com/medusajs/medusa/blob/develop/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Medusa is released under the MIT license." />
  </a>
  <a href="https://circleci.com/gh/medusajs/medusa">
    <img src="https://circleci.com/gh/medusajs/medusa.svg?style=shield" alt="Current CircleCI build status." />
  </a>
  <a href="https://github.com/medusajs/medusa/blob/develop/CONTRIBUTING.md">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat" alt="PRs welcome!" />
  </a>
    <a href="https://www.producthunt.com/posts/medusa"><img src="https://img.shields.io/badge/Product%20Hunt-%231%20Product%20of%20the%20Day-%23DA552E" alt="Product Hunt"></a>
  <a href="https://discord.gg/xpCwq3Kfn8">
    <img src="https://img.shields.io/badge/chat-on%20discord-7289DA.svg" alt="Discord Chat" />
  </a>
  <a href="https://twitter.com/intent/follow?screen_name=medusajs">
    <img src="https://img.shields.io/twitter/follow/medusajs.svg?label=Follow%20@medusajs" alt="Follow @medusajs" />
  </a>
</p>

## Getting Started

Visit the [Quickstart Guide](https://docs.medusajs.com/learn) to set up a server.

## What is Medusa

Medusa is a set of commerce modules and tools that allow you to build rich, reliable, and performant commerce applications without reinventing core commerce logic. The modules can be customized and used to build advanced ecommerce stores, marketplaces, or any product that needs foundational commerce primitives. All modules are open-source and freely available on npm.

Learn more about [Medusa’s architecture](https://docs.medusajs.com/learn/advanced-development/architecture/overview) and [commerce modules](https://docs.medusajs.com/resources/commerce-modules) in the Docs.

## Roadmap & Upgrades

You can view the planned, started and completed features in the [Roadmap discussion](https://github.com/medusajs/medusa/discussions/categories/roadmap).

Follow the [Upgrade Guides](https://docs.medusajs.com/learn/update) to keep your Medusa project up-to-date.

## Community & Contributions

The community and core team are available in [GitHub Discussions](https://github.com/medusajs/medusa/discussions), where you can ask for support, discuss roadmap, and share ideas.

Our [Contribution Guide](https://github.com/medusajs/medusa/blob/develop/CONTRIBUTING.md) describes how to contribute to the codebase and Docs.

Join our [Discord server](https://discord.com/invite/medusajs) to meet other community members.

## Other channels

- [GitHub Issues](https://github.com/medusajs/medusa/issues)
- [Twitter](https://twitter.com/medusajs)
- [LinkedIn](https://www.linkedin.com/company/medusajs)
- [Medusa Blog](https://medusajs.com/blog/)

## License

Licensed under the [MIT License](https://github.com/medusajs/medusa/blob/develop/LICENSE).

---
_Source: https://npm.io/package/@medusajs/medusa · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._