BloomSynthBloomSynth

Open source · MIT

Medusa Mobile: the React Native storefront for Medusa v2

Medusa Mobile is an open-source React Native storefront for Medusa v2: browsing, search, cart, checkout, accounts and themes are ready, so you can ship your store as an iOS and Android app.

Get startedView on GitHub

iOS and Android · Tested with Medusa 2.22.1 · MIT license

Medusa Mobile store screens: product list, product page and cart

Why Medusa Mobile

  • Complete shopping flow

    Product listing, search, cart, promo codes, guest checkout, accounts and order history, all against a real Medusa v2 backend.

  • Pinned to Medusa

    Tested with the Medusa 2.22.1 starter backend, using the official JS SDK.

  • Easy to brand

    Several themes and dark mode, built on NativeWind (Tailwind) tokens you can replace.

  • Ready for real stores

    Multiple regions, Fluent localization, strict TypeScript, CI and unit tests.

  • Plain React Native CLI

    No proprietary services and MIT licensed. You can add Expo if you prefer it.

Features

  • Product browsing with infinite scroll
  • Product search
  • Categories and collections
  • Cart management and promo codes
  • Guest checkout
  • User accounts and profile management
  • Order tracking
  • Multi-region support
  • Localization
  • Light and dark themes, and several built-in themes
  • Animations with React Native Reanimated

Built with

  • React Native
  • TypeScript
  • Medusa JS SDK
  • React Query
  • React Navigation
  • NativeWind (Tailwind CSS)
  • React Native Reanimated

Quick start

You need a running Medusa v2 backend and a React Native environment.

git clone https://github.com/bloomsynth/medusa-mobile-react-native.git medusa-mobile
cd medusa-mobile && npm ci && cp .env.template .env
npm start   # then, in another terminal: npm run android or npm run ios

Set your backend URL and publishable key in .env first. The getting started guide covers iOS pods, emulator networking and troubleshooting.

Frequently asked questions

Is Medusa Mobile free?

Yes. Medusa Mobile is open source under the MIT license, with no proprietary services, so you can use and change it for your own store.

Which Medusa version does it work with?

Medusa v2. It is tested with the Medusa 2.22.1 starter backend and uses the official Medusa JS SDK.

Does it run on iOS and Android?

Yes. It is a React Native app, so the same code builds your store app for iOS and Android.

Does it use Expo?

It uses the plain React Native CLI for flexibility. You can add Expo to the project if you prefer it.

How do I change the look to match my brand?

Medusa Mobile ships with several themes and dark mode, built on NativeWind (Tailwind CSS) tokens that you can replace with your own.