Skip to content
Skills Library
Programming · Planning

flutter-release-engineering

/flutter-release-engineering

Use when setting up or reviewing how a Flutter app ships — build flavors and environment config (--dart-define-from-file), app signing, the flutter build matrix per platform, version/build-number strategy, store metadata, and whether to use an over-the-air update service (Shorebird). Covers release concerns the official Flutter/Dart skills do not.

Licence
Apache-2.0
Last repository change
19.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Use when setting up or reviewing how a Flutter app ships — build flavors and environment config (--dart-define-from-file), app signing, the flutter build matrix per platform, version/build-number strategy, store metadata, and whether to use an over-the-air update service (Shorebird). Covers release concerns the official Flutter/Dart skills do not.

Original author description

Use when setting up or reviewing how a Flutter app ships — build flavors and environment config (--dart-define-from-file), app signing, the flutter build matrix per platform, version/build-number strategy, store metadata, and whether to use an over-the-air update service (Shorebird). Covers release concerns the official Flutter/Dart skills do not.

How it works

  1. Overview
  2. When to Use
  3. Process
  4. Usage
  5. Red Flags
  6. Verification
  7. References
Original SKILL.md headings · 106 lines, 742 words
SKILL.md preview
---
name: flutter-release-engineering
description: Use when setting up or reviewing how a Flutter app ships — build flavors and environment config (--dart-define-from-file), app signing, the flutter build matrix per platform, version/build-number strategy, store metadata, and whether to use an over-the-air update service (Shorebird). Covers release concerns the official Flutter/Dart skills do not.
---

# Flutter Release Engineering

## Overview
The **Flutter Release Engineering** skill provides the complete deployment, packaging, and configuration lifecycle for Flutter applications across mobile (Android/iOS), web, and desktop. Operating across **Claude Code** and **Google Antigravity**, this skill guides teams through environment configuration injection (`--dart-define-from-file`), flavor schemes, secure app signing without in-repo credentials, reproducible CI build matrices, semver versioning, and over-the-air (OTA) patching via Shorebird.

## When to Use

### Trigger Scenarios
- Configuring environment flavors (dev, staging, production) and injecting configuration files.
- Setting up automated CI/CD build matrices for App Store (IPA), Google Play (AAB), Web, and Desktop.
- Establishing secure key signing pipelines for Android Keystores and Apple Provisioning Profiles.
- Evaluating and deploying over-the-air code patching (Shorebird) while managing store compliance.

### When NOT to Use
- **Day-to-day feature implementation**: Use `flutter-implementer` and official `flutter-*` skills for widget and domain coding.
- **Pure backend container builds**: For Docker or Cloud Run builds, use `build-and-ci-gates`.
- **Local code formatting**: Use `dart format` and `dart analyze`.

## Process

```mermaid
flowchart TD
    A[Release Candidate Ready] --> B[Step 1: Environment Config Injection]
    B --> C[Step 2: Credential & Signing Validation]
    C --> D[Step 3: Multi-Platform Release Build Matrix]
    D --> E[Step 4: Obfuscation & Symbol Archival]
    E --> F[Step 5: Automated Store Packaging & Metadata]
```

### 1. Environment Configuration
- Inject non-secret configuration variables using build-time definition files:
  `flutter build <target> --dart-define-from-file=config/prod.json`
- Access values in Dart via a typed `AppConfig` wrapping `String.fromEnvironment` and `bool.fromEnvironment`.
- Manage native variations (package IDs, bundle names, icons, Firebase configs) using Android product flavors and iOS schemes/xcconfig.
- **Never commit production secrets, service keys, or keystores into source control.** Store secrets strictly in CI encrypted stores.

### 2. Signing Security
- **Android**: Configure `key.properties` (git-ignored) with keystore paths injected via CI environment variables. Prefer Google Play App Signing.
- **iOS**: Manage signing identities and provisioning profiles via fastlane `match` or App Store Connect API keys in CI. Zero `.p12` files in the repository.
- Verify signature integrity on build artifacts before distribution (`apksigner verify`, `codesign -dv`).

### 3. Multi-Platform Build Matrix
Build from clean, pinned checkouts using Flutter Version Management (FVM):
- **Android App Bundle (Play Store)**:
  `flutter build appbundle --release --flavor prod --dart-define-from-file=config/prod.json`
- **Android APK (QA/Sideload)**:
  `flutter build apk --release --flavor staging --dart-define-from-file=config/staging.json`
