B1 Mobile

B1 Mobile is the primary member-facing mobile app for ChurchApps, built with React Native and Expo.

Prerequisites

info

Requires Expo CLI and either Android Studio (for Android emulator) or Xcode (for iOS simulator).

• Node.js (see root setup guide for version)
• Expo CLI (npm install -g expo-cli)
• Android Studio — for Android emulator and builds
• Xcode — for iOS simulator and builds (macOS only)

Setup

1. Clone the repository:

   git clone https://github.com/ChurchApps/B1Mobile.git

2. Install dependencies:

   cd B1Mobile && npm install

3. Configure environment variables — copy the sample file and update the API endpoints:

   cp dotenv.sample.txt .env

4. Start the Expo dev server:

   npm start

Environment Variables

Variable	Description
STAGE	Environment stage (e.g., dev, staging, prod)
CONTENT_ROOT	Root URL for content delivery
MEMBERSHIP_API	Membership API endpoint
MESSAGING_API	Messaging API endpoint
ATTENDANCE_API	Attendance API endpoint
GIVING_API	Giving API endpoint
DOING_API	Doing API endpoint
CONTENT_API	Content API endpoint
LESSONS_ROOT	Root URL for lessons content

Key Commands

Command	Description
npm start	Launch Expo dev server
npm run android	Run on Android emulator
npm run ios	Run on iOS simulator
npm run test	Run tests (Jest)

Production Builds

Before creating a production build, update version numbers in all of the following files:

• package.json
• app.config.js
• android/app/build.gradle
• ios/B1Mobile/Info.plist

Android

npm run build:android

This uses EAS Build to create the Android binary.

iOS

eas build --platform ios --profile production

OTA Updates

To push an over-the-air update (without going through app store review):

npm run update:production

tip

OTA updates are ideal for JavaScript-only changes. If you modify native code or dependencies, you must submit a full store build instead.