flutter-cicd

name	flutter-cicd
description	Set up CI/CD pipelines for Flutter apps. Use when configuring automated testing, build, or deployment workflows with GitHub Actions or Fastlane.
metadata	{"triggers":{"files":[".github/workflows/**.yml","fastlane/**","android/fastlane/**","ios/fastlane/**"],"keywords":["ci","cd","pipeline","build","deploy","release","action","workflow"]}}

CI/CD Standards

Priority: P1 (HIGH)

Core Pipeline Steps

1. Environment Setup: Use stable Flutter channel. Cache dependencies (pub, gradle, cocoapods).
2. Static Analysis: Enforce flutter analyze and dart format. Fail on any warning in strict mode.
3. Testing: Run unit, widget, and integration tests. Upload coverage reports (e.g., Codecov).
4. Build:

• Android: Build App Bundle (.aab) for Play Store.
• iOS: Sign and build .ipa (requires macOS runner).

5. Deployment (CD): Automated upload to TestFlight/Play Console using standard tools (Fastlane, Codemagic).

Best Practices

• Timeout Limits: Always set timeout-minutes (e.g., 30m) to save costs on hung jobs.
• Fail Fast: Run Analyze/Format before Tests/Builds.
• Secrets: Never commit keys. Use GitHub Secrets or secure vaults for keystore.jks and .p8 certs.
• Versioning: Automate version bumping based on git tags or semantic version scripts.

Reference

• GitHub Actions Template - Standard workflow file.
• Advanced Large-Scale Workflow - Parallel jobs, Caching, Strict Mode.
• Fastlane Standards - Automated Signing & Deployment.

Anti-Patterns

• No Secrets in Repo: Store keystore.jks, .p8, and .env in GitHub Secrets
• No Uncapped Jobs: Always set timeout-minutes (e.g., 30m) to save runner minutes
• No Manual Versioning: Automate pubspec.yaml versioning via git tags or scripts
• No Late Analysis: Run flutter analyze before builds/tests for fast failure

Related Topics

flutter/testing | dart/tooling

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

• run analyze/format