Here's How You Can Choose the Right Workflow and Automate Your App Releases: A Flutter CI/CD Guide

If you are still building and releasing your Flutter apps manually, you are likely spending hours every week on tasks that could be fully automated. Setting up CI/CD can dramatically reduce that effort, freeing your time to focus on building features, experimenting with ideas, or even launching that side project you have been postponing. The challenge, however, is deciding which CI/CD option is right for your team. With so many tools available, making the right choice can feel overwhelming. In this article, you will learn the key benefits of CI/CD, the major CI/CD options available for Flutter teams, their pros and cons, and practical recommendations to help you choose the setup that best fits your product and workflow. Let’s dive in. What is Flutter CICD? CICD (Continuous Integration/Continuous Delivery) is simply automating the building, testing, and deployment of software by integrating code changes frequently and automatically while validating them through a pipeline. Flutter CICD is specifically CICD for Flutter applications. Key Benefits of Flutter CICD Faster release cycles: CICD automates build and deployment steps, allowing teams to release updates more frequently instead of waiting for manual processes. Easier deployment: Releasing mobile apps involves complex setup steps that include app signing, dependency setup, and build configurations. These complex steps are automated by CICD, freeing up the developers to focus on shipping new features. Continuous monitoring: Integrating error monitoring and automatic testing into the CICD workflow helps the team catch bugs before and after release. Faster release cycles: CICD automates build and deployment steps, allowing teams to release updates more frequently instead of waiting for manual processes. Easier deployment: Releasing mobile apps involves complex setup steps that include app signing, dependency setup, and build configurations. These complex steps are automated by CICD, freeing up the developers to focus on shipping new features. Continuous monitoring: Integrating error monitoring and automatic testing into the CICD workflow helps the team catch bugs before and after release. Major CICD Options for Flutter There are many CICD options for Flutter apps available. Below, you will find a breakdown of these options, their pros and cons, and the kind of teams they are best fit for. Codemagic (Flutter-focused CI/CD) Codemagic is a CI/CD platform designed specifically for Flutter and mobile development, with ready-to-run workflows. Pros Pros Built specifically for Flutter, so minimal configuration is required Automatically builds Android and iOS with default workflows Supports publishing directly to the Play Store and App Store Easier setup compared to general CI platforms Built specifically for Flutter, so minimal configuration is required Automatically builds Android and iOS with default workflows Supports publishing directly to the Play Store and App Store Easier setup compared to general CI platforms Cons Cons Less flexible for complex multi-service pipelines Less flexible for complex multi-service pipelines Best for: Flutter first teams wanting fast setup and minimal configuration. Best for: Bitrise (mobile-focused CI/CD) Bitrise is a mobile-focused CI/CD platform with ready-made steps for mobile workflows, including Flutter. Pros Pros Strong mobile ecosystem (Android + iOS optimized workflows) Pre-configured steps for signing, testing, and deployment Good support for device testing and automation Strong mobile ecosystem (Android + iOS optimized workflows) Pre-configured steps for signing, testing, and deployment Good support for device testing and automation Cons Cons More complex setup than Codemagic Build times are slower for Flutter than in Codemagic More complex setup than Codemagic Build times are slower for Flutter than in Codemagic Best for: Mobile-focused teams needing deep third‑party integration support and workflow control. Best for: Appcircle (mobile-focused CI/CD) Appcircle is also a mobile-focused CI/CD platform with default workflow templates Pros Pros Built specifically for mobile apps (supports Flutter workflows) Automates code signing and provisioning profile management Provides a Workflow Marketplace where you can drag-and-drop workflow steps into your pipeline Built specifically for mobile apps (supports Flutter workflows) Automates code signing and provisioning profile management Provides a Workflow Marketplace where you can drag-and-drop workflow steps into your pipeline Cons Cons Might require slightly more initial configuration for deploying Flutter apps. Might require slightly more initial configuration for deploying Flutter apps. Best for: Mobile-focused teams needing fast setup for building and distribution. Best for: GitHub Actions A cloud CI/CD service integrated directly into GitHub repositories, widely adopted because of its seamless repository integration. Pros Pros Native integration with GitHub repositories Highly customizable pipelines Large marketplace of reusable workflow actions No need to manage build servers Native integration with GitHub repositories Highly customizable pipelines Large marketplace of reusable workflow actions No need to manage build servers Cons Cons Requires more manual setup for Flutter pipelines YAML configuration complexity can cause setup challenges Requires more manual setup for Flutter pipelines YAML configuration complexity can cause setup challenges Best for: Teams already hosting code on GitHub wanting flexible automation. Best for: GitLab CI/CD Overview: Overview: CI/CD system integrated into GitLab repositories with built-in security scanning and pipeline tooling. Pros Pros Integrated CI/CD inside the GitLab platform Built-in security testing and DevOps features Flexible pipeline configuration Integrated CI/CD inside the GitLab platform Built-in security testing and DevOps features Flexible pipeline configuration Cons Cons More configuration is required compared to Flutter-specific platforms Setup complexity for mobile signing and deployment More configuration is required compared to Flutter-specific platforms Setup complexity for mobile signing and deployment Best for: Organizations that already use GitLab and want to maintain it for their entire DevOps lifecycle. Best for: CircleCI / Travis CI (general CI tools) Overview: Overview: General-purpose CI/CD systems capable of running Flutter builds in containerized environments. Pros Pros Fast parallel builds (CircleCI) Language-agnostic pipelines Mature ecosystem of integrations Fast parallel builds (CircleCI) Language-agnostic pipelines Mature ecosystem of integrations Cons Cons Flutter workflows require manual configuration Flutter workflows require manual configuration Best for: Teams already using these CI platforms for backend or web services and want to maintain them for their entire DevOps lifecycle. Best for: Pricing Breakdown Most CICD platforms already offer generous free tiers that allow you spin up and deploy your projects with ease. However, depending on your project needs, team size, and frequency of releases, you may need to pay to use certain CICD features. Understanding the pricing helps you make the right choice that’ll be beneficial for you and your team in the long run. CICD tools generally charge for the following: Artifact storage Build logs retention Additional team members macOS machines Artifact storage Build logs retention Additional team members macOS machines Here is the pricing breakdown of some CICD tools: Release Automation Tools Release automation tools sit at the CD layer of your pipeline and help you automate other processes required before the app is released. They help you manage processes like app signing, distribution, and store submission. Plug them into your CICD tool to fully automate your release workflow. Here are some release automation tools you can use: Fastlane Fastlane is an open-source automation tool that automates the process of building, signing, and releasing mobile apps to app distribution platforms. What it automates App signing Screenshot generation Uploading to: App Store Connect Google Play Store Firebase App Distribution TestFlight deployment Version number updates App signing Screenshot generation Uploading to: App Store Connect Google Play Store Firebase App Distribution App Store Connect Google Play Store Firebase App Distribution App Store Connect Google Play Store Firebase App Distribution TestFlight deployment Version number updates Firebase App Distribution Firebase App Distribution is a service that allows you to distribute pre-release versions of your mobile apps to testers. What it automates Internal testing distribution Uploading APKs, AABs, or IPAs Tester invitations Release notes distribution Build notifications Internal testing distribution Uploading APKs, AABs, or IPAs Tester invitations Release notes distribution Build notifications Most release automation tools use Appstore Connect API and Google Play Developer API to carry out actions under the hood. However, you can still use these APIs in custom scripts on your CICD workflows to carry out release automation tasks. Shorebird Shorebird is a Flutter-specific post-release automation tool that introduces Code Push to mobile apps. With it, your users can get new updates over-the-air (OTA) without having to download from the App Store or Play Store. Its only limitation is that you can’t push native code changes, just Flutter and Dart code changes. What it Automates Code Push Updates Patch Distribution Update Delivery Patch Rollbacks Code Push Updates Patch Distribution Update Delivery Patch Rollbacks It’s especially useful for hotfix production crashes. Resources Selecting a tool for your team or product is an important decision to be made after careful consideration. Personally, I am biased to Codemagic and Firebase app distribution as these are the tools I currently use, and they get the job done. Below is a short collection of links to articles to help you configure your CICD workflows. Publish your Flutter app to App Store with Codemagic CI/CD Publish your Flutter app to Google Play Store with Codemagic CI/CD Setting up CI/CD for Flutter Android apps With Github Actions, Firebase App Distribution & Fastlane Distribute iOS apps to testers on Firebase App Distribution using Fastlane Bitrise- Getting started with Flutter Integration Publish your Flutter app to App Store with Codemagic CI/CD Publish your Flutter app to App Store with Codemagic CI/CD Publish your Flutter app to App Store with Codemagic CI/CD Publish your Flutter app to Google Play Store with Codemagic CI/CD Publish your Flutter app to Google Play Store with Codemagic CI/CD Publish your Flutter app to Google Play Store with Codemagic CI/CD Setting up CI/CD for Flutter Android apps With Github Actions, Firebase App Distribution & Fastlane Setting up CI/CD for Flutter Android apps With Github Actions, Firebase App Distribution & Fastlane Setting up CI/CD for Flutter Android apps With Github Actions, Firebase App Distribution & Fastlane Distribute iOS apps to testers on Firebase App Distribution using Fastlane Distribute iOS apps to testers on Firebase App Distribution using Fastlane Distribute iOS apps to testers on Firebase App Distribution using Fastlane Bitrise- Getting started with Flutter Integration Bitrise- Getting started with Flutter Integration Bitrise- Getting started with Flutter Integration Most CICD platforms also provide docs and quick start guides; check those out as well. What makes a great workflow? The basic use of a CICD workflow is to automate your integration and deployment processes to save you hours of manual work. However, there are certain steps you could add to your workflow to help you and your team become more effective, improve the quality of your releases, and shorten your release cycles. Let’s look at a couple of steps you can add to your workflow to move it from basic to great. Selecting the right CICD option. Selecting the right CICD option is obviously a very important step. Considering your team size, your organization structure, and your product needs should drive the decision you end up making. Certain choices may seem good at first, but end up causing you to rack up unnecessary expenses in the long run. Set up workflow triggers. Setting up workflow triggers helps you cut down on the manual work of running the CICD workflow yourself. You can set up your workflow to listen for triggers to run, then, depending on your setup, simply make a PR or push to a certain branch, and the workflow begins to run independently. Incorporate code quality checks. When working with a team, it’s important to set up code quality standards using linters. This helps enforce the same standard on every code being pushed. Then, by using the Flutter analyze command in your workflow, ensure that only code that meets the standard set is being accepted. Integrate automated testing. Incorporating automated testing in your workflow enhances quality assurance. This helps you ensure that you aren’t deploying code with failing tests. Integrate jobs to run unit, widget, and integration tests in your workflow, reducing the chances of shipping bugs in your code. During CI, once any tests fail, ensure you have notifications set to ping those responsible for fixing them through channels like Slack and email. Set up release automation for both Android and iOS Depending on your product needs and the CICD option you choose, you might still need to integrate release automation tools like Firebase distribution, Fastlane, or Shorebird with your CICD tool. While this is optional, it can help speed up your releases and iterations. Set up flavored workflows. When working on live projects, it is highly recommended to create different working environments. This approach helps you save time in the long run. Using the same codebase, you can test different configurations, have different release tracks, catch issues before they show up on production, etc. When you have set up flavored environments for your project, you can set up CICD workflows for those different flavors (environments). Personally, I use Firebase distribution for staging releases. This approach helps me catch any existing bugs during testing while on the staging environment, before the apps even get to the store. Don’t know about flavors? Check these references to get started: Build flavors in Flutter (Android and iOS) with different Firebase projects per flavor Build flavors in Flutter (Android and iOS) with different Firebase projects per flavor Build flavors in Flutter (Android and iOS) with different Firebase projects per flavor Mastering Flutter Flavors: Tailoring Your App for Multiple Environments Mastering Flutter Flavors: Tailoring Your App for Multiple Environments Mastering Flutter Flavors: Tailoring Your App for Multiple Environments Set up automated build versioning and release notes creation. Manually updating your app versions for each release can be error-prone and time-consuming; however, this task can be automated right in your workflow. In your workflow, you can handle this with a script that checks the latest build released and increments the build number by 1. This is possible by using the App Store, Google Play, and Firebase distribution APIs available. You can also generate release notes from your commits by extracting the commit messages from your last set of commits or from the last git tag. While at this, you can use AI to further simplify the release notes so that it’s easier for QA or any non-technical member of the team to know what the newest release currently covers. You can do this by calling an AI endpoint, passing the extracted commit messages, right there in your workflow, using a script. After this, you then save in a file, which you pass to your CICD tool to submit alongside the apps to the distribution platform. Set up build notifications. To keep your team informed on the status of your releases, it is important to set up build notifications to alert your team on platforms like Slack, Teams, or email. With this in place, you can easily share the status of any release with the rest of your team. You don’t have to manually make announcements each time a build is deployed. Integrate error monitoring into your workflow. Many times, when a crash happens in production and is picked up by your error monitoring tool, the stacktrace is unreadable, and because of this, it makes it difficult to debug. However, you can fix this issue by adding a step to your workflow that basically uploads debug symbols to your error monitoring tool after the app is built. With this, when a crash happens in prod, the error monitoring tool is able to de-obfuscate the stack trace, and now, you can see exactly what broke. Sentry and Crashlytics work well for this. OTA Automated Rollbacks Sometimes, software can act unpredictably, and a release might suddenly start crashing in prod. Instead of scrambling to fix and submit a new build on the store. You can automate your rollbacks using Shorebird and an error monitoring tool like Sentry. Add a scheduled CI job that checks Sentry’s metrics, and if the crash rates exceed a particular threshold, it then automatically triggers a shorebird rollback. Sample Codmagic Workflow Script This is a sample Flutter iOS workflow script that: Runs only when the last commit contains the ticket Id Auto-increments build numbers Generates AI-powered release notes Sets up Flutter and iOS project environments Builds the IPA Uploads it to TestFlight workflows: ios_staging: name: iOS Staging Build max_build_duration: 60 instance_type: mac_mini_m2 integrations: app_store_connect: YOUR-APPSTORE-CONNECT-API-KEY-NAME triggering: events: - push branch_patterns: - pattern: "staging" include: true source: true cancel_previous_builds: true environment: ios_signing: provisioning_profiles: - PROFILE-NAME-ON-CODEMAGIC certificates: - CERT-NAME-ON CODEMAGIC groups: - GROUP-NAME flutter: stable xcode: latest cocoapods: default vars: APP_ID: APPLE-APP-ID VERSION_NAME: "1.0.1" scripts: - name: Exit build if keyword not defined script: | set -e set -x COMMIT_MSG=$(git log -1 --pretty=%B) echo "$COMMIT_MSG" if [[ $COMMIT_MSG != *"OA-"* && $COMMIT_MSG != *"OH-"* ]]; then echo "Commit needs to include ticketID in its message." exit 1 else echo "Commit message includes ticketID, moving forward..." fi - name: Fetch build number script: | BUILD_NUMBER=$(($(app-store-connect get-latest-testflight-build-number "$APP_ID") + 1)) echo "BUILD_NUMBER=$BUILD_NUMBER" >> $CM_ENV - name: Generate AI release notes with Claude Haiku 4.5 script: | set -eo pipefail VERSION_NAME=${VERSION_NAME:-"Unknown"} BRANCH_NAME=${CM_BRANCH:-"unknown"} COMMITS=$(git log -10 --pretty=format:"%s" --no-merges || echo "") write_release_notes() { local TEXT="$1" jq -n --arg text "$TEXT" \ '[{"language": "en-US", "text": $text}]' > release_notes.json cat release_notes.json } if [ -z "$COMMITS" ]; then echo "No commits → fallback basic notes" FALLBACK="APP\n\nVersion: $VERSION_NAME ($BUILD_NUMBER)\nBranch: $BRANCH_NAME\n\nNo significant changes detected in this build." write_release_notes "$FALLBACK" exit 0 fi PAYLOAD=$(jq -n \ --arg commits "$COMMITS" \ '{ model: "claude-haiku-4-5", max_tokens: 800, temperature: 0.2, messages: [{ role: "user", content: ("Create concise plain text release notes from these commits:\n\n" + $commits + "\n\nInclude Features, Improvements, Bug Fixes sections. Do not use symbols.") }] }') RESPONSE=$(curl --silent --show-error \ -H "Content-Type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --data "$PAYLOAD" \ https://api.anthropic.com/v1/messages) || true echo "$RESPONSE" > claude_raw.json NOTES=$(jq -r '.content[0].text // empty' claude_raw.json 2>/dev/null) if [ -z "$NOTES" ]; then echo "Claude failed → fallback" FALLBACK=$(printf "APP\n\nVersion: %s (%s)\nBranch: %s\n\nRecent commits:\n%s" \ "$VERSION_NAME" "$BUILD_NUMBER" "$BRANCH_NAME" \ "$(git log -10 --pretty=format:'- %s' --no-merges)") write_release_notes "$FALLBACK" else write_release_notes "$NOTES" fi - name: Set up code signing settings on Xcode project script: | xcode-project use-profiles - name: Get Flutter packages script: | flutter pub get - name: Install CocoaPods script: | pod install --project-directory=ios - name: Build iOS IPA script: | flutter build ipa \ --release \ --build-name=$VERSION_NAME \ --build-number=$BUILD_NUMBER \ --export-options-plist=/Users/builder/export_options.plist artifacts: - build/ios/ipa/*.ipa publishing: app_store_connect: auth: integration submit_to_testflight: true Runs only when the last commit contains the ticket Id Runs only when the last commit contains the ticket Id Auto-increments build numbers Auto-increments build numbers Generates AI-powered release notes Generates AI-powered release notes Sets up Flutter and iOS project environments Sets up Flutter and iOS project environments Builds the IPA Builds the IPA Uploads it to TestFlight workflows: ios_staging: name: iOS Staging Build max_build_duration: 60 instance_type: mac_mini_m2 integrations: app_store_connect: YOUR-APPSTORE-CONNECT-API-KEY-NAME triggering: events: - push branch_patterns: - pattern: "staging" include: true source: true cancel_previous_builds: true environment: ios_signing: provisioning_profiles: - PROFILE-NAME-ON-CODEMAGIC certificates: - CERT-NAME-ON CODEMAGIC groups: - GROUP-NAME flutter: stable xcode: latest cocoapods: default vars: APP_ID: APPLE-APP-ID VERSION_NAME: "1.0.1" scripts: - name: Exit build if keyword not defined script: | set -e set -x COMMIT_MSG=$(git log -1 --pretty=%B) echo "$COMMIT_MSG" if [[ $COMMIT_MSG != *"OA-"* && $COMMIT_MSG != *"OH-"* ]]; then echo "Commit needs to include ticketID in its message." exit 1 else echo "Commit message includes ticketID, moving forward..." fi - name: Fetch build number script: | BUILD_NUMBER=$(($(app-store-connect get-latest-testflight-build-number "$APP_ID") + 1)) echo "BUILD_NUMBER=$BUILD_NUMBER" >> $CM_ENV - name: Generate AI release notes with Claude Haiku 4.5 script: | set -eo pipefail VERSION_NAME=${VERSION_NAME:-"Unknown"} BRANCH_NAME=${CM_BRANCH:-"unknown"} COMMITS=$(git log -10 --pretty=format:"%s" --no-merges || echo "") write_release_notes() { local TEXT="$1" jq -n --arg text "$TEXT" \ '[{"language": "en-US", "text": $text}]' > release_notes.json cat release_notes.json } if [ -z "$COMMITS" ]; then echo "No commits → fallback basic notes" FALLBACK="APP\n\nVersion: $VERSION_NAME ($BUILD_NUMBER)\nBranch: $BRANCH_NAME\n\nNo significant changes detected in this build." write_release_notes "$FALLBACK" exit 0 fi PAYLOAD=$(jq -n \ --arg commits "$COMMITS" \ '{ model: "claude-haiku-4-5", max_tokens: 800, temperature: 0.2, messages: [{ role: "user", content: ("Create concise plain text release notes from these commits:\n\n" + $commits + "\n\nInclude Features, Improvements, Bug Fixes sections. Do not use symbols.") }] }') RESPONSE=$(curl --silent --show-error \ -H "Content-Type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --data "$PAYLOAD" \ https://api.anthropic.com/v1/messages) || true echo "$RESPONSE" > claude_raw.json NOTES=$(jq -r '.content[0].text // empty' claude_raw.json 2>/dev/null) if [ -z "$NOTES" ]; then echo "Claude failed → fallback" FALLBACK=$(printf "APP\n\nVersion: %s (%s)\nBranch: %s\n\nRecent commits:\n%s" \ "$VERSION_NAME" "$BUILD_NUMBER" "$BRANCH_NAME" \ "$(git log -10 --pretty=format:'- %s' --no-merges)") write_release_notes "$FALLBACK" else write_release_notes "$NOTES" fi - name: Set up code signing settings on Xcode project script: | xcode-project use-profiles - name: Get Flutter packages script: | flutter pub get - name: Install CocoaPods script: | pod install --project-directory=ios - name: Build iOS IPA script: | flutter build ipa \ --release \ --build-name=$VERSION_NAME \ --build-number=$BUILD_NUMBER \ --export-options-plist=/Users/builder/export_options.plist artifacts: - build/ios/ipa/*.ipa publishing: app_store_connect: auth: integration submit_to_testflight: true Uploads it to TestFlight workflows: ios_staging: name: iOS Staging Build max_build_duration: 60 instance_type: mac_mini_m2 integrations: app_store_connect: YOUR-APPSTORE-CONNECT-API-KEY-NAME triggering: events: - push branch_patterns: - pattern: "staging" include: true source: true cancel_previous_builds: true environment: ios_signing: provisioning_profiles: - PROFILE-NAME-ON-CODEMAGIC certificates: - CERT-NAME-ON CODEMAGIC groups: - GROUP-NAME flutter: stable xcode: latest cocoapods: default vars: APP_ID: APPLE-APP-ID VERSION_NAME: "1.0.1" scripts: - name: Exit build if keyword not defined script: | set -e set -x COMMIT_MSG=$(git log -1 --pretty=%B) echo "$COMMIT_MSG" if [[ $COMMIT_MSG != *"OA-"* && $COMMIT_MSG != *"OH-"* ]]; then echo "Commit needs to include ticketID in its message." exit 1 else echo "Commit message includes ticketID, moving forward..." fi - name: Fetch build number script: | BUILD_NUMBER=$(($(app-store-connect get-latest-testflight-build-number "$APP_ID") + 1)) echo "BUILD_NUMBER=$BUILD_NUMBER" >> $CM_ENV - name: Generate AI release notes with Claude Haiku 4.5 script: | set -eo pipefail VERSION_NAME=${VERSION_NAME:-"Unknown"} BRANCH_NAME=${CM_BRANCH:-"unknown"} COMMITS=$(git log -10 --pretty=format:"%s" --no-merges || echo "") write_release_notes() { local TEXT="$1" jq -n --arg text "$TEXT" \ '[{"language": "en-US", "text": $text}]' > release_notes.json cat release_notes.json } if [ -z "$COMMITS" ]; then echo "No commits → fallback basic notes" FALLBACK="APP\n\nVersion: $VERSION_NAME ($BUILD_NUMBER)\nBranch: $BRANCH_NAME\n\nNo significant changes detected in this build." write_release_notes "$FALLBACK" exit 0 fi PAYLOAD=$(jq -n \ --arg commits "$COMMITS" \ '{ model: "claude-haiku-4-5", max_tokens: 800, temperature: 0.2, messages: [{ role: "user", content: ("Create concise plain text release notes from these commits:\n\n" + $commits + "\n\nInclude Features, Improvements, Bug Fixes sections. Do not use symbols.") }] }') RESPONSE=$(curl --silent --show-error \ -H "Content-Type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --data "$PAYLOAD" \ https://api.anthropic.com/v1/messages) || true echo "$RESPONSE" > claude_raw.json NOTES=$(jq -r '.content[0].text // empty' claude_raw.json 2>/dev/null) if [ -z "$NOTES" ]; then echo "Claude failed → fallback" FALLBACK=$(printf "APP\n\nVersion: %s (%s)\nBranch: %s\n\nRecent commits:\n%s" \ "$VERSION_NAME" "$BUILD_NUMBER" "$BRANCH_NAME" \ "$(git log -10 --pretty=format:'- %s' --no-merges)") write_release_notes "$FALLBACK" else write_release_notes "$NOTES" fi - name: Set up code signing settings on Xcode project script: | xcode-project use-profiles - name: Get Flutter packages script: | flutter pub get - name: Install CocoaPods script: | pod install --project-directory=ios - name: Build iOS IPA script: | flutter build ipa \ --release \ --build-name=$VERSION_NAME \ --build-number=$BUILD_NUMBER \ --export-options-plist=/Users/builder/export_options.plist artifacts: - build/ios/ipa/*.ipa publishing: app_store_connect: auth: integration submit_to_testflight: true workflows: ios_staging: name: iOS Staging Build max_build_duration: 60 instance_type: mac_mini_m2 integrations: app_store_connect: YOUR-APPSTORE-CONNECT-API-KEY-NAME triggering: events: - push branch_patterns: - pattern: "staging" include: true source: true cancel_previous_builds: true environment: ios_signing: provisioning_profiles: - PROFILE-NAME-ON-CODEMAGIC certificates: - CERT-NAME-ON CODEMAGIC groups: - GROUP-NAME flutter: stable xcode: latest cocoapods: default vars: APP_ID: APPLE-APP-ID VERSION_NAME: "1.0.1" scripts: - name: Exit build if keyword not defined script: | set -e set -x COMMIT_MSG=$(git log -1 --pretty=%B) echo "$COMMIT_MSG" if [[ $COMMIT_MSG != *"OA-"* && $COMMIT_MSG != *"OH-"* ]]; then echo "Commit needs to include ticketID in its message." exit 1 else echo "Commit message includes ticketID, moving forward..." fi - name: Fetch build number script: | BUILD_NUMBER=$(($(app-store-connect get-latest-testflight-build-number "$APP_ID") + 1)) echo "BUILD_NUMBER=$BUILD_NUMBER" >> $CM_ENV - name: Generate AI release notes with Claude Haiku 4.5 script: | set -eo pipefail VERSION_NAME=${VERSION_NAME:-"Unknown"} BRANCH_NAME=${CM_BRANCH:-"unknown"} COMMITS=$(git log -10 --pretty=format:"%s" --no-merges || echo "") write_release_notes() { local TEXT="$1" jq -n --arg text "$TEXT" \ '[{"language": "en-US", "text": $text}]' > release_notes.json cat release_notes.json } if [ -z "$COMMITS" ]; then echo "No commits → fallback basic notes" FALLBACK="APP\n\nVersion: $VERSION_NAME ($BUILD_NUMBER)\nBranch: $BRANCH_NAME\n\nNo significant changes detected in this build." write_release_notes "$FALLBACK" exit 0 fi PAYLOAD=$(jq -n \ --arg commits "$COMMITS" \ '{ model: "claude-haiku-4-5", max_tokens: 800, temperature: 0.2, messages: [{ role: "user", content: ("Create concise plain text release notes from these commits:\n\n" + $commits + "\n\nInclude Features, Improvements, Bug Fixes sections. Do not use symbols.") }] }') RESPONSE=$(curl --silent --show-error \ -H "Content-Type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --data "$PAYLOAD" \ https://api.anthropic.com/v1/messages) || true echo "$RESPONSE" > claude_raw.json NOTES=$(jq -r '.content[0].text // empty' claude_raw.json 2>/dev/null) if [ -z "$NOTES" ]; then echo "Claude failed → fallback" FALLBACK=$(printf "APP\n\nVersion: %s (%s)\nBranch: %s\n\nRecent commits:\n%s" \ "$VERSION_NAME" "$BUILD_NUMBER" "$BRANCH_NAME" \ "$(git log -10 --pretty=format:'- %s' --no-merges)") write_release_notes "$FALLBACK" else write_release_notes "$NOTES" fi - name: Set up code signing settings on Xcode project script: | xcode-project use-profiles - name: Get Flutter packages script: | flutter pub get - name: Install CocoaPods script: | pod install --project-directory=ios - name: Build iOS IPA script: | flutter build ipa \ --release \ --build-name=$VERSION_NAME \ --build-number=$BUILD_NUMBER \ --export-options-plist=/Users/builder/export_options.plist artifacts: - build/ios/ipa/*.ipa publishing: app_store_connect: auth: integration submit_to_testflight: true Best Practices for CICD Keep pipelines fast: long pipelines slow teams down and delay adoption. Cache dependencies, run jobs in parallel, and avoid rebuilding unchanged components. Automate everything that is repeatable: reducing manual steps lowers human error and improves reliability. Automate jobs like versioning, store deployment, lint checks, etc. Use flavored environments: this is recommended DevOps practice as it helps you manage the workflows for the different environments, improving testing and reducing errors. Secure your pipeline: use encrypted secrets and least privileged access for your workflows. Store your secrets in CI secret managers. Keep your workflows maintainable: Avoid massive monolithic scripts. Keep the workflow file readable. Keep pipelines fast: long pipelines slow teams down and delay adoption. Cache dependencies, run jobs in parallel, and avoid rebuilding unchanged components. Automate everything that is repeatable: reducing manual steps lowers human error and improves reliability. Automate jobs like versioning, store deployment, lint checks, etc. Use flavored environments: this is recommended DevOps practice as it helps you manage the workflows for the different environments, improving testing and reducing errors. Secure your pipeline: use encrypted secrets and least privileged access for your workflows. Store your secrets in CI secret managers. Keep your workflows maintainable: Avoid massive monolithic scripts. Keep the workflow file readable. Conclusion Setting up CICD for your Flutter apps will improve your quality of life as a Flutter developer. No more long hours spent in manually building and distributing your Flutter apps on different platforms. You can now build once, push your code, and go for a coffee break, then come back to find the app waiting in the stores. For any questions, you can find me on X, LinkedIn, and GitHub. X LinkedIn GitHub