/Medusa-Admin-Flutter

MedusaJs Store Manager for iOS and Android

Primary LanguageDartMIT LicenseMIT

Medusa Admin Mobile

Manage your MedusaJs ecommerce store from your mobile phone.

Getting Started

Medusa Admin Mobile is built with Flutter with the aim to ease managing ecommerce store that are built using MedusaJs, it's available for iOS and Android, it's still in beta so expect to see some bugs/unimplemented features.

Screenshots

Installation

Android

Download the latest apk file from releases and install it on your phone.

iOS

You need to sideload the latest ipa file found in releases to your iPhone, checkout Sideloadly or AltStore for more info about sideloading.

How to connect the app to your MedusaJs backend

  • Open the app and click on set URL, then enter your MedusaJs backend URL (e.g. https://your-backend-url.com) and click on save
  • Enter your email and password and click on sign in

Build it yourself

Add Flutter to your machine

Open this project folder with Terminal/CMD and run the following command

flutter packages get

then

flutter pub run build_runner build

Optional: change the baseUrl (found in "lib/core/constant/strings.dart") to your backend URL, you can change baseUrl from inside the app

This project uses firebase analytics, so you need to connect your firebase to this project, check Firebase documentation & Firebase Crashlytics for more info

  • To run the app on Android just run the following command in the root directory of the project:
flutter run
  • or to build apk
flutter build apk
  • To run the app on iOS just run the following command in the root directory of the project: (macOS only)
flutter run
  • or to build ipa
flutter build ipa

Features

  • View and update store settings ( Regions, Return reasons, sales channels etc)
  • View and add new products
  • View, add and update collection groups
  • View, add and update customers and customer groups
  • View, add and update discounts
  • View and add/update pricing list
  • View and add/update gift cards
  • Update order items
  • Add and update draft order
  • App settings
  • Support for light/dark mode

Not implemented yet

  • Metadata add/update/read
  • Creating a new region has some errors
  • Import orders
  • Duplicating product
  • Denomination in gift card

Contributing

We welcome contributions from the community to make Medusa Admin even better. If you want to contribute, please follow these steps:

  1. Fork the repository on GitHub.
  2. Create a new branch and make your changes.
  3. Submit a pull request, explaining the purpose of your changes.

License

All the code available under the MIT license. See LICENSE.