Overview#

AI Workforce OS does not ship a native iOS or Android app. Instead, the web application is a fully responsive site with an installable Progressive Web App (PWA) mode: an app-like icon, offline access to certain data, and (when configured) push notifications.

Purpose#

Show employees how to install the PWA and use it offline, and show administrators what "mobile" support actually means in this release.

Prerequisites#

  • A supported mobile browser: recent Chrome, Firefox, Edge, or Safari 16.4+ on iOS.
  • For push notifications: your System Administrator must have configured Web Push (VAPID) or Firebase Cloud Messaging credentials.

Step-by-Step Instructions#

Installing the PWA#

  1. Open the AI Workforce OS URL in a supported mobile browser.
  2. Use your browser’s "Add to Home Screen" or "Install App" option.
  3. Launch the app from the installed icon — it opens in an app-like window without browser chrome.

Working offline#

  1. Once installed, previously loaded data remains available if you lose connectivity.
  2. Actions you take offline (where supported) are queued locally and sent once you are back online.
  3. If offline entirely with no cached data for a screen, you will see an offline page instead of an error.

Push notifications#

  1. Enable notifications from Push Notification Settings in the app when prompted, or from your notification preferences.
  2. Notifications are delivered via Web Push or Firebase Cloud Messaging, depending on your organization’s configuration.
Requires setup by your administrator

Push delivery code is implemented, but is silently skipped unless your System Administrator has configured Web Push (VAPID) or FCM credentials for your deployment. If notifications never arrive, this is the first thing to check with IT — it may simply be unconfigured rather than broken.

Passkeys and device management#

  1. Set up a passkey (WebAuthn/biometric sign-in) from Biometric Settings for faster, more secure sign-in on a trusted device.
  2. Use the QR Scanner where offered as part of a passkey/authentication flow.
  3. Review and manage your registered devices under Device Management.
  4. Use the camera-upload feature to attach a photo directly from your device camera where document/photo upload is supported.

Screens Involved#

📷
[Screenshot: Install prompt / Add to Home Screen]
📷
[Screenshot: Offline page]
📷
[Screenshot: Push Notification Settings]
📷
[Screenshot: Biometric Settings (passkeys)]
📷
[Screenshot: Device Management]
📷
[Screenshot: Camera upload]

Expected Results#

An installed, app-like experience that keeps working (in a limited way) without a network connection, and — once configured — delivers push notifications and supports passkey sign-in.

Not Available in This Release#

🚫
Not currently available
  • No native iOS or Android app in an app store — "mobile" is the responsive web app plus PWA install, not a separate native codebase.
  • No Apple Push Notification service (APNs) support for native iOS push — not applicable without a native app, and explicitly not implemented.
  • Push notifications will not arrive if your administrator has not configured Web Push/FCM credentials — this is a setup requirement, not automatic.

Common Mistakes#

  • Searching an app store for "AI Workforce OS" — there is nothing to find there; install via your browser instead.
  • Reporting push notifications as broken before confirming with IT whether VAPID/FCM credentials have been configured for your deployment.
  • Assuming every screen and action works fully offline — offline support applies to previously loaded data and specific queued actions, not the entire application.

Troubleshooting#

I don’t see an install/"Add to Home Screen" option.#

Confirm you are using a supported browser and version (recent Chrome/Firefox/Edge, or Safari 16.4+ on iOS). Some browsers only show the install prompt after a page has been visited a few times.

Push notifications never arrive.#

First confirm with your System Administrator that Web Push (VAPID) or FCM credentials are configured for your deployment — delivery is silently skipped without them. If configured, check that notifications are enabled in your own browser/device settings.

FAQ#

Is there an app in the App Store or Google Play?

No. AI Workforce OS is a Progressive Web App — install it directly from your mobile browser rather than an app store.

Why aren’t my push notifications working?

Most commonly because your organization has not yet configured Web Push/FCM credentials. Ask your System Administrator to confirm before assuming a bug.

Can I sign in with Face ID / fingerprint?

Yes, if you set up a passkey under Biometric Settings, using your device’s native biometric unlock through WebAuthn.

Best Practices#

  • Install the PWA on your primary device for the fastest access and offline resilience.
  • Set up a passkey once, on a device you control, rather than typing a password on every sign-in.