# Medusa

> Medusa is a digital commerce platform with a built-in Framework for customization. When you install Medusa, you get a fully fledged commerce platform with all the features you need to get off the ground. However, unlike other platforms, Medusa is built with customization in mind. You don't need to build hacky workarounds that are difficult to maintain and scale. Your efforts go into building features that bring your business's vision to life.

Medusa ships with three main tools:

- A suite of Commerce Modules with core commerce functionalities, such as tracking inventory, calculating cart totals, accepting payments, managing orders, and much more.
- A framework for building custom functionalities specific to your business, product, or industry. This includes tools for introducing custom API endpoints, business logic, and data models; building workflows and automations; and integrating with third-party services.
- A customizable admin dashboard for merchants to configure and operate their store.

Medusa is for businesses and teams looking for a digital commerce platform with the tools to implement unique requirements that other platforms aren't built to support.

Businesses of all sizes can use Medusa, from small start ups to large enterprises. Also, technical teams of all sizes can build with Medusa; all it takes is a developer to manage and deploy Medusa projects.

> When searching for Medusa documentation, append `index.html.md` to the end of the URL to get a plain-text version of the document.

## Get Started

- [Get Started](https://docs.medusajs.com/learn/installation/index.html.md): Install a digital commerce application with Medusa.
- [Main docs](https://docs.medusajs.com/learn/index.html.md): Chapters to learn Medusa's concepts and toolings.

## Product

### Framework

- [Framework Overview](https://docs.medusajs.com/learn/fundamentals/framework/index.html.md): Overview of Medusa's Framework and concepts in it like API routes, modules, data models, etc...
- [API Routes](https://docs.medusajs.com/learn/fundamentals/api-routes/index.html.md): Create custom API endpoints.
- [Data Models](https://docs.medusajs.com/learn/fundamentals/data-models/index.html.md): Define and manage data models.
- [Events and Subscribers](https://docs.medusajs.com/learn/fundamentals/events-and-subscribers/index.html.md): Handle events and create subscribers.
- [Index Module](https://docs.medusajs.com/learn/fundamentals/module-links/index-module/index.html.md): Use the Index Module for module links.
- [Medusa Container](https://docs.medusajs.com/learn/fundamentals/medusa-container/index.html.md): Access registered resources in Medusa.
- [Modules](https://docs.medusajs.com/learn/fundamentals/modules/index.html.md): Build reusable commerce functionalities.
- [Module Links](https://docs.medusajs.com/learn/fundamentals/module-links/index.html.md): Link data models across modules.
- [Plugins](https://docs.medusajs.com/learn/fundamentals/plugins/index.html.md): Extend Medusa with plugins.
- [Query](https://docs.medusajs.com/learn/fundamentals/module-links/query/index.html.md): Query linked data models.
- [Scheduled Jobs](https://docs.medusajs.com/learn/fundamentals/scheduled-jobs/index.html.md): Create and manage scheduled jobs.
- [Workflows](https://docs.medusajs.com/learn/fundamentals/workflows/index.html.md): Build workflows and automations.

### Modules

- [Commerce Modules](https://docs.medusajs.com/resources/commerce-modules/index.html.md): List of all Commerce Modules in Medusa and an entry point to their documentation.
- [Infrastructure Modules](https://docs.medusajs.com/resources/infrastructure-modules/index.html.md): List of all Infrastructure Modules in Medusa and an entry point to their documentation.

## Commerce Modules

### Cart & Purchase

- [Cart](https://docs.medusajs.com/resources/commerce-modules/cart/index.html.md): Add to cart, checkout, and totals.
- [Payment](https://docs.medusajs.com/resources/commerce-modules/payment/index.html.md): Process any payment type.
- [Customer](https://docs.medusajs.com/resources/commerce-modules/customer/index.html.md): Customer and group management.

### Merchandising

- [Pricing](https://docs.medusajs.com/resources/commerce-modules/pricing/index.html.md): Configurable pricing engine.
- [Promotion](https://docs.medusajs.com/resources/commerce-modules/promotion/index.html.md): Discounts and promotions.
- [Product](https://docs.medusajs.com/resources/commerce-modules/product/index.html.md): Variants, categories, and bulk edits.

### Fulfillment

- [Order](https://docs.medusajs.com/resources/commerce-modules/order/index.html.md): Omnichannel order management.
- [Inventory](https://docs.medusajs.com/resources/commerce-modules/inventory/index.html.md): Multi-warehouse and reservations.
- [Fulfillment](https://docs.medusajs.com/resources/commerce-modules/fulfillment/index.html.md): Order fulfillment and shipping.
- [Stock Location](https://docs.medusajs.com/resources/commerce-modules/stock-location/index.html.md): Locations of stock-kept items.

### Regions & Channels

- [Region](https://docs.medusajs.com/resources/commerce-modules/region/index.html.md): Cross-border commerce.
- [Sales Channel](https://docs.medusajs.com/resources/commerce-modules/sales-channel/index.html.md): Omnichannel sales.
- [Tax](https://docs.medusajs.com/resources/commerce-modules/tax/index.html.md): Granular tax control.
- [Currency](https://docs.medusajs.com/resources/commerce-modules/currency/index.html.md): Multi-currency support.

### User Access

- [API Keys](https://docs.medusajs.com/resources/commerce-modules/api-key/index.html.md): Store and admin access.
- [User Module](https://docs.medusajs.com/resources/commerce-modules/user/index.html.md): Admin user management.
- [Auth](https://docs.medusajs.com/resources/commerce-modules/auth/index.html.md): Integrate authentication methods.

## Infrastructure Modules

- [Analytics](https://docs.medusajs.com/resources/infrastructure-modules/analytics/index.html.md): Track and analyze user interactions and system events with third-party services.
- [Caching](https://docs.medusajs.com/resources/infrastructure-modules/caching/index.html.md): Cache data in your Medusa application, improving performance and reducing latency for frequently accessed data.
- [Event](https://docs.medusajs.com/resources/infrastructure-modules/event/index.html.md): Handles queueing events, emitting them, and executing their subscribers.
- [File](https://docs.medusajs.com/resources/infrastructure-modules/file/index.html.md): Store assets, such as product images, in third-party providers.
- [Locking](https://docs.medusajs.com/resources/infrastructure-modules/locking/index.html.md): Manages access to shared resources by multiple processes or threads.
- [Notification](https://docs.medusajs.com/resources/infrastructure-modules/notification/index.html.md): Send a notification to customers or users, such as order confirmation emails.
- [Workflow Engine](https://docs.medusajs.com/resources/infrastructure-modules/workflow-engine/index.html.md): Handles tracking and recording the transactions and statuses of workflows and their steps.

## Build

- [Recipes](https://docs.medusajs.com/resources/recipes/index.html.md): Build common use cases with step-by-step guides.
- [How-to & Tutorials](https://docs.medusajs.com/resources/how-to-tutorials/index.html.md): How-to guides and tutorials for building with Medusa.
- [Integrations](https://docs.medusajs.com/resources/integrations/index.html.md): Integrate third-party services with Medusa.
- [Storefront](https://docs.medusajs.com/resources/storefront-development/index.html.md): Build storefronts with Medusa.

## Tools

### CLI Tools

- [create-medusa-app](https://docs.medusajs.com/resources/create-medusa-app/index.html.md): CLI tool to create Medusa applications.
- [Medusa CLI](https://docs.medusajs.com/resources/medusa-cli/index.html.md): CLI tool for managing Medusa projects.

### Development Tools

- [JS SDK](https://docs.medusajs.com/resources/js-sdk/index.html.md): JavaScript SDK for interacting with Medusa.
- [Next.js Starter](https://docs.medusajs.com/resources/nextjs-starter/index.html.md): Next.js storefront starter template and how to install it.
- [Medusa UI](https://docs.medusajs.com/ui/index.html.md): A React library to build applications using Medusa's primitives and design system.

## References

### API References

- [Admin API Reference](https://docs.medusajs.com/api/admin): List of all Admin API routes in Medusa with code snippets.
- [Store API Reference](https://docs.medusajs.com/api/store): List of all Store API Routes in Medusa with code snippets.

### Development References

- [Admin Injection Zones](https://docs.medusajs.com/resources/admin-widget-injection-zones/index.html.md): Injection zones for customizing the admin dashboard.
- [Container Resources](https://docs.medusajs.com/resources/medusa-container-resources/index.html.md): Resources available in the Medusa Container.
- [Core Workflows](https://docs.medusajs.com/resources/medusa-workflows-reference/index.html.md): Reference for core workflows in Medusa.
- [Data Model Language](https://docs.medusajs.com/resources/references/data-model/index.html.md): Reference for the Data Model Language.
- [Data Model Repository](https://docs.medusajs.com/resources/data-model-repository-reference/index.html.md): Reference for the Data Model Repository.
- [Events Reference](https://docs.medusajs.com/resources/references/events/index.html.md): Reference for events in Medusa.
- [Helper Steps](https://docs.medusajs.com/resources/references/helper-steps/index.html.md): Reference for helper steps in workflows.
- [Service Factory](https://docs.medusajs.com/resources/service-factory-reference/index.html.md): Reference for the Service Factory.
- [Testing Framework](https://docs.medusajs.com/resources/test-tools-reference/index.html.md): Reference for testing tools in Medusa.
- [Workflows SDK](https://docs.medusajs.com/resources/references/workflows/index.html.md): Reference for the Workflows SDK.

## Medusa Admin

- [User Guide](https://docs.medusajs.com/user-guide/index.html.md): Guide for merchants and users to manage their Medusa store with the Medusa Admin.

## Cloud

- [Medusa Cloud](https://docs.medusajs.com/cloud/index.html.md): Deploy and manage Medusa projects on Medusa Cloud.