Sign in

The mobile app uses Hilal Auth for single sign-on — the same account you use on Hilal Software or Hilal Chatbot. There’s no separate mobile-only password.

In this guide:

• Tap Login with Hilal
• Approve the browser-based sign-in
• Return to the app
• Pick an organization (if you belong to multiple)

Prerequisites

• The app is installed.
• You have a Hilal account (any product).
• Your device has an internet connection.

Step 1: Tap Login with Hilal

On the Welcome screen, tap Login with Hilal.

If you’re offline, the button is disabled and you see a banner — sign-in requires the internet to reach Hilal Auth.

Step 2: Approve sign-in in the browser

Hilal Auth opens in your system browser (Safari on iOS, Chrome on Android). Sign in with email + password or your social provider (Google, etc.).

If you’re already signed in to Hilal Auth in that browser (e.g., on the web), sign-in is silent — Hilal Auth recognizes you and immediately redirects.

Step 3: Return to the app

Hilal Auth redirects to the app via a deep link (myapp://auth/auth-callback?...). The browser closes itself; the app receives the authorization code and completes the OAuth exchange in the background.

Within a couple of seconds, you land on the dashboard.

Step 4: Pick an organization (if applicable)

If you belong to multiple Hilal organizations, the app picks the most recently active one by default. Switch any time from the drawer header.

How sessions work

• The app stores your access token encrypted in iOS Keychain / Android Keystore (via expo-secure-store).
• Sessions expire automatically (token expiry is set by Hilal Auth, typically several hours).
• The app re-authorizes silently in the background when the token expires — you generally don’t see another sign-in prompt unless your session has been inactive for a long time.
• If you sign out elsewhere (web, another device), the next API call from mobile fails and you’re routed back to sign-in.

Troubleshooting

• Browser opens but doesn’t redirect back. The redirect deep link may be blocked by your browser. Open Safari/Chrome settings, check that pop-ups and deep links are allowed for auth.hilalsoftware.tools.
• “Authorization failed” toast. Try again. If persistent, verify your Hilal account works on the web app.
• Stuck on the loading spinner after browser closes. Force-quit and reopen. If still stuck, sign in once on the web (refreshes your session), then retry mobile.
• “You don’t have access to this organization.” Your role doesn’t permit mobile access for that org, or the org has no active subscription. Contact the org’s Owner.

What’s next

Allow notifications so the app can ping you about the things you care about.