- **iOS IPA (App Store)**:
  `flutter build ipa --release --flavor prod --export-options-plist=ios/exportOptions.plist --dart-define-from-file=config/prod.json`
- **Web**:
  `flutter build web --release --dart-define-from-file=config/prod.json`

### 4. Obfuscation & Crash Symbol Storage
Enable code obfuscation and split debug symbols:
`--obfuscate --split-debug-info=build/symbols`
Archive `build/symbols` in CI storage with release build tags for crash symbolication in Sentry or Firebase Crashlytics.

### 5. Versioning & Over-The-Air Updates
- Maintain `version: X.Y.Z+BUILD` in `pubspec.yaml`, setting `+BUILD` dynamically in CI via `--build-number=$CI_PIPELINE_IID`.
- Tag git releases (`vX.Y.Z`) following Conventional Commits.
- Evaluate Shorebird OTA patching only for Dart-level bug fixes; never bypass app store review for native modifications or permissions changes.

## Usage

### Build Commands & Matrix
Production Android release build:
```bash
flutter build appbundle --release --flavor prod --dart-define-from-file=config/prod.json --obfuscate --split-debug-info=build/symbols
```

Production iOS release build:
```bash
flutter build ipa --release --flavor prod --dart-define-from-file=config/prod.json --export-options-plist=ios/exportOptions.plist
```

### Example Prompts
```text
"Set up --dart-define-from-file configuration and product flavors for dev, staging, and prod in our Flutter repository."
```
```text
"Configure our CI GitHub Actions workflow to build release AAB and IPA artifacts with debug symbol archiving."
```

### Host Execution Instructions
- **Claude Code**: Invoke via `/skill flutter-release-engineering` or prompt for Flutter release/flavor setup.
- **Google Antigravity**: Run build and signing validation commands via terminal or integrate with release automation pipelines.

## Red Flags
- Hard-coding API URLs, backend endpoints, or environment flags in Dart source files.
- Committing Android `.jks`/`.keystore` files or iOS `.p12` certificates to git history.
- Manually incrementing build numbers in `pubspec.yaml` instead of driving monotonically in CI.
- Shipping release builds without stripping and archiving debug symbols.
- Using Shorebird OTA updates to push native permission or manifest changes.

## Verification
- [ ] No plaintext secrets or keys committed in source files or `pubspec.yaml`.
- [ ] Configuration separated cleanly across `config/*.json` and loaded via `--dart-define-from-file`.
- [ ] Production Android bundle (`.aab`) and iOS IPA (`.ipa`) build cleanly.
- [ ] Code obfuscation and split debug symbols generated and archived in `build/symbols`.
- [ ] Signing certificates verified with `apksigner` and `codesign`.
- [ ] Native flavors aligned between Android `build.gradle` and iOS Xcode schemes.

## References
- [Flavors, Config, and the AppConfig Pattern](references/flavors-and-config.md)
Files in this package (2)
  • SKILL.md 6 KB
  • references/flavors-and-config.md 3 KB

Versions

The database has no other skills named flutter-release-engineering.

Identical content appears in 2 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 9f3635a55c12 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100flutter-config
    Use when configuring build flavors, passing environment variables via dart-define-from-file, or setting up stage-specific credentials.
  • 90flutter-build-release
    Configure and verify Flutter flavors, environments, signing, versioning, release artifacts, obfuscation symbols, and store-ready builds. Use for local artifact configuration; route CI provider workflows to flutter-ci-cd, and do not publish or change live credentials without explicit authorization.
  • 100dart-n-flutter
    Instructions for writing Dart and Flutter code following the official recommendations. Triggers on: **/*.dart
  • 100flutter-ci
    CI/CD for Flutter and Dart — GitHub Actions workflows with subosito/flutter-action (pinned Flutter version, caching), quality gates (format, analyze, test, coverage), build_runner in CI, building Android APK/AAB and iOS IPA, code signing (Android keystore via secrets, iOS…
  • 90flutter-platform-integration
    Flutter native/platform integration guidance for FE Dev. Use when a task touches platform channels, plugins, permissions, flavors, dart-define config, deep links, push notifications, secure storage, app lifecycle, native iOS/Android files, or platform-specific behavior.
  • 100flutter-test-strategy
    Use when deciding what to test in a Flutter/Dart codebase and at which layer — unit vs widget vs golden vs integration — and when setting coverage gates. Complements the official how-to skills (flutter-add-widget-test, flutter-add-integration-test, flutter-add-widget-preview,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.