Skip to content

CI/CD and releases ​

Choose --ci github (the default) to get GitHub Actions workflows, Fastlane and a setup guide. Choose --ci none to skip all of it. You still get scripts/quality_gate.sh.

Workflows ​

WorkflowRuns onDoes
pr_checks.ymlPull requests to develop, staging, mainQuality gate + coverage floor
android.ymlPushes to develop, staging, mainBuilds and signs an App Bundle, uploads symbols, then Firebase App Distribution or the Play internal track
ios.ymlPushes to develop, staging, mainBuilds and signs with Fastlane, uploads symbols, ships to TestFlight / App Store

Branch to flavor ​

BranchFlavorAndroid goes toiOS goes to
developdevelopmentFirebase App DistributionTestFlight
stagingstagingFirebase App DistributionTestFlight
mainproductionPlay Store (internal track)App Store Connect

What works right away ​

pr_checks works as soon as you push. The build-and-deploy workflows fail until you add signing keys and secrets. That is expected: nobody can ship an app without them.

Secrets you need to add ​

The full list, with how to create each one, is in your app's docs/deployment-setup.md. In short:

SecretFor
ANDROID_KEYSTORE_BASE64, ANDROID_KEYSTORE_ALIAS, ANDROID_KEYSTORE_PASSWORD, ANDROID_KEYSTORE_PRIVATE_KEY_PASSWORDAndroid signing
PLAY_STORE_SERVICE_ACCOUNT_JSONPlay Console upload
FIREBASE_APP_ID_ANDROID, FIREBASE_SERVICE_ACCOUNTFirebase App Distribution
APP_STORE_CONNECT_API_KEY_ID, APP_STORE_CONNECT_API_ISSUER_ID, APP_STORE_CONNECT_API_KEY_CONTENTFastlane and App Store Connect
IOS_CERTIFICATE_BASE64, IOS_CERTIFICATE_PASSWORD, IOS_PROVISIONING_PROFILE_BASE64, KEYCHAIN_PASSWORDiOS signing
API_BASE_URLOptional base-URL override (use GitHub environments for one per flavor)

Crash reporting adds its own rows (for example SENTRY_DSN).

Released under the MIT License.