chore: remove overall release plan document and add mobile app release process documentation
This commit is contained in:
64
docs/MOBILE/05-release-process.md
Normal file
64
docs/MOBILE/05-release-process.md
Normal file
@@ -0,0 +1,64 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user