Medusa Commerce Platform

Medusa is a commerce platform featuring a built-in framework for customization. It allows developers to build custom commerce applications (such as B2B/DTC stores, marketplaces, distributor platforms, PoS systems, or service businesses) without reinventing core commerce logic.

Key aspects:

• Core Modules: The core commerce modules are open-source and available via npm.
• Architecture: Medusa is built around modular commerce primitives. For deep dives, refer to the Architecture Overview and Commerce Modules documentation.
• Licensing: Medusa uses an open-core model. The core is under the MIT License, while specific Enterprise Edition features (such as RBAC-based materials) require a commercial agreement.

The Customer Module is a core Medusa module designed to manage entities capable of making purchases within a store. It provides the foundational logic for handling customer identities and organization.

Key capabilities include:

• Contact Detail Management: Storing and managing customer contact information.
• Customer Grouping: Organizing customers into logical groups for segmentation and targeted operations.

The Draft Order plugin allows admin users to create and manage orders on behalf of customers, which is ideal for customer support or offline sales.

Key capabilities include:

• Creating draft orders via the Medusa Admin dashboard.
• Managing items within a draft order (adding, updating, or removing items).
• Adding shipping methods to the draft order.
• Associating customers with specific draft orders.
• Converting draft orders into regular orders to complete the purchase process.

The Auth Module is a standalone Commerce Module in Medusa that provides out-of-the-box authentication capabilities. Key features include:

• Basic User Authentication: Email and password credentials.
• Third-Party and Social Authentication: Integration with services like Google and GitHub.
• Custom Actor Types: Ability to create and authenticate custom user types (e.g., managers) and guard routes based on them.
• Email Verification: Requirement for new registrations.
• Multi-Factor Authentication (MFA): Support for TOTP, backup recovery codes, and configurable disable policies.
• Custom Authentication Providers: Interface to integrate your own third-party services.

@medusajs/toolbox is a collection of CLI commands designed to generate Medusa UI design tokens and components.

Note: This package is intended for internal use within the Medusa monorepo and is not designed for use in external projects.

Medusa Admin provides tools to manage three core loyalty components that allow you to offer flexible payment options and enhance customer experience:

• Gift Cards: Unique codes issued directly to customers. Each card holds a balance that can be applied at checkout.
• Gift Card Products: Storefront products that, when purchased, automatically generate a gift card for the customer.
• Store Credits: Balance accounts linked to specific customer profiles. You can manually credit these accounts, and customers can apply the balance during checkout.

The Settings Module in Medusa is designed to manage user preferences and system-wide configurations. It allows for the persistence of UI-related settings and arbitrary user data.

Key capabilities include:

• View Configurations: Managing table view settings such as column visibility, column order, and column widths.
• User Preferences: Storing arbitrary key-value pairs representing specific user preferences.
• System Defaults: Enabling admin users to define default configurations that apply to all users across the system.

Medusa is an AI-native commerce platform designed with a Framework to build custom commerce features. It consists of three primary components:

1. Commerce Modules: A suite of core functionalities including inventory tracking, cart total calculations, payment acceptance, and order management.
2. Framework: A system for building agentic flows and custom business logic. This allows you to introduce custom API endpoints, data models, workflows, automations, and third-party integrations.
3. Admin Dashboard: A customizable dashboard for merchants to manage and operate their stores.

Medusa is built for high customization, providing native support for AI agents to automate operations and customer interactions without the need for maintainability-limiting workarounds.

This tutorial provides a guide for creating an automated product feed in Medusa. This feed can be used to sync your product catalog with social media and advertising platforms like Meta (Instagram/Facebook) and Google.

Learning Objectives

• Set up a Medusa application with a Next.js storefront.
• Create a Medusa Workflow to build a product feed XML.
• Expose an API route to serve the generated XML feed.
• Integrate the API route with Meta and Google platforms.

Resources

• Full Code Example: GitHub Repository
• OpenAPI Specification: Download YAML for Postman

Medusa supports integration with Sentry to provide real-time tracking of errors and performance monitoring. This integration allows you to trace several key components of your application:

• HTTP requests
• Workflows
• Query usages
• Database operations

By setting up Sentry instrumentation, you can monitor how your customizations perform and identify errors within your workflows and database interactions effectively.