65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
# Mobile Release Process
|
|
|
|
**For complete release documentation, see: [docs/RELEASE/mobile-releases.md](../RELEASE/mobile-releases.md)**
|
|
|
|
---
|
|
|
|
## Quick Links
|
|
|
|
### Release Workflows
|
|
- **Product Release**: Trigger at: [GitHub Actions](https://github.com/Oloodi/krow-workforce/actions/workflows/product-release.yml)
|
|
- **Hotfix Creation**: Trigger at: [GitHub Actions](https://github.com/Oloodi/krow-workforce/actions/workflows/hotfix-branch-creation.yml)
|
|
|
|
### 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](../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)
|