Fastlane Android<\/a><\/strong> release.\u00a0In this article, we will learn how to create a Flutter CI\/CD pipeline from scratch using Fastlane (for both Android and iOS platforms<\/a><\/strong>) and GitHub Actions (our automation tool), along with TestFlight app uploading and Play Store deployments as well as secret management for secure and sustainable automation practices. Set up CI\/CD for Flutter using\u00a0fastlane.<\/p>\n\n\n\n Manual Flutter deployments usually involve: <\/strong><\/p>\n\n\n\n Such processes can result in 30\u201360 minutes per release<\/strong>. <\/p>\n\n\n\n This means a proper Flutter CI\/CD pipeline automates everything: <\/strong><\/p>\n\n\n\n One of the most popular tools for mobile deployment automation<\/a><\/strong>,\u00a0Fastlane<\/strong>\u00a0runs effortlessly with Flutter, Android, and iOS.<\/p>\n\n\n\n Fastlane is an open-source tool that enables the deployment of iOS and Android apps. This automates some of the repetitive tasks that you do every time, such as uploading builds to TestFlight, publishing apps to Google Play, and releasing them. <\/p>\n\n\n\n Fastlane integrates with: <\/strong><\/p>\n\n\n\n Prerequisites <\/strong><\/p>\n\n\n\n Tools required: Before going to set up Fastlane automation of Flutter<\/strong>, first make sure your machine has the correct tools installed. <\/p>\n\n\n\n Install Fastlane<\/strong> <\/p>\n\n\n\n You can install Fastlane using RubyGems or Homebrew:<\/p>\n\n\n\n RubyGems (Recommended)<\/strong> <\/p>\n\n\n\n gem install fastlane # Option 1<\/em><\/strong><\/p>\n\n\n\n Homebrew (macOS Only)<\/strong> <\/p>\n\n\n\n brew install fastlane # Option 2 (macOS only)<\/em><\/strong><\/p>\n\n\n\n Use gem install fastlane for CI\/CD runners and automated environments. <\/p>\n\n\n\n Find Flutter SDK Path<\/strong> <\/p>\n\n\n\n which flutter <\/strong><\/p>\n\n\n\n Example output: <\/strong><\/p>\n\n\n\n \/Users\/username\/development\/flutter\/bin\/flutter <\/strong><\/p>\n\n\n\n Your Flutter SDK path is: <\/p>\n\n\n\n Edit your shell configuration file depending on your terminal<\/p>\n\n\n\n Then, add this line at the end of the file:<\/p>\n\n\n\n export FLUTTER_ROOT=\/Users\/username\/development\/flutter<\/strong><\/p>\n\n\n\n export PATH=”$FLUTTER_ROOT\/bin:$PATH”<\/em><\/strong><\/p>\n\n\n\n Replace the path with your actual Flutter SDK location.<\/p>\n\n\n\n Your environment is correctly set up if the Flutter Doctor is successful. <\/p>\n\n\n\n \/Users\/username\/development\/flutter\/<\/strong> <\/p>\n\n\n\n Make sure local builds are working fine before configuring automation. <\/p>\n\n\n\n flutter build appbundle <\/p>\n\n\n\n flutter build ipa <\/p>\n\n\n\n If local builds fail, they are going to fail in the CI\/CD pipeline<\/strong> too due to the same reasons. <\/p>\n\n\n\n cd android && fastlane init <\/p>\n\n\n\n cd ios && fastlane init For deployment on Google Play we use the keyword ‘upload_to_play_store’ in Fastlane. <\/p>\n\n\n\n In the Google Play Console: <\/p>\n\n\n\n Setup \u2192 API Access <\/p>\n\n\n\n Link a Google Cloud project. <\/p>\n\n\n\n In Google Cloud Console: <\/p>\n\n\n\n In Play Console: <\/p>\n\n\n\n Users & Permissions \u2192 Invite User <\/p>\n\n\n\n Assign the service account: <\/p>\n\n\n\n Release Manager role <\/p>\n\n\n\n fastlane run validate_play_store_json_key json_key:\/path\/to\/key.json <\/em><\/strong><\/p>\n\n\n\n Before uploading Android builds to the Play Store, you must configure release signing properly. Without signing configuration, Play Store deployments will fail. <\/p>\n\n\n\n Run:<\/strong> <\/p>\n\n\n\n keytool -genkey -v \\ <\/p>\n\n\n\n -keystore upload-keystore.jks \\ <\/p>\n\n\n\n -keyalg RSA \\ <\/p>\n\n\n\n -keysize 2048 \\ <\/p>\n\n\n\n -validity 10000 \\ <\/p>\n\n\n\n -alias upload <\/p>\n\n\n\n This generates: <\/p>\n\n\n\n Store this file securely and never commit it to source control. <\/p>\n\n\n\n Create key.properties<\/strong> <\/p>\n\n\n\n Inside the android\/ directory create: <\/p>\n\n\n\n storePassword=YOUR_STORE_PASSWORD <\/p>\n\n\n\n keyPassword=YOUR_KEY_PASSWORD <\/p>\n\n\n\n keyAlias=upload <\/p>\n\n\n\n storeFile=..\/upload-keystore.jks <\/p>\n\n\n\n Configure Gradle Signing<\/strong> <\/p>\n\n\n\n Open: <\/p>\n\n\n\n android\/app\/build.gradle <\/p>\n\n\n\n Add: <\/p>\n\n\n\n def keystoreProperties = new Properties() <\/p>\n\n\n\n def keystorePropertiesFile = rootProject.file(“key.properties”) <\/p>\n\n\n\n if (keystorePropertiesFile.exists()) { <\/p>\n\n\n\n keystoreProperties.load(new FileInputStream(keystorePropertiesFile)) <\/p>\n\n\n\n } <\/p>\n\n\n\n android { <\/p>\n\n\n\n signingConfigs { <\/p>\n\n\n\n release { <\/p>\n\n\n\n keyAlias keystoreProperties[‘keyAlias’] <\/p>\n\n\n\n keyPassword keystoreProperties[‘keyPassword’] <\/p>\n\n\n\n storeFile file(keystoreProperties[‘storeFile’]) <\/p>\n\n\n\n storePassword keystoreProperties[‘storePassword’] <\/p>\n\n\n\n } <\/p>\n\n\n\n } <\/p>\n\n\n\n buildTypes { <\/p>\n\n\n\n release { <\/p>\n\n\n\n signingConfig signingConfigs.release <\/p>\n\n\n\n } <\/p>\n\n\n\n } <\/p>\n\n\n\n } <\/p>\n<\/div>\n\n\n\n For GitHub Actions or other CI\/CD platforms: <\/p>\n\n\n\n Never commit: <\/strong><\/p>\n\n\n\n Run: <\/strong> Setting Up iOS Certificates and Provisioning Profiles<\/strong> <\/p>\n\n\n\n Older Fastlane setups commonly used: <\/p>\n\n\n\n export FASTLANE_PASSWORD=”YourApplePassword” <\/p>\n\n\n\n However, modern iOS CI\/CD pipelines should use an App Store Connect API Key<\/strong> instead of Apple ID passwords wherever possible. <\/p>\n\n\n\n Why use API Keys? <\/strong><\/p>\n\n\n\nWhy Set Up CI\/CD for Flutter with Fastlane?<\/strong> <\/h2>\n\n\n\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
What Is Fastlane?<\/strong> <\/h2>\n\n\n\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
Requirement<\/strong> <\/td> Purpose<\/strong> <\/td> Verify<\/strong> <\/td><\/tr> Flutter SDK 3. x+ <\/td> Build Flutter apps <\/td> flutter -version <\/td><\/tr> Ruby 2.5+ <\/td> Required for Fastlane <\/td> ruby –version <\/td><\/tr> Xcode 14+ <\/td> Build iOS apps\u00a0<\/a><\/strong><\/td> xcode-select -version <\/td><\/tr> Android Studio \/ SDK <\/td> Android builds <\/td> flutter doctor <\/td><\/tr> Apple Developer Account <\/td> iOS publishing <\/td> developer.apple.com <\/td><\/tr> Google Play Console Access <\/td> Android publishing <\/td> play.google.com\/console <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Flutter App Deployment Pipeline Using Fastlane and GitHub Actions<\/h2>\n\n\n
![\"Complete](\"https:\/\/velanapps.com\/blog\/wp-content\/uploads\/2026\/05\/Step-by-Step-Flutter-Deployment-Automation-with-Fastlane.jpg\")
<\/figure>\n<\/div>\n\n\nStage 1: Install Fastlane for Flutter<\/strong> <\/h3>\n\n\n\n
Configure Flutter Environment Variables<\/strong> <\/h3>\n\n\n\n
Set FLUTTER_ROOT<\/strong> <\/h3>\n\n\n\n
Shell<\/td> Config File<\/td> Command to Edit<\/td><\/tr> zsh (default)<\/td> ~\/.zshrc<\/td> open -e ~\/.zshrc<\/td><\/tr> bash<\/td> ~\/.bash_profile<\/td> open -e ~\/.bash_profile<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Stage 2: Check for Flutter Local Builds<\/strong> <\/h2>\n\n\n\n
Android Build<\/strong> <\/h3>\n\n\n\n
iOS Build<\/strong> <\/h3>\n\n\n\n
Stage 3: Setting Up Fastlane in Flutter<\/strong> <\/h2>\n\n\n\n
Android<\/strong> <\/h3>\n\n\n\n
iOS<\/strong> <\/h3>\n\n\n\n
Fastlane creates:
android\/fastlane\/
Appfile
Fastfile
Pluginfile
ios\/fastlane\/
Appfile
Fastfile
Matchfile <\/p>\n\n\n\nStage 4: Configure Appfile<\/strong> <\/h2>\n\n\n\n
Android Appfile<\/strong> <\/h3>\n\n\n\n
# android\/fastlane\/Appfile\u00a0\njson_key_file(\"path\/to\/play-store-credentials.json\")\u00a0\npackage_name(\"com.yourcompany.yourapp\")\u00a0<\/code><\/pre>\n\n\n\niOS Appfile<\/strong> <\/h3>\n\n\n\n
#\u00a0ios\/fastlane\/Appfile\u00a0\n\napple_id(\"yourappleid@example.com\")\u00a0\n\napp_identifier(\"com.yourcompany.yourapp\")\u00a0\n\nteam_id(\"YOUR_TEAM_ID\")\u00a0\n\nitc_team_id(\"YOUR_ITC_TEAM_ID\")<\/code><\/pre>\n\n\n\nStage 5: Fastlane on Android CI\/CD<\/strong> <\/h2>\n\n\n\n
Create a Google Play Service Account <\/strong><\/h3>\n\n\n\n
1. Enable API Access<\/strong> <\/h3>\n\n\n\n
2. Create Service Account<\/strong> <\/h3>\n\n\n\n
\n
\n
\n
\n
3. Grant Permissions<\/strong> <\/h3>\n\n\n\n
Validate Play Store JSON Key<\/strong> <\/h3>\n\n\n\n
Android Fastfile Example<\/strong> <\/h2>\n\n\n\n
default_platform(:android)\u00a0\n\nplatform :android\u00a0do\u00a0\n\ndesc\u00a0\"Deploy Android Beta\"\u00a0\n\nlane :beta\u00a0do\u00a0\n\n\u202f\u202fsh(\"flutter build\u00a0appbundle\u00a0--release\")\u00a0\n\n\u202f\u202fupload_to_play_store(\u00a0\n\n\u202f\u202f\u202f\u202ftrack: \"beta\",\u00a0\n\n\u202f\u202f\u202f\u202faab: \"..\/build\/app\/outputs\/bundle\/release\/app-release.aab\"\u00a0\n\n\u202f\u202f)\u00a0\n\nend\u00a0\n\ndesc\u00a0\"Deploy Android Production\"\u00a0\n\nlane :release\u00a0do\u00a0\n\n\u202f\u202fsh(\"flutter build\u00a0appbundle\u00a0--release\")\u00a0\n\n\u202f\u202fupload_to_play_store(\u00a0\n\n\u202f\u202f\u202f\u202ftrack: \"production\",\u00a0\n\n\u202f\u202f\u202f\u202faab: \"..\/build\/app\/outputs\/bundle\/release\/app-release.aab\"\u00a0\n\n\u202f\u202f)\u00a0\n\nend\u00a0\n\nend<\/code><\/pre>\n\n\n\nAndroid Release Signing Configuration<\/strong> <\/h2>\n\n\n\n
Generate an Android Keystore<\/strong> <\/h3>\n\n\n\n
\n
CI\/CD Secret Management<\/strong> <\/h2>\n\n\n\n
\n
\n
\n
\n
\n
\n
\n
Verify Signed Release Build<\/strong> <\/h3>\n\n\n\n
flutter build appbundle –release
If successful, your Android app is properly signed and ready for deployment to the Play Store. <\/p>\n\n\n\nStage 6: iOS CI\/CD with Fastlane<\/strong> <\/h2>\n\n\n\n
Secure Apple Credentials<\/strong> <\/h3>\n\n\n\n
\n
\n
\n
\n
Create an App Store Connect API Key<\/strong> <\/h3>\n\n\n\n
\n
\n
\n
\n
\n
\n