pediatric-ai-scribe-v3/mobile

PedScribe Mobile App

Capacitor mobile wrapper for the hosted Ped-AI web app. The app defaults to https://app.pedshub.com, lets users choose a self-hosted server URL, and keeps clinical workflows API-backed through the same Express service as the browser app.

Features

• Hosted web workflow inside a native WebView; server updates reach mobile clients without app-store releases
• Configurable server URL (supports self-hosted instances)
• Haptic feedback on recording start/stop
• Keep screen awake during recording
• Deep linking (pedscribe:// and https://app.pedshub.com)
• Share intent (receive text/PDFs from other apps)
• Push notification support
• Biometric sign-in (Face ID / Touch ID / fingerprint) — credentials stored in iOS Keychain / Android Keystore, gated by OS biometric. Enrolled on first password sign-in (opt-in prompt). 2FA still applies on top — biometric replaces the password step only.
• Android and iOS project scaffolds for store builds

Prerequisites

• Node.js 18+
• Android Studio (for Android builds): sudo snap install android-studio --classic
• Xcode 15+ (for iOS builds, macOS only)
• Apple Developer account ($99/yr for App Store)
• Google Play Developer account ($25 one-time)

Setup

cd mobile
npm install
npx cap sync

Build Android

# Open in Android Studio
npx cap open android

# Build menu: Build > Generate Signed Bundle / APK > APK
# Sign with your keystore (create one on first build)
# APK output: android/app/build/outputs/apk/release/

# Or build from command line:
cd android && ./gradlew assembleRelease

Build iOS (macOS only)

# Open in Xcode
npx cap open ios

# In Xcode:
# 1. Select your team/signing certificate
# 2. Product > Archive
# 3. Distribute App > App Store Connect

How It Works

1. App launches with a local launcher page
2. First launch: user enters their PedScribe server URL (default: app.pedshub.com)
3. URL is saved locally for future launches
4. App navigates to the remote web app inside a native WebView
5. Native plugins provide background recording, haptics, and push notifications

Background Recording

Android: AudioRecordingService is a foreground service that:

• Acquires a partial wake lock (CPU stays active, screen can sleep)
• Shows a persistent notification ("Recording in progress...")
• Includes a "Stop Recording" quick action in the notification
• Maximum 1-hour wake lock duration

iOS: Uses UIBackgroundModes: audio in Info.plist, which tells iOS to keep the app alive for audio capture when backgrounded or screen-locked.

Deep Linking

• pedscribe:// custom URL scheme opens the app directly
• https://app.pedshub.com links open in the app instead of the browser (Android App Links)

Share Intent (Android)

Other apps can share text or PDFs directly into PedScribe:

• Share a lab result from your email into the Chart Review tab
• Share a referral note into the Hospital Course tab

Capacitor Plugins Included

Plugin	Purpose
@capacitor/app	App lifecycle management
@capacitor/haptics	Vibration feedback on recording start/stop
@capacitor/keyboard	Keyboard management for WebView
@capacitor/push-notifications	Push notification support
@capacitor/screen-orientation	Screen orientation control
@capacitor/share	Native share dialog
@capacitor/splash-screen	Launch splash screen
@capacitor/status-bar	Status bar styling

App Structure

mobile/
  capacitor.config.json    # Capacitor configuration
  package.json             # Dependencies
  src/
    index.html             # Launcher page (server URL config)
    launcher.js            # Auto-redirect + native feature init
    launcher.css            # Launcher styles
  android/                 # Android native project
    app/src/main/
      java/com/pedshub/scribe/
        MainActivity.java
        AudioRecordingService.java
      AndroidManifest.xml  # Permissions, deep links, share intent
  ios/                     # iOS native project
    App/App/
      Info.plist           # Background audio, microphone, deep links

Updating the Web App

The mobile app wraps the remote web app — updating the server automatically updates all mobile clients. No app store update needed for web changes.

To update native features (plugins, permissions, splash screen):

cd mobile
npm install
npx cap sync
# Then rebuild in Android Studio / Xcode

Generating App Icons

Replace the default Capacitor icons with PedScribe branding:

1. Create a 1024x1024 PNG icon
2. Install the assets tool: npm install -D @capacitor/assets
3. Place your icon as assets/icon-only.png and assets/splash.png
4. Run: npx capacitor-assets generate

This generates all required sizes for both platforms.

App Store Listing Suggestions

Title: PedScribe - Pediatric AI Scribe Subtitle: Voice-to-Note Clinical Documentation Category: Medical Keywords: pediatric, scribe, medical, documentation, HPI, SOAP, clinical, AI, voice

Description: PedScribe is an AI-powered clinical documentation tool for pediatric physicians. Record patient encounters, and the AI generates structured medical notes — HPIs, SOAP notes, hospital courses, chart reviews, and more. Includes pediatric calculators, developmental milestone tracking, and a learning hub with quizzes. Self-hosted for maximum privacy with HIPAA-compliant AI providers.