Krow-workspace/docs/MOBILE/05-release-process.md

Mobile Release Process

For complete release documentation, see: docs/RELEASE/mobile-releases.md

---

Quick Links

Release Workflows

• Product Release: Trigger at: GitHub Actions
• Hotfix Creation: Trigger at: GitHub Actions

Key Concepts

Versioning: We use semantic versioning with milestone suffixes (e.g., 0.0.1-m4)

• Defined in: apps/mobile/apps/staff/pubspec.yaml or apps/mobile/apps/client/pubspec.yaml
• Auto-extracted by workflows (no manual input required)

CHANGELOGs:

• Staff: apps/mobile/apps/staff/CHANGELOG.md
• Client: apps/mobile/apps/client/CHANGELOG.md
• Format: ## [v0.0.1-m4] - Milestone 4 - 2026-03-05

Git Tags: krow-withus-<app>-mobile/<env>-vX.Y.Z

• Example: krow-withus-worker-mobile/dev-v0.0.1-m4

---

Quick Start

Standard Release

1. Update CHANGELOG with user-facing changes
2. Update version in pubspec.yaml
3. Commit and push to dev branch
4. Trigger workflow:
   • Go to GitHub Actions → "📦 Product Release"
   • Select app (worker/client) and environment (dev/stage/prod)
   • Click "Run workflow"

Hotfix Release

1. Trigger workflow:
   • Go to GitHub Actions → "🚨 Product Hotfix - Create Branch"
   • Enter current production version and issue description
   • Workflow creates branch and updates version/CHANGELOG
2. Fix bug on hotfix branch
3. Merge to main and release to production

---

For Complete Details

See the comprehensive documentation: docs/RELEASE/mobile-releases.md

This includes:

• ✅ Detailed versioning strategy
• ✅ CHANGELOG format guidelines
• ✅ Step-by-step release procedures
• ✅ APK signing setup (24 GitHub Secrets)
• ✅ Helper scripts reference
• ✅ Hotfix process
• ✅ Troubleshooting guide
• ✅ Release cadence (dev/stage/prod)