desktop-update-policy.md

Desktop Update Policy

Use this when macOS desktop users need an extra update prompt beyond Sparkle.

Firestore Config

Create or update desktop_update_policy/current:

{
  "active": true,
  "severity": "required",
  "maximum_build_number": 11507,
  "latest_build_number": 11590,
  "title": "Update required",
  "message": "Your Omi desktop app has an older updater issue. Please install the latest version manually.",
  "cta_text": "Download latest",
  "download_url": "https://storage.googleapis.com/omi_macos_updates/stable/index.html",
  "can_dismiss": false,
  "platforms": ["macos"]
}

Fields

• active: true enables the policy.
• severity: banner shows a dismissible top banner; required shows a blocking prompt; none disables it.
• maximum_build_number: highest client build that should see the policy. Clients above this build do not see it.
• latest_build_number: informational for clients and analytics.
• title, message, cta_text: user-facing copy.
• download_url: manual installer URL. For legacy recovery, use the static stable repair page published by the stable-promotion workflow instead of the dynamic appcast/download API.
• can_dismiss: only applies to banner; required prompts cannot be dismissed.
• platforms: optional allowlist. Omit or use ["macos"] for macOS.

Verification

curl 'https://api.omi.me/v2/desktop/update-policy?platform=macos&current_build=11400'
curl 'https://api.omi.me/v2/desktop/appcast.xml?platform=macos' | grep criticalUpdate
curl -fsS 'https://storage.googleapis.com/omi_macos_updates/stable/latest.json' | python3 -m json.tool

Disable the policy by setting active to false.