Medusa

Documentation | Medusa Admin Demo | Website

An open source composable commerce engine built for developers.

Getting Started

You can install Medusa by either following our Quickstart guide or the following steps:

1. Install Medusa CLI

   npm install -g @medusajs/medusa-cli

2. Create a new Medusa project

   medusa new my-medusa-store --seed

3. Start your Medusa engine

   cd my-medusa-store
   medusa develop

Requirements

• Node v14.0 or higher.
• SQLite or PostgreSQL (SQLite is only for getting started; PostgreSQL is recommended)
• Redis

You can check out this documentation for more details about setting up your environment.

What is Medusa?

Medusa is an open source composable commerce engine built with Node.js. Medusa enables developers to build scalable and sophisticated commerce setups with low effort and great developer experience.

You can learn more about Medusa’s architecture in our documentation.

Features

• Orders, Exchanges, and Returns APIs: Aside from the standard order management that comes with ecommerce platforms, Medusa also provides an easy and automated way to manage swaps, returns, and claims.
• Products and Collections APIs: Add products with extensive customization settings and sort them into collections.
• Region API: Configure and manage multiple regions and currencies all from one platform.
• Plugin API: Easily integrate fulfillment providers, payment providers, notification services, and many other custom tools and third-party services.
• PriceList and Promotions APIs: Advanced pricing for products with conditions based on the amount in the cart or promotions and discounts.
• Tax API: Advanced tax configurations specific to multiple regions, with the capability of specifying taxes for specific products.

See more of the ecommerce features on our documentation.

Roadmap

Write-ups for all features will be made available in Github discussions before starting the implementation process.

2022

• Admin revamp
• Tax API
• Tax Calculation Strategy
• Cart Calculation Strategy
• Customer Groups API
• Promotions API
• Price Lists API
• Price Selection Strategy
• Import / Export API
• Sales Channel API
• Extended Order API (managing placed orders)
• PaymentCollection API (collecting payments separate from carts and draft orders)
• Multi-warehouse API
• Extended Product API (custom fields, publishing control, and more)

Plugins

As a headless and extendible solution, Medusa allows you to integrate third-party services or add custom features to Medusa by installing Plugins.

Check out our available plugins that you can install and use instantly on your Medusa server.

Contributions

Medusa is all about the community. Therefore, we would love for you to help us build the most robust and powerful commerce engine on the market.

Whether it is fixing bugs, improving our documentation, or simply spreading the word, please feel free to join in. Please check our contribution guide for further details about how to contribute.

Community & Support

Use these channels to be part of the community, ask for help while using Medusa, or just learn more about Medusa:

• Discord: This is the main channel to join the community. You can ask for help, showcase your work with Medusa, and stay up to date with everything Medusa.
• GitHub Issues: for sending in any issues you face or bugs you find while using Medusa.
• GitHub Discussions: for joining discussions and submitting your ideas.
• Medusa Blog: find diverse tutorials and company news.
• Twitter
• LinkedIn

Upgrade Guides

Follow our upgrade guides on the documentation to keep your Medusa project up-to-date.

License

Licensed under the MIT License