Mobile Apps

Mobile Apps (iOS & Android)

Bindarr offers native mobile applications for iOS and Android, wrapping the full web application in Capacitor.

---

Features on Mobile

• Instant Hardware Camera Scanning: High-framerate camera feed with real-time card corner tracking.
• Native Network Routing: Uses CapacitorHttp to route API requests directly through native device networking, sidestepping WebView CORS restrictions.
• Touch-Optimized Binder Arrangement: Tap-to-file arrange mode specifically designed for small screens and swipe gestures.
• Offline Server URL Persistence: Remembers your self-hosted instance address securely.

---

Installing the Mobile Apps

Android Installation

1. Go to the Latest GitHub Releases on your Android device.
2. Download Bindarr-Android.apk.
3. Open the APK file and tap Install (enable "Install unknown apps" for your browser if prompted).
4. Launch Bindarr from your app drawer.

(For automated updates, Android builds are also published to the Google Play Internal Track).

---

iOS Installation

Due to Apple App Store restrictions on self-hosted servers, iOS builds are distributed via Apple TestFlight:

1. Install the free Apple TestFlight App from the App Store.
2. Accept the Bindarr TestFlight invitation link from the repository releases page.
3. Tap Install within TestFlight.

---

Connecting to Your Server

When you open the native mobile app for the first time:

1. You will be prompted with the Server Connection screen.
2. Enter your instance URL:
   • Public Domain: https://cards.yourdomain.com
   • Local LAN: https://192.168.1.50:3443
3. Tap Connect.
4. Log in with your standard Bindarr user account.

Changing the Server URL: You can change your server URL at any time by tapping Change Server at the bottom of the login screen or under Settings.

---

Building the Mobile Apps Locally

If you wish to compile the native apps yourself using Android Studio or Xcode:

Prerequisites

• Node.js 18+ and npm
• Android Studio (for Android) or macOS with Xcode 15+ (for iOS)

Build Steps

# 1. Navigate to the frontend directory
cd frontend

# 2. Install dependencies
npm ci

# 3. Compile the React web application
npm run build

# 4. Sync web assets to native Android and iOS folders
npx cap sync

# 5. Open in Native IDEs:
npx cap open android    # Launches Android Studio
npx cap open ios        # Launches Xcode (macOS only)