📱 Mobile Medusa

React Native Medusa.js Starter Template

Combine Medusa's modules for your commerce backend with the latest Expo features for a mobile storefront that matches Medusa Next.js starter functionality, look and feel.

Important

This is an alpha version not ready for production yet. It's missing mainly the production payment provider configuration that will be available on the beta version. To stay up to date follow Bidah on X / Twitter for latests updates.

Prerequisites

To use the starter you should have:

Medusa server running locally on port 9000.

Core libraries documentation

Check out Medusa Docs for more details and troubleshooting about Medusa.
Check out Expo docs for more details and troubleshooting Expo.

Overview

The Mobile Medusa starter is built with:

Features include:

Full ecommerce support that has parity of screens with Medusa Next.js Starter:
- Product Detail
- Product Overview
- Login
- Register
- Product Collections
- Cart
- User Account
  - Profile
  - Addresses
  - Orders
- Order Details
- Order Confirmation
All logic and user flows through the app are working with the Medusa Backend

Quickstart

Medusa Backend configuration

Note

You need to have a Medusa Backend to be linked to mobile storefront

Set your MEDUSA_BACKEND_URL var present in /lib/config.ts

let MEDUSA_BACKEND_URL = 'http://localhost:9000'

Install dependencies

Use Yarn to install all dependencies.

yarn

Start developing

You are now ready to start up your project.

yarn start

Builds with Expo EAS builds

EAS Build allows you to build a ready-to-submit binary of your app for the Google Play Store or Apple App Store.

https://docs.expo.dev/build/setup/

Universal Medusa

If you want to kickstart a Medusa project with web (Next.js) and mobile (Expo) in a integrated setup for cross platform development come visit us at Universal Medusa Docs