A lightweight, open-source Point-of-Sale (POS) mobile application for Medusa v2. Built with Expo and React Native, it connects directly to your Medusa Admin REST API for seamless in-store sales.

1. Install the Expo Go app on your phone or tablet from the App Store (iOS) or Google Play Store.

2. Scan the QR code below using your device's camera app. This will open the Medusa POS app in Expo Go.

Note: To fully experience the app, you'll need a live Medusa instance. If you don't have one, you can set up a new one using Medusa Cloud.

Medusa POS brings retail operations to your mobile device without backend changes. Store clerks can scan products, manage carts, attach customers, and complete orders. All of this is powered by your existing Medusa setup.

Perfect for fast-paced retail environments, this starter helps you extend headless commerce into physical stores with minimal setup.

• Secure Authentication: Log in with Medusa admin credentials.
• Setup Wizard: Configure regions, sales channels, and stock locations on first launch.
• Product Discovery: Search products by name or scan barcodes using device camera.
• Cart Management: Create draft orders, add items, apply discounts, and attach customers.
• Checkout Flow: Complete orders directly from the app.
• Order History: View past orders with filtering and details.
• Settings: Change sales channel, region, and stock location; log out from the app.
• Responsive Design: Optimized for tablets and smartphones running iOS 15+ or Android 11+.

• Node.js 18+
• npm
• A Medusa v2 backend with Admin REST API accessible via HTTPS
• At least one Admin user account
• Device with rear-facing camera for barcode scanning

1. Clone the repository:

   git clone https://github.com/Agilo/medusa-pos-starter.git
   cd medusa-pos-starter

2. Install dependencies:

   npm install

3. Start the development server:

   npm start

For detailed setup, see the Expo documentation.

We welcome contributions from the community to help improve Medusa POS! Whether you're fixing bugs, adding features, or improving documentation, your input is valuable.

1. Fork the repository and create a feature branch from master.
2. Open an issue (GitHub Issues) first to discuss your idea or report a bug.
3. Submit a pull request (Pull Requests) with a clear description of changes.
4. Ensure your code follows our style guidelines and includes tests where applicable.

• We only merge PRs that benefit the general use of the POS. Specific customizations for individual needs will not be merged to maintain codebase integrity.
• Follow the existing code style and conventions.
• Write clear, concise commit messages.
• Test your changes thoroughly.

Absolutely! Medusa POS is designed to work with any standard Medusa v2 store without backend modifications. Just connect via the Admin API.

Medusa POS requires Medusa v2. It integrates directly with the Medusa Admin REST API, so ensure your backend is running Medusa v2 or later.

For security reasons, Medusa POS requires a secure HTTPS connection to your Medusa backend. HTTP connections are not supported to ensure data protection and compliance with modern security standards.

Medusa POS currently focuses on order management without integrated payment processing in the MVP. We're developing a payment screen that will support cash payments using Medusa's manual payment plugin. Additionally, we're working on plugins and integrations with Stripe and Adyen payment terminals for seamless POS transactions.

Full offline mode is not supported in the current version. The app requires a network connection to create new orders or sync data. However, we cache Medusa responses locally, allowing you to browse previously loaded products and orders even without an internet connection.

We'll soon publish Medusa POS to the App Store and Google Play Store for easy access. If you have special distribution needs or require a customized app, Agilo offers professional services to help. We've already deployed several POS apps in production. Reach out to us for tailored solutions.

Yes, you're free to fork the repository and make your own customizations. Additionally, Agilo provides professional customization services for Medusa POS, including UI/UX adjustments, integrations with hardware (like barcode scanners or printers), and connections to other systems (ERPs, inventory management, etc.). For specific customizations, contact us at Agilo to discuss your needs.

We welcome contributions that benefit the general use of Medusa POS, such as bug fixes, performance improvements, or new features applicable to most users. Pull requests for specific customizations or client-specific changes will not be merged to keep the core codebase maintainable.

Open an issue on our GitHub repository with details about the bug or feature request. For urgent matters, contact us directly.

Yes! Check our Contributing section above for guidelines. We appreciate code contributions, documentation improvements, and community feedback.

Licensed under the MIT License.

Built with ❤️ by Agilo for the Medusa community.