Skip to content
RapidMart RapidMart

Set up your computer

RapidMart has three Flutter apps, each built for Android and iOS from one codebase:

AppFolderFor
Customerapps/customerOrdering, parcels, consultations, lab tests, wallet.
Sellerapps/sellerStores: orders, products, earnings, in-store POS.
Riderapps/deliveryRiders: jobs, navigation, cash, earnings.

packages/ holds code the apps share. Keep apps/ and packages/ side by side, as in the download — the apps find the packages by that relative path.

What you need

Section titled “What you need”
VersionWhy
Flutter3.38.10The version RapidMart is built and tested with.
Android StudioLatestAndroid SDK, emulator, signing tools.
Xcode (Mac only)LatestiOS builds. iOS apps can only be built on a Mac.
CocoaPods (Mac only)LatestiOS libraries.
Firebase CLI + FlutterFireLatestConnects the apps to your Firebase project.

  1. Install Flutter 3.38.10 — follow flutter.dev → Get started for your system. To keep this version alongside others, use FVM: fvm install 3.38.10 (the apps include a .fvmrc for it).

  2. Install Android Studio, open it once, and in SDK Manager install the latest Android SDK and command-line tools. Then accept the licences:

    Terminal window
    flutter doctor --android-licenses

  3. Mac only — Xcode and CocoaPods: install Xcode from the App Store, open it once, then:

    Terminal window
    sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
    sudo gem install cocoapods

  4. Check everything:

    Terminal window
    flutter doctor

    Fix anything marked ✗ before going on.

Run an app

Section titled “Run an app”

  1. Open a terminal in the app’s folder and fetch its libraries:

    Terminal window
    cd apps/customer
    flutter pub get

  2. Set your server’s address in lib/app_config.dart (Connect the apps to your server).

  3. Connect a phone (USB debugging on Android; trusted device on iPhone) or start an emulator or simulator, then:

    Terminal window
    flutter run

The order to follow

Section titled “The order to follow”
  1. Connect the apps to your server
  2. Rename & rebrand — name, app IDs, icons
  3. Firebase — sign-in and push
  4. Push notifications
  5. Google Maps (customer app)
  6. Build for Android and Build for iOS