Hermes 284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Integration Tests / Check for relevant changes (push) Waiting to run
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Mobile checks / Mobile unit tests (push) Waiting to run
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Temporal Readiness / fast-readiness (push) Waiting to run
Temporal Readiness / docker-parity (push) Waiting to run
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Unit Tests / Skipped-test budget (push) Waiting to run
Unit Tests / Nx affected unit tests (push) Waiting to run
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
Initial import of AlgaPSA codebase from PSA server
Excluded: .git, node_modules, secrets/, compose.env, assemblyscript tgz

Source: /opt/alga-psa on psa.joliet.tech
2026-06-22 16:12:17 -05:00

1.8 KiB

Mobile Release Process (Signing, Versioning, Release Notes)

Scope: Ticketing MVP + SSO (ee/mobile/ Expo app) for hosted Alga PSA environments.

Last updated: 2026-02-03

Signing

iOS (TestFlight / App Store)

  • Builds are produced via EAS (ee/mobile/eas.json).
  • Signing credentials are managed by EAS using App Store Connect (recommended).
  • App must exist in App Store Connect and use the same bundle id as ee/mobile/app.json (expo.ios.bundleIdentifier).

Android (Play Internal / Play Store)

  • Builds are produced via EAS (ee/mobile/eas.json).
  • Keystore is managed by EAS (recommended).
  • App must exist in Google Play Console and use the same package name as ee/mobile/app.json (expo.android.package).

Versioning

Human version

  • Update ee/mobile/app.json:
    • expo.version (e.g. 1.0.01.0.1)

Build numbers

  • iOS: increment expo.ios.buildNumber (string, monotonically increasing).
  • Android: increment expo.android.versionCode (number, monotonically increasing).

Recommendation: bump both build numbers on every CI distribution run, even when expo.version stays the same.

Release Notes

  • Keep release notes in this plan folder so they are reviewable alongside scope.
  • Create one file per release:
    • docs/plans/2026-02-03-alga-psa-mobile-app/release-notes/YYYY-MM-DD.md
  • Minimum structure:
    • Highlights
    • Fixes
    • Known issues
    • Config changes / migrations (if any)

CI / Automation

  • GitHub Actions workflow: .github/workflows/mobile-distribute.yml
  • Required secrets:
    • EXPO_TOKEN
  • Before first run:
    • Create the Expo project and run eas build:configure locally once to bootstrap config/credentials.
    • Replace placeholders in ee/mobile/eas.json submit profiles (e.g. ascAppId) and/or configure EAS submit credentials.