Menu

1. Introduction

Medusa is a digital commerce platform with a built-in framework for customizations and integrations.

Medusa's framework includes two types of tools:

  1. Modules that provide commerce functionalities, such as Product, Order, and Cart modules.
  2. Customization tools to build your business features, such as custom data models, business logic, flows, and endpoints.

With these tools, you save time you would spend with other platforms on maintaining and setting up your customizations. Instead, you rapidly build important features for your business.

Get started#

Node.js v20+↗Git CLI tool↗PostgreSQL↗

Create your first Medusa store by running the following command:

Terminal
❯npx create-medusa-app@rc

Who is Medusa for#

Medusa is for ambitious businesses and developers that are limited by traditional ecommerce solutions:

  • You want rich commerce features that are customizable and flexible enough to support your business use case as if you built them from scratch.
  • You want your custom requirements built as an integral part of the commerce application’s features and architecture, rather than hacked into it.
  • You want to customize your commerce flows by integrating external services without data inconsistency and irregularity.
Use Case: D2C
How Matt Sleeps built a unique D2C experience with Medusa
Use Case: OMS
How Makro Pro Built an OMS with Medusa
Use Case: Marketplace
How Foraged built a custom marketplace with Medusa
Use Case: POS
How Tekla built a global webshop and a POS system with Medusa
Use Case: B2B
How Visionary built B2B commerce with Medusa
Use Case: Platform
How Catalog built a B2B platform for SMBs with Medusa

Who is this documentation for#

This documentation is for TypeScript or JavaScript developers looking to master Medusa and build their commerce applications. By following this documentation, you’ll learn about Medusa’s concepts, from basic to advanced, with easy-to-follow examples to assist you along the way.

By the end of this documentation, you’ll be an expert Medusa developer, leading teams using Medusa from the development till production.

How to use the documentation#

The documentation for Medusa v2 is split into the following sections:

  1. The main documentation, which is the one you're currently viewing. It's highly recommended to follow all the chapters in this documentation before jumping into other documentation sections.
  2. The Development Resources documentation provides guides and resources useful during your development, such as tools, API references, recipes, step-by-step guides and examples, and more.
  3. The Store and Admin API references provide a reference to the Medusa application's endpoints and instructions related to authentication, parameter types, and more.
Was this chapter helpful?
Edit this page