Ridy Documentation

Appearance

Deploying to Google Play Store ​

This guide covers how to deploy any Ridy app — Rider, Driver, Admin, or Fleet — to the Google Play Store. All apps share the same Flutter-based build structure and configuration.

⚙️ Prerequisites ​

Before you begin:

  • You must have a Google Play Console account
  • Each app must be connected to your shared Firebase project
  • Ensure all environment variables and icons are customized

🔧 1. Customize Your App ​

Each app needs its own:

  • App name: Set in both .env files and AndroidManifest.xml
  • Package name (applicationId): Change in android/app/build.gradle
  • App icon and splash screen: Use CLI tools below

Icons & Splash ​

We use:

Customize them via their configuration in pubspec.yaml, then run:

bash
flutter pub run flutter_launcher_icons
flutter pub run flutter_native_splash:create

📁 2. Setup Environments ​

Your Flutter app uses two environment modes:

  • .env.dev for development
  • .env.prod for production

Generate the environment files (.env.dev and .env.prod) from the provided .env.example template. These files will be automatically selected based on the build mode (--release).

🔐 3. Generate Keystore ​

Create a keystore for signing your app:

bash
keytool -genkey -v -keystore your-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias your-key

Place the generated .jks file in a safe location.

Then, create a key.properties file in the android directory with the following content:

properties
storePassword=your-store-password
keyPassword=your-key-password
keyAlias=your-key
storeFile=../your-key.jks

🏗 4. Build the AppBundle (AAB) ​

Google Play requires .aab bundles. To build your app:

bash
flutter build appbundle --release

This will generate an .aab file in the /build/app/outputs/bundle/release directory.

🚀 5. Upload to Play Store ​

  • Login to your Google Play Console
  • Create a new app (choose correct name, category, and language)
  • Upload the generated .aab bundle
  • Fill in store listing, content rating, privacy policy, and pricing

⚠️ Driver App Note: It includes background services. You must provide a short video and explanation for background usage during submission.

👥 User Access & Credentials ​

To complete setup, the app must be testable by the Play Store reviewers. Create a test account in your app and provide:

  • Email or phone number
  • Password

💼 Need Help? ​

  • Our Pro Plan includes one-time installation and build support
  • Our Pro Plus Plan includes long-term maintenance and support through updates

🍏 iOS Deployment ​

➡️ See: Deploying to App Store (iOS)