New POS Starter

It is now possible to easily extend Medusa's reach to power sales within physical stores through a point-of-sale (POS) system. The new Medusa POS starter handles in-store sales operations like barcode scanning, checkout and cart, payments, customer profiles, inventory, and more.

The starter is built by Agilo, a Medusa Expert Partner with extensive experience in retail projects with Medusa. Using insights gained from building the first POS on Medusa for TEKLA, they decided to create this Starter. Leveraging the Medusa Admin API and the existing Sales Channel and Inventory module, you can set up multiple physical retail locations and sales channels to supplement your online channels. The POS starter keeps every product, order, and customer record in sync across all channels, ensuring data stays unified whether sales happen online or in person.

Fully open-source and extendable

The starter was designed to be lightweight, easy to deploy, and adaptable for any retail setup, from small boutiques to multi-store environments. The app includes a quick setup wizard that helps store staff select or create regions, sales channels, and stock locations before use. As an open source project under the MIT license, developers have full freedom to customize and extend it.

For a deeper look at the vision behind the project, read Agilo’s announcement post.

Production-Ready POS Features

The Medusa POS starter includes all the core functionality needed to power in-store sales from day one. Below is an overview of the main areas it covers:

In Store Experience

• Product discovery: Search or scan barcodes to find items instantly through the device camera
• Variant selection: View available options and live stock levels
• Cart management: Add, remove, or update items during checkout
• Customer profiles: Attach existing customers or create new ones
• Order creation: Generate draft orders that sync directly with Medusa Admin

Store Operations

• Authentication: Staff log in using Medusa Admin credentials
• Channel and region setup: Select the correct stock location before selling
• Setup wizard: Guided onboarding for connecting to a Medusa backend and selecting sales settings
• Order history: Review past transactions and receipts
• Device support: Works on iOS and Android through React Native and Expo

Developer Experience

• API driven: Built fully on Medusa’s Admin API
• Composable: Add payments, printers, or custom integrations as needed
• Cross-platform: One codebase for multiple devices
• Open source: Licensed under MIT for full flexibility

Agilo is already actively using the project in client projects and is continuously adding new features to it. Some upcoming features include integrated payment terminals, offline mode, and POS hardware support.

How It Fits Into the Medusa Stack

The POS starter runs on the same backend as your online store, keeping every channel connected. It enables centralized inventory management, consistent customer and order data, shared pricing and tax logic, and automation through Medusa events and webhooks. This foundation allows retailers to manage ecommerce and in-store operations from one flexible and fully open system.

Together, these capabilities enable the seamless delivery of unified commerce experiences across every channel, without requiring additional systems or infrastructure.

Get Started with the POS Starter

You can try the POS starter instantly using Expo Go. Install the Expo Go app on your phone or tablet from the App Store(iOS) or Google Play Store (Android). Clone the GitHub repository, start the app locally, and connect it to your Medusa backend to explore your live products and orders in action.

You can set up a backend in minutes and connect it to the POS starter using Medusa Cloud. Get started here.

Explore the POS Starter on GitHub or view it alongside all Medusa starters at medusajs.com/starters.