# Mobile APK Build Guide

Use this after the cPanel web app is uploaded, migrated, built, and reachable over HTTPS.

## 1. Set the API URL

The APK profile is configured for the production cPanel domain:

```bash
EXPO_PUBLIC_API_URL="https://conference.pjl-apps.online" pnpm --filter @pmap/mobile build:android:apk
```

The URL must be the site root, not `/api`. Example:

```env
EXPO_PUBLIC_API_URL="https://conference.pjl-apps.online"
```

## 2. Install EAS CLI

```bash
npm install -g eas-cli
eas login
```

## 3. Build a Test APK

From the repository root:

```bash
pnpm --filter @pmap/mobile build:android:apk
```

EAS will return a download URL for the APK. Download it and install it on Android for testing.

## 4. Local APK Option

Local Android builds require Android Studio, Android SDK, and EAS CLI:

```bash
pnpm --filter @pmap/mobile build:android:apk:local
```

## Notes

- The preview APK profile is for internal testing.
- The mobile app currently connects to `/api/v1/auth/login` for participant login checks.
- Full mobile token auth and QR pass sync should be implemented before public release.