Medusa

Medusa

Documentation | Medusa Admin Demo | Website

An open source composable commerce engine built for developers.

Medusa is released under the MIT license. Current CircleCI build status. PRs welcome! Product Hunt Discord Chat Follow @medusajs

## Getting Started You can install Medusa by either following our [Quickstart guide](https://docs.medusajs.com/quickstart/quick-start) or the following steps: 1. **Install Medusa CLI** ```bash npm install -g @medusajs/medusa-cli ``` 2. **Create a new Medusa project** ```bash medusa new my-medusa-store --seed ``` 3. **Start your Medusa engine** ```bash 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](https://docs.medusajs.com/tutorial/set-up-your-development-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](https://docs.medusajs.com/introduction). ### 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](https://docs.medusajs.com/#features). ## Roadmap Write-ups for all features will be made available in [Github discussions](https://github.com/medusajs/medusa/discussions) before starting the implementation process. ### **2022** - [x] Admin revamp - [x] Tax API - [x] Tax Calculation Strategy - [x] Cart Calculation Strategy - [x] Customer Groups API - [x] Promotions API - [x] Price Lists API - [x] Price Selection Strategy - [ ] Import / Export API - [ ] Sales Channel API - [ ] Extended Product API (custom fields, publishing control, and more) - [ ] Extended Order API (managing placed orders, improved inventory control, and more) - [ ] Multi-warehouse support - [ ] GraphQL API ## 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](https://github.com/medusajs/medusa/tree/master/packages) 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](https://github.com/medusajs/medusa/blob/master/CONTRIBUTING.md) 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](https://discord.gg/medusajs): 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](https://github.com/medusajs/medusa/issues): for sending in any issues you face or bugs you find while using Medusa. - [GitHub Discussions](https://github.com/medusajs/medusa/discussions): for joining discussions and submitting your ideas. - [Medusa Blog](https://medusajs.com/blog/): find diverse tutorials and company news. - [Twitter](https://twitter.com/medusajs) - [LinkedIn](https://www.linkedin.com/company/medusajs) ## Upgrade Guides Follow our [upgrade guides](https://docs.medusajs.com/advanced/backend/upgrade-guides/) on the documentation to keep your Medusa project up-to-date. ## License Licensed under the [MIT License](https://github.com/medusajs/medusa/blob/master/LICENSE)